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