『與善仁』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()