简介
与 Web 元素操作一样(参考 Selenium Web 元素操作),定位到 APP 控件元素后,可以对控件进行一系列的操作,实现与 APP 交互,比如点击、文本输入、元素属性获取等。
控件交互常用方法
常见操作
- 点击方法 element.click()。
- 输入操作 element.send_keys('appium')。
- 清除操作 element.clear()。
状态判断
- 是否可见 element.is_displayed() 返回 True/False。
- 是否可用 element.is_enabled() 返回 True/False。
- 是否被选中 element.is_selected() 返回 True/False。
获取元素属性
- 获取元素属性:
-
- element.get_attribute()
- resource-id/resourceld 返回 resource-id(API=>18 支持)。
- text 返回 text。
- class 返回 class(API=>18 支持)。
- content-desc/contentDescription 返回 content-desc 属性。
- checkable,checked,clickable,enabled,focusable,focused 等。
- 获取元素文本:
-
- 格式:element.text。
- 获取元素坐标:
-
- 格式:element.location。
- 结果:{'y': 19,'x: 498}。
- 获取元素尺寸(高和宽):
-
- 格式:element.size。
- 结果:{'width':500,'height':22)。
控件操作交互示例
- 打开 ApiDemos.apk。
- 点击 Animation 进入下个页面。
- 点击 Seeking 进入下个页面。
- 查看【RUN】按钮是否显示/是否可点击。
- 查看【滑动条】是否显示/是否可点击。
- 获取【滑动条】长度。
- 点击【滑动条】中心位置。
class TestEleOper:
def setup_class(self):
'''
完成 capability 设置
初始化 driver
:return:
'''
# 设置 cpability
caps = {
# 设置 app 安装的平台(Android,iOS)
"platformName": "Android",
# 设置 appium 驱动
"appium:automationName": "uiautomator2",
# 设置设备名称
"appium:deviceName": "emulator-5554",
# 设置被测 app 的包名
"appium:appPackage": "io.appium.android.apis",
# 设置被测 app 启动页面的 Activity
"appium:appActivity": ".ApiDemos",
# 不清空缓存信息
"appium:noReset": True,
# 首次启动的时候,不停止app
"appium:dontStopAppOnReset": True,
# 跳过安装,权限设置等操作
"appium:skipDeviceInitialization": True
}
# 初始化 driver
self.driver = webdriver.Remote(
"http://127.0.0.1:4723",
options=UiAutomator2Options().load_capabilities(caps)
)
# 添加隐式等待
self.driver.implicitly_wait(10)
def test_ele_oper(self):
'''
点击滑动条中心位置
:return:
'''
# 点击 Animation
self.driver.find_element(AppiumBy.ACCESSIBILITY_ID, "Animation").click()
# 点击 Seeking
self.driver.find_element(AppiumBy.ACCESSIBILITY_ID, "Seeking").click()
# 查看【RUN】按钮是否显示/是否可点击
run_btn_ele = self.driver.find_element(AppiumBy.ID, "io.appium.android.apis:id/startButton")
print(f"RUN按钮是否显示 {run_btn_ele.is_displayed()}")
print(f"RUN按钮是否可点击 {run_btn_ele.is_enabled()}")
# 查看【滑动条】是否显示/是否可点击
seek_bar_ele = self.driver.find_element(AppiumBy.ID, "io.appium.android.apis:id/seekBar")
print(f"滑动条是否显示 {seek_bar_ele.is_displayed()}")
print(f"滑动条是否可点击 {seek_bar_ele.is_enabled()}")
# 获取【滑动条】长度
seek_bar_ele_width = seek_bar_ele.size.get('width')
print(f"滑动条长度为 {seek_bar_ele_width}")
# 获取【滑动条】起始位置坐标
seek_bar_ele_start = seek_bar_ele.location
print(f"滑动条起始位置坐标为 {seek_bar_ele_start}")
# 获取【滑动条】中间位置坐标
seek_bar_center_x = seek_bar_ele_start.get("x") + seek_bar_ele_width/2
seek_bar_center_y = seek_bar_ele_start.get("y")
seek_bar_center = (seek_bar_center_x, seek_bar_center_y)
print(f"滑动条中间位置坐标为 {seek_bar_center}")
# 点击【滑动条】中间位置
self.driver.tap([seek_bar_center], 1000)
总结
常见控件的基本交互方式,可以模拟用户与应用程序的交互。在编写测试脚本时,通常需要结合元素的定位方式(如 ID、XPath 等)来找到相应的控件元素。确保测试脚本中的等待和定位策略,以及对元素状态的验证,可以提高测试的稳定性和可靠性。