标签：appium driver element API Android 自动化 android find
1、Desired Capabilities
appium 在启动 session 时，需要提供 Desired Capabilities。Desired Capabilities 本质上是字典对象，由客户端生成并发送给服务器（appium Desktop），告诉服务器 App 运行的环境。
from appium import webdriver
# 定义 Android 运行环境
desired_caps = {
'deviceName': 'Android Emulator',
'automationName': 'appium',
'platformName': 'Android',
'platformVersion': '7.0',
'appPackage': 'com.android.calculator2',
'appActivity': '.Calculator',
'noReset': True,
}
driver = webdriver.Remote(command_executor='http://localhost:4723/wd/hub',desired_capabilities=desired_caps)
…
1. deviceName：启动的设备、真机或模拟器，如 iPhone Simulator、Android Emulator、Galaxy S4 等。
2. automationName：使用的自动化引擎，如 appium（默认）或 Selendroid（兼容 AndroidAPI 17 以下）。
3. platformName：使用的移动平台，如 iOS 或 Android。
4. platformVersion：指定平台的系统版本，如 Android 平台，版本为 7.0。
5. appPackage：被测试 App 的 Package 名，如 com.example.android.myApp、com.android.settings 等。
6. appActivity：被测试 App 的 Activity 名，如 Calculator、MainActivity、.Settings 等。
7. noReset：在会话前重置应用状态。当设置为 True 时，会跳过安装指引；默认为false。
appium 在启动 App 时必须要设置 appPackage 和 appActivity 两个参数。
方式一：通过 adb 工具抓取日志进行分析。
（1）运行“adb logcat>D:/log.txt”命令，将 adb 抓取的日志写入 D:/log.txt 文件。
（2）在 Android 模拟器或设备中打开要测试的 App，并做一些操作。
（3）按快捷键 Ctrl+c 结束日志的捕捉。
（4）打开 D:/log.txt 文件，搜索“Displayed”关键字，查找 App 的 Package 和 Activity。
方式二：通过 aapt 查看信息。aapt 即 Android Asset Packaging Tool，在 SDK 的 build-tools 目录下。该工具既可以查看、创建、更新 zip 格式的文档附件（zip、jar、apk），也可以将资源文件编译成二进制文件。
2、控件定位
可以借助 Android SDK 自带的 UI Automator Viewer 工具对 Android 设备式模拟器中的控件进行定位。该工具位于…\tools\bin\目录下的 uiautomatorviewer.bat 文件中可以双击启动，也可以在 Windows 命令提示符下输入“uiautomatorviewer”命令启动。
1. id 定位
id 定位是使用控件的 resource-id 进行定位的。
driver.find_element_by_id()
2. Class Name 定位
Class Name 定位是使用控件的 class 属性进行定位的。
driver.find_elements_by_class_name()
3. XPath 定位
根据 WebDriver 上的 XPath 使用经验，查找层级标签名是错误的，正确的方式是获取控件的 class 属性，来代替标签名。
driver.find_element_by_xpath("//android.view.ViewGroup/android.widget.Button")
4. Accessibility id 定位
该方法属于 appium 扩展的定位方法，它采用一个字符串表示附加到给定元素的可访问id 或标签，例如，iOS 中的可访问标识符，或 Android 中的内容描述等。核心是找到控件的 contentDescription 属性。driver.find_element_by_accessibility_id("plus")
5. Android uiautomator 定位
该方法属于 appium 的扩展定位方法，并且只支持 Android 平台。一个元素的任意属性都可以通过 Android uiautomator 方法来进行定位，使用方法如下。
# text 属性
driver.find_element_by_android_uiautomator('new UiSelector().text("clr")')
# content-desc 属性
driver.find_element_by_android_uiautomator('new UiSelector().description("equals")')
# id 属性
driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.android.calculator2:id/digit_1")')
# class 属性
driver.find_element_by_android_uiautomator('new UiSelector().className("android.widget.Button")')
6. 其他定位
（1）在 appium 的 Native App 中没有使用的方法如下。driver.find_element_by_name() driver.find_element_by_tag_name() driver.find_element_by_link_text() driver.find_element_by_partial_link_text() driver.find_element_by_css_selector()（2）在 appium 中没有详细介绍的定位方法如下。 前三个定位方法是针对 iOS 平台控件的，后 4 个方法目前并不常用。
driver.find_element_by_ios_uiautomation() driver.find_element_by_ios_predicate() driver.find_element_by_ios_class_chain() driver.find_element_by_android_viewtag() find_element_by_android_data_matcher() driver.find_element_by_image() driver.find_element_by_custom()
3、appium 的常用 API
1. 应用操作
（1）安装应用install_app()安装应用到设备中，需要指定 apk 包的路径。
driver.install_app("D:\\android\\apk\\ContactManager.apk")
（2）卸载应用
remove_app()从设备中卸载某个指定的应用，需要指定 App 包名。
driver.remove_app('com.example.android.apis')
（3）关闭应用
close_app()（4）启动应用
launch_app()（5）检查应用是否已经安装
is_app_installed()检查应用是否已经安装，需要指定应用的包名。返回结果为 True 或 False。
result = driver.is_app_installed('com.example.android.apis')
print(result)
（6）将应用置于后台
将当前应用置于后台，需要指定将应用置于后台的时间，默认时间单位为秒。
background_app()（7）应用重置 类似于清除应用缓存。
reset()
2. 上下文操作
在计算机技术中，对进程而言，上下文就是进程执行时的环境，具体来说就是各个变量和数据，包括所有的寄存器变量、进程打开的文件和内存信息等。 （1）获取当前所有可用上下文driver.contexts（2）获取当前上下文。
driver.current_context（3）切换上下文。
switch_to.context()
3. 键盘操作
（1）输入字符串send_keys()（2）模拟按键。
keyevent()
4. 触摸操作
（1）单击控件
对一个控件或坐标点（x,y）执行单击操作。tap()方法中有一个 count 参数，用于设置控件的单击次数，默认为 1 次。tap(self, element=None, x=None, y=None, count=1)（2）长按控件 长按一个控件或坐标点（x,y）。long_press()方法中有一个 duration 参数，用来控制按压的时间。duration 以毫秒为单位，其用法与 tap()方法相同。
long_press(self, el=None, x=None, y=None, duration=1000)（3）移动 将光标移动到新的元素或坐标点（x,y）
move_to(self, el=None, x=None, y=None)（4）暂停 暂停脚本的执行。ms 参数表示时间，单位为毫秒。
wait(self, ms=0)appium 不仅可以执行一个动作，还可以同时执行多个动作，形成动作链，以模拟多指动作。appium 是通过构建一个 MultiAction 对象来实现执行多个动作的，该对象包含多个单独的 TouchAction 对象，每个“手指”对应一个。
from appium.webdriver.common.multi_action import MultiAction
from appium.webdriver.common.touch_action import TouchAction
…
# 执行动作链
els = driver.find_elements_by_class_name('listView')
a1 = TouchAction()
a1.press(els[0])\
.move_to(x=10, y=0)\
.move_to(x=10, y=-75)\
.move_to(x=10, y=-600)\
.release()
a2 = TouchAction()
a2.press(els[1]) \
.move_to(x=10, y=10)\
.move_to(x=10, y=-300)\
.move_to(x=10, y=-600)\
.release()
ma = MultiAction(driver, els[0])
ma.add(a1, a2)
ma.perform()
5. 特有操作
（1）熄屏
单击电源键熄灭屏幕。seconds 参数表示时间，单位为秒，默认为 None。lock(self, seconds=None)
（2）获取当前 package
获取当前 App 的包名（package），仅支持 Android。
package = driver.current_package print(package)
（3）获取当前 activity
获取当前 App 的 activity，仅支持 Android。
activity = driver.current_activity print(activity)（4）收起虚拟键盘
driver.hide_keyboard() # 收起虚拟键盘
（5）获取屏幕宽高
当需要通过坐标（x,y）对屏幕进行操作时，就需要获取屏幕的宽高。
windows = driver.get_window_size() print(windows["width"]) print(windows["height"])
（6）拉取文件
从真机或模拟器中拉取文件。path 参数指定文件的路径。
pull_file(self, path)（7）推送文件
push_file(self, path, base64data)path 参数指定 PC 中的文件路径，base64data 参数指定写入文件的内容的编码为 base64。
data = "some data for the file"
path = "/data/local/tmp/file.txt"
driver.push_file(path, data.encode('base64'))
标签：appium,driver,element,API,Android,自动化,android,find 来源： https://www.cnblogs.com/mtoy/p/16448030.html
本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享； 2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关； 3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关； 4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除； 5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。