Appium 环境配置

最新推荐文章于 2024-07-27 15:48:49 发布

小笨蛋哈哈

最新推荐文章于 2024-07-27 15:48:49 发布

阅读量605

点赞数

文章标签： python

本文链接：https://blog.csdn.net/C1054158790/article/details/120253775

版权

Appium工作原理

Client端发送自动化指令给Appium server，Appium Server接收到client发送的指令后，转换为移动端能够识别的指令，然后发送给移动端设备，并对移动端设备进行操作。

1.安装 Appium python client

pip install Appium-Python-Client

2.安装 Appium Desktop

安装 Appium-windows-1.21.0.exe

3.安装安卓开发环境

安装andrioid studio，包含sdk及adb等工具

设置环境变量 ANDROID_HOME

然后再系统变量中找到Path，新建%ANDROID_HOME%\tools

4.安装jdk

尽量下载JDK7及以上的版本。然后去设置环境变量

在命令行中，确认java -version中有输出，即可

5.安装nodejs

npm install -g appium

一、appium的启动参数

http://appium.io/docs/cn/writing-running-appium/caps/
https://github.com/appium/appium/blob/master/docs/cn/writing-running-appium/caps.md

一、Capability配置概述

在利用appium定位手机设备中的APP元素进行自动化操作之前，需要告知appium一些基本的信息，如：设备名称、系统版本、被测的APP应用、元素定位信息。而通过Capability的配置，即可实现以上基本信息的传达到appium

Appium 服务器初始化参数（Capability）

键	描述	值
`automationName`	自动化测试的引擎	`Appium` （默认）或者 `Selendroid`
`platformName`	使用的手机操作系统	`iOS`, `Android`, 或者 `FirefoxOS`
`platformVersion`	手机操作系统的版本	例如 `7.1`, `4.4`
`deviceName`	使用的手机或模拟器类型	`iPhone Simulator`, `iPad Simulator`, `iPhone Retina 4-inch`, `Android Emulator`, `Galaxy S4`, 等等.... 在 iOS 上，使用 Instruments 的 `instruments -s devices` 命令可返回一个有效的设备的列表。在 Andorid 上虽然这个参数目前已被忽略，但仍然需要添加上该参数
`app`	本地绝对路径_或_远程 http URL 所指向的一个安装包（`.ipa`,`.apk`,或 `.zip` 文件）。Appium 将其安装到合适的设备上。请注意，如果您指定了 `appPackage` 和 `appActivity` 参数（见下文），Android 则不需要此参数了。该参数也与 `browserName` 不兼容。	`/abs/path/to/my.apk` 或 `http://myapp.com/app.ipa`
`browserName`	做自动化时使用的浏览器名字。如果是一个应用则只需填写个空的字符串	'Safari' 对应 iOS，'Chrome', 'Chromium', 或 'Browser' 则对应 Android
`newCommandTimeout`	用于客户端在退出或者结束 session 之前，Appium 等待客户端发送一条新命令所花费的时间（秒为单位）	例如 `60`
`language`	(Sim/Emu-only) 为模拟器设置语言	例如 `fr`
`locale`	(Sim/Emu-only) 为模拟器设置所在区域	例如 `fr_CA`
`udid`	连接真机的唯一设备号	例如 `1ae203187fc012g`
`orientation`	(Sim/Emu-only) 模拟器当前的方向	`竖屏` 或 `横屏`
`autoWebview`	直接转换到 Webview 上下文（context）。默认值为 `false`	`true`, `false`
`noReset`	在当前 session 下不会重置应用的状态。默认值为 `false`	`true`, `false`
`fullReset`	(iOS)删除所有的模拟器文件夹。(Android) 要清除 app 里的数据，请将应用卸载才能达到重置应用的效果。在 Android, 在 session 完成之后也会将应用卸载掉。默认值为 `false`	`true`, `false`

Android 独有

键	描述	值
`appActivity`	Activity 的名字是指从你的包中所要启动的 Android acticity。他通常需要再前面添加`.` （例如使用 `.MainActivity` 代替 `MainActivity`）	`MainActivity`, `.Settings`
`appPackage`	运行的 Android 应用的包名	`com.example.android.myApp`, `com.android.settings`
`appWaitActivity`	用于等待启动的 Android Activity 名称	`SplashActivity`
`appWaitPackage`	用于等待启动的 Android 应用的包	`com.example.android.myApp`, `com.android.settings`
`appWaitDuration`	用于等待 appWaitActivity 启动的超时时间（以毫秒为单位）（默认值为 `20000`)	`30000`
`deviceReadyTimeout`	用于等待模拟器或真机准备就绪的超时时间	`5`
`androidCoverage`	用于执行测试的 instrumentation 类。传送 `-w` 参数到如下命令 `adb shell am instrument -e coverage true -w`	`com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation`
`enablePerformanceLogging`	（仅适用于 Chrome 与 webview）开启 Chromedriver 的性能日志。（默认值为 `false`）	`true`, `false`
`androidDeviceReadyTimeout`	用于等待设备在启动应用后准备就绪的超时时间。以秒为单位。	例如 `30`
`androidInstallTimeout`	用于等待在设备中安装 apk 所花费的时间（以毫秒为单位）。默认值为 `90000`	例如 `90000`
`adbPort`	用来连接 ADB 服务器的端口（默认值为 `5037`）	`5037`
`androidDeviceSocket`	开发工具的 socket 名称。只有在被测应用是一个使用 Chromium 内核的浏览器时才需要。socket 会被浏览器打开，然后 Chromedriver 把它作为开发者工具来进行连接。	例如 `chrome_devtools_remote`
`avd`	被启动 avd 的名字	例如 `api19`
`avdLaunchTimeout`	用于等待 avd 启动并连接 ADB 的超时时间（以毫秒为单位），默认值为 `120000`。	`300000`
`avdReadyTimeout`	用于等待 avd 完成启动动画的超时时间（以毫秒为单位），默认值为 `120000`。	`300000`
`avdArgs`	启动 avd 时使用的额外参数	例如 `-netfast`
`useKeystore`	使用自定义的 keystore 给 apk 签名，默认值为 `false`	`true`或`false`
`keystorePath`	自定义 keystore 的路径, 默认路径为 ~/.android/debug.keystore	例如 `/path/to.keystore`
`keystorePassword`	自定义 keystore 的密码	例如 `foo`
`keyAlias`	key 的别名	例如 `androiddebugkey`
`keyPassword`	key 的密码	例如 `foo`
`chromedriverExecutable`	webdriver 可执行文件的绝对路径（如果 Chromium 内嵌一个自己提供的 webdriver，则应使用他去替换掉 Appium 自带的 chromedriver）	`/abs/path/to/webdriver`
`autoWebviewTimeout`	用于等待 Webview 上下文（context）激活的时间（以毫秒为单位）。默认值为 `2000`	例如 `4`
`intentAction`	用于启动 activity 的 intent action（默认值为 `android.intent.action.MAIN`)	例如 `android.intent.action.MAIN`, `android.intent.action.VIEW`
`intentCategory`	用于启动 activity 的 intent category。（默认值为 `android.intent.category.LAUNCHER`)	例如 `android.intent.category.LAUNCHER`, `android.intent.category.APP_CONTACTS`
`intentFlags`	用于启动 activity 的标识（flags）（默认值为 `0x10200000`）	例如 `0x10200000`
`optionalIntentArguments`	用于启动 activity 的额外 intent 参数。请查看 Intent 参数	例如 `--esn <EXTRA_KEY>`, `--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>`, 等等。
`dontStopAppOnReset`	在使用 adb 启动应用之前，不要终止被测应用的进程。如果被测应用是被其他钩子(anchor)应用所创建的，设置该参数为 false 后，就允许钩子(anchor)应用的进程在使用 adb 启动被测应用期间仍然存在。换而言之，设置 `dontStopAppOnReset` 为 `true` 后，我们在 `adb shell am start` 的调用中不需要包含 `-S`标识（flag）。忽略该 capability 或设置为 `false` 的话，就需要包含 `-S` 标识（flag）。默认值为 `false`	`true`或`false`
`unicodeKeyboard`	使用 Unicode 输入法。默认值为 `false`	`true`或`false`
`resetKeyboard`	在设定了 `unicodeKeyboard` 关键字的 Unicode 测试结束后，重置输入法到原有状态。如果单独使用，将会被忽略。默认值为 `false`	`true`或`false`
`noSign`	跳过检查和对应用进行 debug 签名的步骤。仅适用于 UiAutomator，不适用于 selendroid。默认值为 `false`	`true`或`false`
`ignoreUnimportantViews`	调用 uiautomator 的函数 `setCompressedLayoutHierarchy()`。由于 Accessibility 命令在忽略部分元素的情况下执行速度会加快，这个关键字能加快测试执行的速度。被忽略的元素将不能够被找到，因此这个关键字同时也被实现成可以随时改变的设置 ( settings )。默认值为 `false`	`true` 或 `false`
`disableAndroidWatchers`	禁用 android 监视器（watchers）。监视器用于见识应用程序的无响应状态（anr）和崩溃（crash），禁用会降低 Android 设备或模拟器的 CPU 使用率。该 capability 仅在使用 UiAutomator 时有效，不适用于 selendroid，默认设置为 `false`。	`true` 或 `false`
`chromeOptions`	允许对 ChromeDriver 传 chromeOptions 的参数。了解更多信息请查阅 chromeOptions	`chromeOptions: {args: ['--disable-popup-blocking']}`
`recreateChromeDriverSessions`	当移除非 ChromeDriver webview时，终止掉 ChromeDriver 的 session。默认设置为 `false`	`true`或`false`
`nativeWebScreenshot`	在 web 的上下文（context），使用原生（native）的方法去截图，而不是用过代理的 ChromeDriver。默认值为 `false`	`true`或`false`
`androidScreenshotPath`	在设备中截图被保存的目录名。默认值为 `/data/local/tmp`	例如 `/sdcard/screenshots/`
`autoGrantPermissions`	让Appium自动确定您的应用需要哪些权限，并在安装时将其授予应用。默认设置为 `false`	`true`或`false`

iOS 独有

键	描述	值
`calendarFormat`	（仅支持模拟器）为iOS的模拟器设置日历格式	例如 `gregorian`
`bundleId`	被测应用的 bundle ID 。用于在真实设备中启动测试，也用于使用其他需要 bundle ID 的关键字启动测试。在使用 bundle ID 在真实设备上执行测试时，你可以不提供 `app` 关键字，但你必须提供 `udid` 。	例如 `io.appium.TestApp`
`udid`	连接的真实设备的唯一设备编号 (Unique device identifier)	例如 `1ae203187fc012g`
`launchTimeout`	以毫秒为单位，在 Appium 运行失败之前设置一个等待 instruments 的时间	例如 `20000`
`locationServicesEnabled`	（仅支持模拟器）强制打开或关闭定位服务。默认值是保持当前模拟器的设定.	`true`或`false`
`locationServicesAuthorized`	（仅支持模拟器）通过修改 plist 文件设定是否允许应用使用定位服务，从而避免定位服务的警告出现。默认值是保持当前模拟器的设定。请注意在使用这个关键字时，你同时需要使用 `bundleId` 关键字来发送你的应用的 bundle ID。	`true`或`false`
`autoAcceptAlerts`	当警告弹出的时候，都会自动去点接受。包括隐私访问权限的警告（例如定位，联系人，照片）。默认值为 false。不支持基于 `XCUITest` 的测试。	`true`或`false`
`autoDismissAlerts`	当警告弹出的时候，都会自动去点取消。包括隐私访问权限的警告（例如定位，联系人，照片）。默认值为 false。不支持基于 `XCUITest` 的测试。	`true`或`false`
`nativeInstrumentsLib`	使用原生 intruments 库（即关闭 instruments-without-delay）。	`true`或`false`
`nativeWebTap`	（仅支持模拟器）在Safari中允许“真实的"，非基于 javascript 的 web 点击 (tap) 。默认值：`false`。注意：取决于 viewport 大小/比例，点击操作不一定能精确地点中对应的元素。	`true`或`false`
`safariInitialUrl`	（仅支持模拟器） (>= 8.1) 初始化 safari 的时使用的地址。默认是一个本地的欢迎页面	例如 `https://www.github.com`
`safariAllowPopups`	（仅支持模拟器）允许 javascript 在 Safari 中创建新窗口。默认保持模拟器当前设置。	`true`或`false`
`safariIgnoreFraudWarning`	（仅支持模拟器）阻止 Safari 显示此网站可能存在风险的警告。默认保持浏览器当前设置。	`true`或`false`
`safariOpenLinksInBackground`	（仅支持模拟器）Safari 是否允许链接在新窗口打开。默认保持浏览器当前设置。	`true`或`false`
`keepKeyChains`	（仅支持模拟器）当 Appium 会话开始/结束时是否保留存放密码存放记录 (keychains) 库(Library)/钥匙串(Keychains))	`true`或`false`
`localizableStringsDir`	从哪里查找本地化字符串。默认值为 `en.lproj`	`en.lproj`
`processArguments`	通过 instruments 传递到 AUT 的参数	例如 `-myflag`
`interKeyDelay`	以毫秒为单位，按下每一个按键之间的延迟时间	例如 `100`
`showIOSLog`	是否在 Appium 的日志中显示设备的日志。默认值为 `false`	`true`或`false`
`sendKeyStrategy`	输入文字到文字框的策略。模拟器默认值：`oneByOne`(一个接着一个)。真实设备默认值：`grouped` (分组输入)	`oneByOne`, `grouped`或`setValue`
`screenshotWaitTimeout`	以秒为单位，生成屏幕截图的最长等待时间。默认值为：10	例如 `5`
`waitForAppScript`	用于判断 "应用是否被启动” 的 iOS 自动化脚本代码。默认情况下系统等待直到页面内容非空。结果必须是布尔类型。	例如 `true;`, `target.elements().length > 0;`, `$.delay(5000); true;`
`webviewConnectRetries`	用于获取 webview 失败时，发送连接信息到远程调试器的次数。默认次数为: `8`	例如 `12`
`appName`	被测应用的名字。用于支持 iOS 9 以上系统的应用的自动化。	例如 `UICatalog`
`customSSLCert`	(Sim/Emu-only) 给模拟器添加一个 SSL 证书。	例如 `-----BEGIN CERTIFICATE-----MIIFWjCCBEKg...` `-----END CERTIFICATE-----`

如：启动一个淘宝APP：

{
  "platformName": "Android",
  "platformVersion": "10",
  "deviceName": "MQS0219A16008247",
  "appPackage": "com.taobao.taobao",
  "appActivity": "com.taobao.tao.welcome.Welcome",
  "noReset": true
}

from appium import webdriver
import time

# appium服务监听地址
server='http://localhost:4723/wd/hub'
# app启动参数
desired_caps= {
  "platformName": "Android",
  "platformVersion": "10",
  "deviceName": "MQS0219A16008247",
  "appPackage": "com.taobao.taobao",
  "appActivity": "com.taobao.tao.welcome.Welcome",
  "noReset": True
}

# 驱动
driver = webdriver.Remote(server,desired_caps)
time.sleep(3)
search = driver.find_element_by_accessibility_id("搜索"); 
search.click()
time.sleep(3)
text_input = driver.find_element_by_id('com.taobao.taobao:id/searchEdit')
text_input.send_keys('小会会')

查看 platformVersion：adb shell getprop ro.build.version.release

查看 deviceName： adb devices

查看 appPackage 和 appActivity