Appium 工作原理及 Desired Capabilities

一、Appium工作原理

脚本请求 ——> 4723端口appium server ——> 解析参数给PC端4724端口 ——> 发送给设备4724端口 ——> 通过设备4724端口发给bootstrap.jar ——> Bootstrap.jar把命令发给uiautomator

Json Wire Protocol：

它是一种协议，遵循REST风格，以JSON方法进行传输，是一系列的键值对，遵循W3C WebDriver Spec设计风格；appium中的Json wire protocol继承自selenium的webdriver wire protocol，并进行了扩展，使得Json wire protocol能够控制不同的移动设备的行为。

bootstrap：

bootstrap在appium中是以jar包的形式存在的，它的功能是作为一个socket服务，把Appium sever 发送的请求转化成uiautomator的命令来让uiautomator进行处理。

在创建session成功之前，appium就已将bootstrap.jar放入手机中，并开启设备上的基于appium bootstrap的socket服务，绑定本机和boostrap通信的端口号4724用于和Android设备通讯，默认监听4724端口，等待client的连接。

Uiautomator：

UiAutomator是Google提供的用来做安卓自动化测试的一个Java库，基于Accessibility服务。功能很强，可以对第三方App进行测试。它的初始版本发布在Android 4.3 (API level 18)及以上的android系统版本

Selendroid：

Selendroid和UiAutomator类似，也是Google提供的一个安卓自动化测试软件，适用于Android系统的本地应用程序和移动web的UI混合测试。它主要应用在 Android 4.2 (API level 17) 及以下的android系统版本

Instruments：

Instruments 一个很灵活的、强大的工具，是性能分析、动态跟踪 和分析OS X以及iOS代码的测试工具，appium ios封装了apple的 Instruments框架，主要使用Instruments里的UI Automation（Apple的自动化测试框架），然后在设备中注⼊入bootstrap.js进⾏行监听。

二、Desired Capabilities

Desired Capabilities携带了一些配置信息。从本质上讲，它是key-value形式的对象。可以理解成是java里的map，python里的字典，ruby里的hash以及js里的json对象。实际上Desired Capabilities在传输时就是json对象

Desired Capabilities常用键值对介绍：

automationName：使用哪种自动化引擎。appium（默认）还是Selendroid。

platformName： 平台的名称，iOS, Android, or FirefoxOS

platformVersion：移动设备的系统版本号，7.1, 4.4

deviceName： 设备名称，Android:可随意填写; IOS：instruments -s devices

udid：连接的物理设备的唯一设备标识 adb devices 可获取

app：本地绝对路径_或_远程 http URL 所指向的一个安装包（.ipa,.apk,或 .zip文件）。Appium 将其安装到合适的设备上。如果指定了 appPackage 和

appActivity 参数，Android 则不需要此参数了。该参数也与 browserName 不兼容。

browserName：测试的web浏览器，如果是测app则忽略

newCommandTimeout :用于客户端在退出或者结束 session 之前，Appium 等待客户端发送一条新命令所花费的时间（秒为单位）

noReset：在当前session前不重置app状态，默认值为 false

fullReset：(iOS)删除所有的模拟器文件夹。(Android) 要清除 app 里的数据，请将应用卸载才能达到重置应用的效果。在 Android, 在 session 完成之后也会将应用卸载掉。默认值为 false

Desired Capabilities android特有键值对介绍：

appPackage：运行的 Android 应用的包名appActivity：Activity 的名字是指从你的包中所要启动的 Android acticity。通常需要再前面添加‘.’

unicodeKeyboard：使用 Unicode 输入法。 默认值为 false

resetKeyboard：在设定了 unicodeKeyboard 关键字的 Unicode 测试结束后，重置输入法到原有状态。如果单独使用，将会被忽略。默认值为 false

noSign：跳过检查和对应用进行 debug 签名的步骤。仅适用于 UiAutomator，不适用于 selendroid。 默认值为 false

最全：
https://github.com/appium/appium/blob/master/docs/cn/writing-running-
appium/caps.md

目前调试测试脚本（测试网页）：

import time
from appium import webdriver

des = {
    "platformName": "Android",
    "platformVersion": "8.0",
    "deviceName": "Samsung Galaxy S8",
    "udid":"192.168.165.101:5555",
    'browserName': 'chrome',
    'noReset': True,
    'unicodeKeyboard': True,
    'resetKeyboard': True,
    'chromedriverExecutable':'C:/Program Files/Appium/resources/app/node_modules/appium/node_modules/appium-chromedriver/chromedriver/win/chromedriver.exe'
}


driver = webdriver.Remote('http://localhost:4723/wd/hub',des)
time.sleep(1)
# driver.get('https://www.baidu.com')
driver.get('https://www.qq.com')

　　测试APP:

import time
from appium import webdriver

des = {
    "platformName": "Android",
    "platformVersion": "8.0",
    "deviceName": "Samsung Galaxy S8",
    "udid":"192.168.165.101:5555",
    "appPackage": "com.android.calculator2",
    "appActivity": ".Calculator",
    'noReset': True,
    'unicodeKeyboard': True,
    'resetKeyboard': True
}

driver = webdriver.Remote('http://localhost:4723/wd/hub',des)