『与善仁』Appium基础 — 28.元素定位（二）

4、by_xpath定位

通过xpath定位元素，这样就可以在页面中定位一个单个的元素了。

（如果一个元素的id属性或者class_name属性也是唯一的，我们也可以通过d属性或者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")

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()

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工具类介绍：

• text属性的方法（text指的是text属性）

  1-driver.find_element_by_android_uiautomator('new UiSelector().text("AndroidUI")')

  完全匹配。

  2-driver.find_element_by_android_uiautomator('new UiSelector().textContains("Android")')

  包含匹配（模糊定位）。

  3-driver.find_element_by_android_uiautomator('new UiSelector().textStartsWith("AndroidUI")')

  以什么内容开始匹配。

  4-driver.find_element_by_android_uiautomator('new UiSelector().textMatches("^Android.*")')

  正则匹配查找。

• className属性的方法（className指的是class属性）

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

  2-driver.find_element_by_android_uiautomator('new UiSelector().classNameMatches(".*TextView$").text("AndroidUI")')

  正则匹配查找。

• xpath方法定位

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

• resourceId属性的方法

  （resourceId指的是resource-id属性）

  1-driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.android.calculator2:id/op_add")')

  2-driver.find_element_by_android_uiautomator('new UiSelector().resourceIdMatches(".*id/op_add$")')

• description属性的方法

  （description指的是content-desc属性）

  1- driver.find_element_by_android_uiautomator('new UiSelector().description("加")')

  2- driver.find_element_by_android_uiautomator('new UiSelector().descriptionStartsWith("加")')

  3- 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()