『與善仁』Appium基礎 — 20、Appium元素定位

目錄

• 1、by_id定位
• 2、by_name定位
• 3、by_class_name定位
• 4、by_xpath定位
• 5、by_accessibility_id定位
• 6、by_android_uiautomator定位

本文說明的是在APP的原生頁碼中進行元素定位。

如果頁面是Web（移動端里的瀏覽器）、混合（APP與WEBVIEW）里含有WEBVIEW頁面進行元素定位，元素定位方法同Selenium WebDriver一致，則可以參考Selenium部分的筆記進行參考。

元素定位工具：

• Android使用Android SDK里的uiautomatorviewer工具。
• IOS使用Appium Desktop里的Appium Inspector檢查器。

1、by_id定位

通過id屬性定位元素，IOS應用上的元素沒有這個屬性，所以僅支持Android。

代碼如下：

# 單數
driver.find_element_by_id("id屬性值")

# 復數
driver.find_elements_by_id("id屬性值")

如下圖所示：利用uiautomatorviewer工具查看元素信息，resource-id屬性就是元素的id屬性。

練習：

開啟Appium服務，執行如下代碼：

"""
1.學習目標
    必須掌握appium中元素定位基本方法(這些方法我們在Selenium中學習過)

    練習目標：掌握元素定位方式 id定位
2.操作步驟
    id定位
        只適用於Android,IOS不支持,id並不是唯一屬性標識
        driver.find_element_by_id("id屬性值")  # 單數
        driver.find_elements_by_id("id屬性值")  # 復數
        id屬性  resource-id表示
3.需求
    在設置APP中使用id屬性定位“顯示”
"""

# 1.導入appium
import time
from appium import webdriver

# 2.創建Desired capabilities對象，添加啟動參數
desired_caps = {
    "platformName": "Android",  # 系統名稱
    "platformVersion": "7.1.2",  # 系統版本
    "deviceName": "127.0.0.1:21503",  # 設備名稱
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP啟動名
}

# 3.啟動APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.定位元素
# 在移動端，元素的id不再是唯一的，
# 我們可以在uiautomatorviewer工具查看到，一個頁面中類似元素的id都是相同的。
# 這個時候我們就要用driver.find_elements_by_id來定位元素
# 對應的字段resource-id屬性值。
# 4.1 定位設置app界面中的所有標題
id_elements = driver.find_elements_by_id("android:id/title")

# 4.2 查看一共獲取了多少標題title
print("元素數量：" + str(len(id_elements)))

# 4.3 遍歷獲取標題對應的文本
for element in id_elements:
    print(element.text)   # 遍歷打印所有元素的text值


# 5.關閉APP
time.sleep(3)
driver.quit()

輸出結果如下：

元素數量：12
建議
設置屏幕鎖定
無線和網絡
WLAN
藍牙
更多
設備
顯示
通知
聲音
應用
存儲	

2、by_name定位

Appium版本在1.5之后，Android就不再支持name的元素定位方法。

Android如果使用name方法，則報如下錯誤：

selenium.common.exceptions.InvalidSelectorException:

Message: Locator Strategy 'name' is not supported for this session

IOS可以正常使用name元素定位。

代碼如下：

# 單數
driver.find_element_by_name("name")

# 復數
driver.find_elements_by_name("name")

如圖所示：利用Appium Inspector檢查器，name屬性指的是name屬性。

使用命令：driver.find_element_by_name("3個月")

這里我們就不做演示了。

3、by_class_name定位

通過class_name屬性定位元素。

代碼如下：

# 單數
driver.find_element_by_class_name("class值")

# 復數
driver.find_elements_by_class_name("class值")

1）Android：

如圖所示：利用uiautomatorviewer工具查看，class_name屬性指的是class屬性。

2）IOS：

如圖所示：利用Appium Inspector檢查器，class_name屬性指的是type屬性。

使用命令：driver.find_element_by_class_name("XCUIElementTypeStaticText")

練習：

"""
1.學習目標
    必須掌握appium中元素定位基本方法(這些方法我們在Selenium中學習過)

    練習目標：掌握元素定位方式 class_name定位
2.操作步驟
   class_name定位
        Android和IOS都適用
            Android 是 class屬性
            IOS 是 type屬性
        driver.find_element_by_class_name("class屬性值")  # 單數
        driver.find_elements_by_class_name("class屬性值")  # 復數
3.需求
    在設置APP中使用class_name定位“顯示”標題
"""

# 1.導入appium
import time
from appium import webdriver

# 2.創建Desired capabilities對象，添加啟動參數
desired_caps = {
    "platformName": "Android",  # 系統名稱
    "platformVersion": "7.1.2",  # 系統版本
    "deviceName": "127.0.0.1:21503",  # 設備名稱
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP啟動名
}

# 3.啟動APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.定位元素
# 在移動端，一個頁面中的很多元素的class_name屬性值是相同的，
# 我們可以通過uiautomatorviewer工具查看到，例如設置app的首頁面。
# 這個時候我們就要用driver.find_elements_by_class_name來定位元素
# 對應的字段class屬性值。
# 4.1 使用class_name屬性定位設置app界面中的所有標題
class_elements = driver.find_elements_by_class_name("android.widget.TextView")


# 4.2 查看一共獲取了多少標題title
print("元素數量：" + str(len(class_elements)))

# 4.3 遍歷獲取標題對應的文本
for element in class_elements:
    print(element.text)   # 遍歷打印所有元素的text值


# 5.關閉APP
time.sleep(3)
driver.quit()

運行結果：

元素數量：23
設置

建議

設置屏幕鎖定
保護您的設備
無線和網絡
WLAN
"hghtsj2650"
藍牙
已停用
更多
設備
顯示
自動調節亮度功能已關閉
通知
已允許所有應用發送通知
聲音
鈴聲音量為 71%
應用
已安裝 14 個應用
存儲
已使用 58.44 GB（共 64.51 GB）

4、by_xpath定位

通過xpath定位元素，這樣就可以在頁面中定位一個單個的元素了。

（如果一個元素的id屬性或者class_name屬性也是唯一的，我們也可以通過id屬性或者class_name屬性進行定位。）

代碼如下：

# 單數
driver.find_element_by_xpath("xpath")

# 復數
driver.find_elements_by_xpath("xpath")

在移動端xpath用法與Web Selenium中的用法一致，在移動端自動化測試中使用xpath定位元素是比較多的。

練習：

"""
1.學習目標
    必須掌握appium中元素定位基本方法(這些方法我們在Selenium中學習過)

    練習目標：掌握元素定位方式 xpath定位
2.操作步驟
    Android和IOS都適用，使用方式和selenium沒有區別
    driver.find_element_by_xpath("xpath表達式")  # 單數
    driver.find_elements_by_xpath("xpath表達式")  # 復數
3.需求
    在設置APP中使用xpath定位“顯示”標題
"""

# 1.導入appium
import time
from appium import webdriver

# 2.創建Desired capabilities對象，添加啟動參數
desired_caps = {
    "platformName": "Android",  # 系統名稱
    "platformVersion": "7.1.2",  # 系統版本
    "deviceName": "127.0.0.1:21503",  # 設備名稱
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP啟動名
}

# 3.啟動APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.定位元素
# 4.1 xpath定位 “顯示”按鈕
more = driver.find_element_by_xpath("//*[@text='顯示']")

# 4.2 點擊“顯示”元素，進入顯示頁面。
more.click()


# 5.關閉APP
time.sleep(3)
driver.quit()

5、by_accessibility_id定位

通過accessibility_id屬性查找元素。（移動端特有）

表示附加到給定元素的輔助功能標識或標簽的字符串。

針對IOS的輔助功能標識符和針對Android的內容描述。

代碼如下：

# 單數
driver.find_element_by_accessibility_id("accessibility_id")

# 復數
driver.find_elements_by_accessibility_id("accessibility_id")

1）Android：

如圖所示：利用uiautomatorviewer工具查看，accessibility_id屬性指的是content-desc屬性。

練習：

"""
1.學習目標
    掌握appium中accessibility_id元素定位方法
2.操作步驟
    使用方法：
    driver.find_element_by_accessibility_id("content-desc屬性值")
3.需求
    在設置APP中使用accessibility_id方法定位搜索按鈕
"""

# 1.導入appium
import time
from appium import webdriver

# 2.創建Desired capabilities對象，添加啟動參數
desired_caps = {
    "platformName": "Android",  # 系統名稱
    "platformVersion": "7.1.2",  # 系統版本
    "deviceName": "127.0.0.1:21503",  # 設備名稱
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP啟動名
}

# 3.啟動APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.定位元素
# 4.1 定位搜索按鈕,通過accessibility_id方法
search = driver.find_element_by_accessibility_id("搜索設置")

# 4.2 點擊搜索按鈕
search.click()

# 5.關閉APP
time.sleep(3)
driver.quit()

2）IOS：

如圖所示：利用Appium Inspector檢查器，accessibility_id指的是accessibility id屬性或name屬性或label屬性。

使用方法：driver.find_element_by_accessibility_id("More Info")

6、by_android_uiautomator定位

通過Android UIAutomator搜索查找元素。（Android系統特有）

這允許使用UIAutomator庫，使用遞歸元素搜索來找到Android應用程序中的元素。

代碼如下：

# 單數
driver.find_element_by_android_uiautomator("android_uiautomator")

# 復數
driver.find_elements_by_android_uiautomator("android_uiautomator")

可以利用uiautomatorviewer工具查看元素屬性信息。

UiSelector工具類介紹：

1）text屬性的方法（text指的是text屬性）

（text指的是text屬性）

• 完全匹配。
  driver.find_element_by_android_uiautomator('new UiSelector().text("AndroidUI")')
• 包含匹配（模糊定位）。
  driver.find_element_by_android_uiautomator('new UiSelector().textContains("Android")')
• 以什么內容開始匹配。
  driver.find_element_by_android_uiautomator('new UiSelector().textStartsWith("AndroidUI")')
• 正則匹配查找。
  driver.find_element_by_android_uiautomator('new UiSelector().textMatches("^Android.*")')

2）className屬性的方法

（className指的是class屬性）

• 完全匹配
  driver.find_element_by_android_uiautomator('new UiSelector().className("android.widget.TextView").text("AndroidUI")')
• 正則匹配查找
  driver.find_element_by_android_uiautomator('new UiSelector().classNameMatches(".*TextView$").text("AndroidUI")')

3）xpath方法定位

driver.find_element_by_android_uiautomator('new UiSelector().className("android.widget.TextView").childSelector(new UiSelector().text("AndroidUI"))')

4）resourceId屬性的方法

（resourceId指的是resource-id屬性）

• driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.android.calculator2:id/op_add")')
• driver.find_element_by_android_uiautomator('new UiSelector().resourceIdMatches(".*id/op_add$")')

5）description屬性的方法

（description指的是content-desc屬性）

• driver.find_element_by_android_uiautomator('new UiSelector().description("加")')

• driver.find_element_by_android_uiautomator('new UiSelector().descriptionStartsWith("加")')

• driver.find_element_by_android_uiautomator('new UiSelector().descriptionMatches("^加.*")')

UiSelector類中還支持其他一些方法，比如根據控件屬性是否可點擊可聚焦可長按等來縮小要定位的控件的范圍，具體使用方法不一一列舉了。

練習：

"""
1.學習目標
    了解appium中元素定位Android專用方法  Android_UIautomator
2.操作步驟
    使用方法：
    driver.find_element_by_android_uiautomator("java代碼")
        java代碼中使用 UiSelector類來處理元素的定位
            new UiSelector().text("文本內容")
3.需求
    在設置APP中使用Android專用的定位方法

"""
# 1.導入appium
import time
from appium import webdriver

# 2.創建Desired capabilities對象，添加啟動參數
desired_caps = {
    "platformName": "Android",  # 系統名稱
    "platformVersion": "7.1.2",  # 系統版本
    "deviceName": "127.0.0.1:21503",  # 設備名稱
    "appPackage": "com.android.settings",  # APP包名
    "appActivity": ".Settings"  # APP啟動名
}

# 3.啟動APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 4.定位元素
# 4.1 定位藍牙,通過Android_UIautomator方法
# 單引號里面是Java代碼，使用`UiSelector`這個類來定位元素。
blue_tooth = driver.find_element_by_android_uiautomator('new UiSelector().text("藍牙")')
# 注意：
# 上面'new UiSelector().text("藍牙")'中，一定是外單引號，里邊雙引號
# 因為這是一段Java代碼，而text()方法中要傳入一個string類型的參數
# Java中String類型的參數是加雙引號的，所以必須是外單內雙
# 否則會報錯。

# 4.2 點擊搜索按鈕
blue_tooth.click()

# 5.關閉APP
time.sleep(3)
driver.quit()