自动化测试-Appium-Desired Capabilities参数详解

男娘i 2022-11-12 08:16 320阅读 0赞

### 分类 ###

*   *   *   *   *  定义与说明
                 *  General Capabilities（通用功能）
                 *   *  Update settings
                 *  Android Only
                 *   *  UIAutomator 1
                     *  UIAutomator2 Only
                     *  Espresso Only
                 *  iOS Only
                 *   *  iOS Only, using XCUITest
                     *  Safaridriver Only
                     *  Geckodriver Only
                     *  MacDriver Only
                     *  Mac2Driver Only
                     *  You.i Engine Only
                     *  WinAppDriver Only
                     *  Flutter driver only

##### 定义与说明 #####

*  Desired capabilities是编码在JSON对象中的键和值
 *  在请求新的自动化会话时由Appium客户端发送到服务器
 *  用来告诉Appium 驱动程序做哪些特定的测试
 *  可在WebDriver测试中编写脚本
 *  可在Appium服务器GUI中设置
 *  可在设置中添加项目名和值，Appium中自带JSON转换
 *  类似Jmeter、Postman、Fiddler、Web等里面的参数请求，这种请求在这里是面向iOS和Android移动端的，有兴趣的小伙伴都去了解一下

{ 
        "platformName": "iOS",
        "platformVersion": "11.0",
        "deviceName": "iPhone 7",
        "automationName": "XCUITest",
        "app": "/path/to/my.app"
    }

##### General Capabilities（通用功能） #####

<table> 
 <thead> 
  <tr> 
   <th>Capability Name</th> 
   <th>Description</th> 
   <th>Values</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>automationName</code></td> 
   <td>使用哪种自动化引擎</td> 
   <td>Android:<code>Appium</code>(default)/<code>UiAutomator2</code>/<code>Espresso</code>/<code>UiAutomator1</code>;IOS:<code>xguitest</code>/<code>Instruments</code>;<code>YouiEngine</code>用于与您一起构建的应用程序,i Engine</td> 
  </tr> 
  <tr> 
   <td><code>platformName</code></td> 
   <td>使用哪个移动操作系统平台</td> 
   <td><code>iOS</code>, <code>Android</code>, or<code>FirefoxOS</code></td> 
  </tr> 
  <tr> 
   <td><code>platformVersion</code></td> 
   <td>移动操作系统的版本</td> 
   <td>例如：<code>7.1</code>, <code>4.4</code></td> 
  </tr> 
  <tr> 
   <td><code>deviceName</code></td> 
   <td>要使用的移动设备或模拟器的类型</td> 
   <td><code>iPhone Simulator, iPad Simulator, iPhone Retina 4-inch, Android Emulator, Galaxy S4</code>,etc…在iOS上，这应该是带有<code>“instruments-s devices”</code>的仪器返回的有效设备之一。在Android上，这个功能目前被忽略了，尽管它仍然是必需的</td> 
  </tr> 
  <tr> 
   <td><code>app</code></td> 
   <td><code>ipa</code> file(IOS),<code>app</code> folder(IOS Simulator); <code>.apk</code> file(Android),<code>.apks</code> file(Android App Bundle),绝对路径的<code>.zip</code> file，远程http URL;注意：如果您指定<code>appPackage</code>和<code>appActivity</code>启动，<code>UiAutomator2</code>和 <code>XCUITest</code>允许在没有app或<code>appPackage</code>的情况下启动会话，与 <code>browserName</code>不兼容,<code>.apk file</code><a href="http://appium.io/docs/en/writing-running-appium/android/android-appbundle/index.html" rel="nofollow">here</a></td> 
   <td><code>/abs/path/to/my.apk or http://myapp.com/app.ipa</code></td> 
  </tr> 
  <tr> 
   <td><code>otherApps</code></td> 
   <td>运行测试之前要安装的应用程序或应用程序列表（作为JSON数组）；请注意，它不适用于<code>automationName</code>of <code>Espresso</code>和 iOS真机</td> 
   <td>e.g.,<code>"/path/to/app.apk", https://www.example.com/url/to/app.apk, ["http://appium.github.io/appium/assets/TestApp9.4.app.zip", "/path/to/app-b.app"]</code></td> 
  </tr> 
  <tr> 
   <td><code>browserName</code></td> 
   <td>要自动化的移动web浏览器的名称；如果改为自动化应用程序，则应为空字符串</td> 
   <td>iOS的“Safari”和Android的“Chrome”、“Chrome”或“Browser”</td> 
  </tr> 
  <tr> 
   <td><code>newCommandTimeout</code></td> 
   <td>在假定客户端退出并结束会话之前，Appium将等待来自客户端的新命令多长时间（以秒为单位）</td> 
   <td>e.g. <code>60</code></td> 
  </tr> 
  <tr> 
   <td><code>language</code></td> 
   <td>为iOS（仅限Xguitest驱动程序）和Android设置的语言</td> 
   <td>e.g.<code>fr</code></td> 
  </tr> 
  <tr> 
   <td><code>locale</code></td> 
   <td>要为iOS（仅限Xguitest驱动程序）和Android设置的区域设置。iOS的<code>fr_CA</code>格式。Android的<code>CA</code>格式（国家名称缩写）</td> 
   <td>e.g. <code>fr_CA, CA</code></td> 
  </tr> 
  <tr> 
   <td><code>udid</code></td> 
   <td>连接物理设备的唯一设备标识符</td> 
   <td>e.g. <code>1ae203187fc012g</code></td> 
  </tr> 
  <tr> 
   <td><code>orientation</code></td> 
   <td>（仅限Sim/Emu）以特定方向启动</td> 
   <td><code>LANDSCAPE or PORTRAIT</code></td> 
  </tr> 
  <tr> 
   <td><code>autoWebview</code></td> 
   <td>直接移动到Webview上下文中。默认值<code>false</code></td> 
   <td><code>true</code>，<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>noReset</code></td> 
   <td>在此会话之前不重置应用程序状态<a href="http://appium.io/docs/en/writing-running-appium/other/reset-strategies/index.html" rel="nofollow">参考</a></td> 
   <td>true,false</td> 
  </tr> 
  <tr> 
   <td><code>fullReset</code></td> 
   <td>执行完全复位<a href="http://appium.io/docs/en/writing-running-appium/other/reset-strategies/index.html" rel="nofollow">参考</a></td> 
   <td><code>true</code>,<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>eventTimings</code></td> 
   <td>启用或禁用报告各种Appium内部事件的计时（例如，每个命令的开始和结束等）;默认为<code>false</code>;要启用，请使用<code>true</code>;然后，在查询当前会话时，将计时报告为<code>events</code>属性<a href="http://appium.io/docs/en/advanced-concepts/event-timings/index.html" rel="nofollow">event</a>,<a href="http://appium.io/docs/en/advanced-concepts/event-timings/index.html" rel="nofollow">timing doce</a></td> 
   <td>e.g.,<code>true</code></td> 
  </tr> 
  <tr> 
   <td><code>enablePerformanceLogging</code></td> 
   <td>（仅限Web和webview）启用Chromedriver（在Android上）或Safari（在iOS上）性能日志（默认为<code>false</code>）</td> 
   <td><code>true</code>, <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>printPageSourceOnFindFailure</code></td> 
   <td>查找操作失败时，打印当前页源;默认为<code>false</code></td> 
   <td>e.g.,<code>true</code></td> 
  </tr> 
  <tr> 
   <td>clearSystemFiles</td> 
   <td>在会话结束时删除所有生成的文件;默认为<code>false</code></td> 
   <td><code>true</code>, <code>false</code></td> 
  </tr> 
 </tbody> 
</table>

###### Update settings ######

<table> 
 <thead> 
  <tr> 
   <th>Capability</th> 
   <th>Description</th> 
   <th>Values</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>settings[settingsKey]</code></td> 
   <td>Update <a href="https://github.com/appium/appium/blob/master/docs/en/advanced-concepts/settings.md" rel="nofollow">Appium Settings</a> on session creation</td> 
   <td>e.g., <code>'settings[mjpegScalingFactor]': 10, 'settings[shouldUseCompactResponses]': true</code></td> 
  </tr> 
 </tbody> 
</table>

##### Android Only #####

<table> 
 <thead> 
  <tr> 
   <th>Capability</th> 
   <th>Description</th> 
   <th>Values</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>appActivity</code></td> 
   <td>要从包中启动的Android活动的活动名称;这通常需要在前面加一个标记<code>a.</code>;（例如，<code>MainActivity</code>代替<code>MainActivity</code>）;默认情况下，此功能从包清单接收（操作：android.intent.action操作.MAIN，类别：android.intent.category类别（发射器 )</td> 
   <td><code>MainActivity, .Settings</code></td> 
  </tr> 
  <tr> 
   <td><code>appPackage</code></td> 
   <td>要运行的Android应用程序的Java包;默认情况下，此功能从包清单（@package attribute value）接收</td> 
   <td><code>com.example.android.myApp, com.android.settings</code></td> 
  </tr> 
  <tr> 
   <td><code>appWaitActivity</code></td> 
   <td>活动名称，逗号分隔，用于您要等待的Android活动;默认情况下，此功能的值与<code>appActivity</code>的值相同;如果您的功能具有<code>appActivity</code>和<code>appPackage</code>，则必须将其设置为第一个关注的应用程序活动名称，以防它与设置为<code>appActivity</code>的名称不同;也可以使用通配符（<code>*</code>）</td> 
   <td><code>SplashActivity, SplashActivity,OtherActivity, *, *.SplashActivity</code></td> 
  </tr> 
  <tr> 
   <td><code>appWaitPackage</code></td> 
   <td>您要等待的Android应用程序的Java包;默认情况下，此功能的值与<code>appActivity</code>的值相同</td> 
   <td><code>com.example.android.myApp, com.android.settings</code></td> 
  </tr> 
  <tr> 
   <td><code>appWaitDuration</code></td> 
   <td>用于等待appWaitActivity启动的超时（毫秒）（默认值为<code>20000</code>）</td> 
   <td><code>30000</code></td> 
  </tr> 
  <tr> 
   <td><code>deviceReadyTimeout</code></td> 
   <td>等待设备准备就绪时超时（秒）</td> 
   <td><code>5</code></td> 
  </tr> 
  <tr> 
   <td><code>allowTestPackages</code></td> 
   <td>允许安装具有<code>android:testOnly="true"</code>;默认为<code>false</code></td> 
   <td><code>true</code>,<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>androidCoverage</code></td> 
   <td>完全合格的仪器等级;传递给adb shell am instrument中的-w-e覆盖范围真-w</td> 
   <td><code>com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation</code></td> 
  </tr> 
  <tr> 
   <td><code>androidCoverageEndIntent</code></td> 
   <td>由您自己实现的广播操作，用于将覆盖率转储到文件系统中。在adb shell am广播-a中传递给-a</td> 
   <td><code>com.example.pkg.END_EMMA</code></td> 
  </tr> 
  <tr> 
   <td><code>androidDeviceReadyTimeout</code></td> 
   <td>用于等待设备在引导后准备就绪的超时（以秒为单位）</td> 
   <td>e.g., <code>30</code></td> 
  </tr> 
  <tr> 
   <td><code>androidInstallTimeout</code></td> 
   <td>用于等待apk安装到设备的超时（毫秒）；默认为<code>90000</code></td> 
   <td>e.g., <code>90000</code></td> 
  </tr> 
  <tr> 
   <td><code>androidInstallPath</code></td> 
   <td>安装前将在其中推送apk的设备上的目录的名称；默认为<code>/data/local/tmp</code></td> 
   <td>e.g. <code>/sdcard/Downloads/</code></td> 
  </tr> 
  <tr> 
   <td><code>adbPort</code></td> 
   <td>用于连接ADB服务器的端口（默认<code>5037</code>）</td> 
   <td>e.g.,<code>5037</code></td> 
  </tr> 
  <tr> 
   <td><code>systemPort</code></td> 
   <td><code>systemPort</code>用于连接到<a href="https://github.com/appium/appium-uiautomator2-server" rel="nofollow">appium-uiautomator2-server</a>或<a href="https://github.com/appium/appium-espresso-driver" rel="nofollow">appium espresso</a>驱动程序的系统端口；默认值通常是<code>8200</code>，对于appium-uiautomator2-server，选择<code>8200</code>到<code>8299</code>之间的一个端口，对于appium espresso driver，选择<code>8300</code>到<code>8399</code>之间的<code>8300</code>；并行运行测试时，必须调整端口以避免冲突；<a href="https://github.com/appium/appium/blob/master/docs/en/advanced-concepts/parallel-tests.md#parallel-android-tests" rel="nofollow">参考</a></td> 
   <td>e.g.,<code>8201</code></td> 
  </tr> 
  <tr> 
   <td><code>remoteAdbHost</code></td> 
   <td>可选的远程ADB服务器主机</td> 
   <td>e.g.: 192.168.0.101</td> 
  </tr> 
  <tr> 
   <td><code>androidDeviceSocket</code></td> 
   <td>Devtools套接字名称；仅当测试的应用程序是Chromium嵌入浏览器时才需要；套接字由浏览器打开，Chromedriver作为devtools客户端连接到它</td> 
   <td>e.g., <code>chrome_devtools_remote</code></td> 
  </tr> 
  <tr> 
   <td><code>avd</code></td> 
   <td>要启动的avd名称</td> 
   <td>e.g., <code>api19</code></td> 
  </tr> 
  <tr> 
   <td><code>avdLaunchTimeout</code></td> 
   <td>vd启动和连接到ADB的等待时间（毫秒）（默认<code>60000</code>）</td> 
   <td><code>30000</code></td> 
  </tr> 
  <tr> 
   <td><code>avdReadyTimeout</code></td> 
   <td>avd启动和连接到ADB的等待时间（毫秒）（默认<code>120000</code>）</td> 
   <td><code>300000</code></td> 
  </tr> 
  <tr> 
   <td><code>avdArgs</code></td> 
   <td>启动avd时使用的其他仿真器参数</td> 
   <td>e.g., <code>-netfast</code></td> 
  </tr> 
  <tr> 
   <td><code>useKeystore</code></td> 
   <td>使用自定义密钥库对apk进行签名，默认值为<code>false</code></td> 
   <td><code>true</code>,<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>keystorePath</code></td> 
   <td>自定义密钥库的路径，默认~/.android/调试密钥库</td> 
   <td>e.g., <code>/path/to.keystore</code></td> 
  </tr> 
  <tr> 
   <td><code>keystorePassword</code></td> 
   <td>自定义密钥库的密码</td> 
   <td>e.g.,<code>foo</code></td> 
  </tr> 
  <tr> 
   <td><code>keyAlias</code></td> 
   <td>密钥别名</td> 
   <td>e.g., <code>androiddebugkey</code></td> 
  </tr> 
  <tr> 
   <td><code>keyPassword</code></td> 
   <td>Password for key</td> 
   <td>e.g.,<code>foo</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverExecutable</code></td> 
   <td>webdriver可执行文件的绝对本地路径（如果ChromeMbedder提供了自己的webdriver，则应该使用它，而不是与Appium捆绑的原始chromedriver）</td> 
   <td><code>/abs/path/to/webdriver</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverArgs</code></td> 
   <td>应用程序运行chromedriver二进制文件时要传递给它的参数数组;默认情况下，除了Appium内部使用的参数（例如<code>--url base</code>、<code>--port</code>、<code>--adb port</code>和<code>--log path</code>），不会添加任何CLI参数</td> 
   <td>e.g.,<code>["--disable-gpu", "--disable-web-security"]</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverExecutableDir</code></td> 
   <td>查找Chromedriver可执行文件的目录的绝对路径，用于自动发现兼容的Chromedriver。如果<code>chromedriverUseSystemExecutable</code>为<code>true</code>，则忽略</td> 
   <td><code>/abs/path/to/chromedriver/directory</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverChromeMappingFile</code></td> 
   <td>将Chromedriver版本映射到其支持的最低Chrome的文件的绝对路径;如果<code>chromedriverUseSystemExecutable</code>为<code>true</code>，则忽略</td> 
   <td><code>/abs/path/to/mapping.json</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverUseSystemExecutable</code></td> 
   <td>如果为<code>true</code>，则绕过自动<code>ChromedriverExecutable</code>设置，并使用Appium附带的版本;如果设置了<code>ChromedDriverExecutable</code>，则忽略该选项;默认为<code>false</code></td> 
   <td>e.g., <code>true</code></td> 
  </tr> 
  <tr> 
   <td><code>autoWebviewTimeout</code></td> 
   <td>等待Webview上下文变为活动状态的时间量（毫秒）;默认值为<code>2000</code></td> 
   <td>e.g.<code>4</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverPort</code></td> 
   <td>启动Chromedriver的数字端口;请注意，不鼓励使用此功能，因为如果存在多个Web视图，它将导致未定义的行为;默认情况下，Appium将找到一个空闲端口</td> 
   <td>e.g. <code>8000</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverPorts</code></td> 
   <td>Appium用于与ChromeDriver通信的有效端口列表。此功能支持多种webview方案。此功能的形式是一个数字端口数组，其中数组项本身可以是长度为2的数组，其中第一个元素是包含范围的开始，第二个元素是结束;默认情况下，Appium将使用任何空闲端口</td> 
   <td>e.g.<code>[8000, [9000, 9005]]</code></td> 
  </tr> 
  <tr> 
   <td><code>ensureWebviewsHavePages</code></td> 
   <td>Appium是否应该用页面检测来增强其webview检测，以保证上下文列表中显示的任何webview上下文都有活动页面。如果选择了Chromedriver找不到任何页面的上下文，这可以防止出现错误;默认为<code>false</code></td> 
   <td>e.g. <code>true</code></td> 
  </tr> 
  <tr> 
   <td><code>webviewDevtoolsPort</code></td> 
   <td>要支持<code>ensureWebviewsHavePages</code>功能，必须打开一个TCP端口，以便与被测设备上的webview进行通信。如果多个会话同时运行（以避免端口冲突），或者默认端口不适合您的系统，此功能允许覆盖默认端口<code>9222</code></td> 
   <td>e.g. <code>9543</code></td> 
  </tr> 
  <tr> 
   <td><code>enableWebviewDetailsCollection</code></td> 
   <td>从Appium 1.18.0+开始，通过<code>/json/version</code>CDP（Chrome Developer Protocol）端点收集详细的WebView信息;这有助于正确匹配支持给定WebView的Chromedriver版本;如果不启用此标志，Appium将尝试根据相应安装包的版本猜测WebView的版本（对于自定义web <a href="https://github.com/appium/appium/issues/13918" rel="nofollow">fails</a>，这通常会失败）;默认为<code>false</code></td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>dontStopAppOnReset</code></td> 
   <td>在使用adb启动应用程序之前，不停止正在测试的应用程序的进程;如果测试中的应用程序是由另一个锚应用程序创建的，则将此设置为false将允许锚应用程序的进程在使用adb的测试应用程序启动期间仍然处于活动状态;换句话说，当<code>dontstopapnreset</code>设置为<code>true</code>时，我们将不在<code>adb shell am start</code>调用中包含<code>-S</code>标志;如果忽略此功能或将其设置为<code>false</code>，则包含<code>-S</code>标志;默认值<code>false</code></td> 
   <td><code>true or false</code></td> 
  </tr> 
  <tr> 
   <td><code>unicodeKeyboard</code></td> 
   <td>启用Unicode输入，默认为<code>false</code></td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>resetKeyboard</code></td> 
   <td>使用<code>unicodeKeyboard</code>功能运行Unicode测试后，将键盘重置为其原始状态;如果单独使用则忽略;默认值<code>false</code></td> 
   <td><code>true</code>or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>noSign</code></td> 
   <td>跳过对带有调试密钥的应用程序的检查和签名，将仅适用于UiAutomator，默认为<code>false</code></td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>ignoreUnimportantViews</code></td> 
   <td>调用<code>setCompressedLayoutHierarchy（）</code>uiautomator函数;此功能可以加快测试执行速度，因为可访问性命令将在忽略某些元素的情况下运行得更快;被忽略的元素将不可查找，这就是为什么此功能也被实现为可切换设置以及功能的原因;默认为<code>false</code></td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>disableAndroidWatchers</code></td> 
   <td>禁用监视应用程序无响应和应用程序崩溃的android观察程序，这将减少android设备/仿真器上的cpu使用;此功能仅适用于UiAutomator，默认为<code>false</code></td> 
   <td><code>true</code>or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>chromeOptions</code></td> 
   <td>允许ChromeDriver传递chromeOptions功能;<a href="https://sites.google.com/a/chromium.org/chromedriver/capabilities" rel="nofollow">chromeOptions</a></td> 
   <td><code>chromeOptions: {args: ['--disable-popup-blocking']}</code></td> 
  </tr> 
  <tr> 
   <td><code>recreateChromeDriverSessions</code></td> 
   <td>移动到非ChromeDriver webview时终止ChromeDriver会话;默认为false</td> 
   <td>true or false</td> 
  </tr> 
  <tr> 
   <td><code>nativeWebScreenshot</code></td> 
   <td>在web环境中，使用本机（adb）方法拍摄屏幕截图，而不是代理到ChromeDriver;默认为<code>false</code></td> 
   <td><code>true</code>or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>androidScreenshotPath</code></td> 
   <td>设备上放置屏幕截图的目录的名称;默认为<code>/data/local/tmp</code></td> 
   <td>e.g.<code>/sdcard/screenshots/</code></td> 
  </tr> 
  <tr> 
   <td><code>autoGrantPermissions</code></td> 
   <td>让Appium自动确定您的应用程序需要哪些权限，并在安装时将这些权限授予应用程序;默认为false;如果noReset为真，则此功能不起作用</td> 
   <td>true or false</td> 
  </tr> 
  <tr> 
   <td><code>networkSpeed</code></td> 
   <td>设置网络速度模拟;指定最大网络上载和下载速度;默认为“完全”</td> 
   <td><code>['full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo']</code> Check <a href="https://developer.android.com/studio/run/emulator-commandline.html" rel="nofollow">-netspeed option</a> more info about speed emulation for avds</td> 
  </tr> 
  <tr> 
   <td><code>gpsEnabled</code></td> 
   <td>在启动会话之前切换模拟器的gps位置提供程序;默认情况下，emulator将根据其配置方式启用或不启用此选项</td> 
   <td><code>true</code>or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>isHeadless</code></td> 
   <td>当设备显示不需要可见时，将此功能设置为<code>true</code>以运行Emulator headless;<code>false</code>是默认值;ISEADRESS还支持iOS，检查XUITEST特定功能</td> 
   <td>e.g., <code>true</code></td> 
  </tr> 
  <tr> 
   <td><code>adbExecTimeout</code></td> 
   <td>用于等待adb命令执行的超时（毫秒）;默认值为<code>20000</code></td> 
   <td>e.g., <code>50000</code></td> 
  </tr> 
  <tr> 
   <td><code>localeScript</code></td> 
   <td>Sets the locale <a href="https://developer.android.com/reference/java/util/Locale" rel="nofollow">script</a></td> 
   <td>e.g., <code>"Cyrl" (Cyrillic)</code></td> 
  </tr> 
  <tr> 
   <td><code>skipDeviceInitialization</code></td> 
   <td>跳过设备初始化，包括：安装和运行设置应用程序或设置权限;当设备已经用于自动化并且为下一个自动化做好准备时，可以用来提高启动性能;默认为<code>false</code></td> 
   <td><code>true</code>or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>chromedriverDisableBuildCheck</code></td> 
   <td>设置chromedriver标志<code>--disable-build-check</code>用于Chrome webview测试</td> 
   <td>true or false</td> 
  </tr> 
  <tr> 
   <td><code>skipUnlock</code></td> 
   <td>在会话创建期间跳过解锁;默认为<code>false</code></td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>unlockType</code></td> 
   <td>用特定的锁定模式解锁目标设备，而不是仅仅用助手应用程序唤醒设备;它具有<code>unlockkey</code>功能;默认为未定义;<code>fingerprint</code>仅适用于Android 6.0+和模拟器;<a href="https://github.com/appium/appium-android-driver/blob/master/docs/UNLOCK.md" rel="nofollow">unlock doc</a></td> 
   <td><code>['pin', 'password', 'pattern', 'fingerprint']</code></td> 
  </tr> 
  <tr> 
   <td><code>unlockKey</code></td> 
   <td>A key pattern to unlock used by<code>unlockType</code></td> 
   <td>e.g.,<code>'1111'</code></td> 
  </tr> 
  <tr> 
   <td><code>autoLaunch</code></td> 
   <td>正在自动初始化测试中的应用程序;如果为false，Appium不会安装/启动测试中的应用程序;默认为<code>true</code></td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>skipLogcatCapture</code></td> 
   <td>跳过以开始捕获logcat;它可能会提高性能，如网络;与日志相关的命令将不起作用;默认为<code>false</code></td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>uninstallOtherPackages</code></td> 
   <td>一个包、包列表或<code>*</code>以在安装apks进行测试之前卸载包<code>'*'</code>卸载所有第三方软件包，但Appium测试所需的软件包除外，例如<code>io.appium.settings</code>或者<code>io.appium.uiautomator2.server</code>，因为Appium已经包含管理它们的逻辑</td> 
   <td>e.g. “io.appium.example”, [“io.appium.example1”, “io.appium.example2”], ‘*’</td> 
  </tr> 
  <tr> 
   <td><code>disableWindowAnimation</code></td> 
   <td>如果该值为<code>true</code>，则将设备动画比例设置为零;会话完成后，Appium将动画比例恢复为原始值;默认为<code>false</code></td> 
   <td><code>true</code>, <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>remoteAppsCacheLimit</code></td> 
   <td>设置推送到被测设备本地存储的最大远程缓存apk数（默认值为10）;在使用同一组apk时，远程缓存apk可以加快顺序测试用例的执行，因为每次需要重新安装时都不需要将apk推送到远程文件系统;将此功能设置为0以禁用缓存</td> 
   <td>e.g.<code>0, 5, 20</code></td> 
  </tr> 
  <tr> 
   <td><code>buildToolsVersion</code></td> 
   <td>将Android<code>build-tools</code>版本指定为与默认版本不同的版本，即使用最新版本;如果您的环境使用alpha/beta构建工具，那么使用非默认版本是很有帮助的</td> 
   <td>e.g. <code>'28.0.3'</code></td> 
  </tr> 
  <tr> 
   <td><code>androidNaturalOrientation</code></td> 
   <td>允许正确处理横向设备的方向;如果设置为<code>true</code>，则基本上可以翻转肖像和风景的含义;默认为<code>false</code></td> 
   <td><code>true</code>, <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>enforceAppInstall</code></td> 
   <td>默认情况下，如果测试设备上已存在此应用程序的较新或相同版本，则跳过应用程序安装;将此选项设置为<code>true</code>将强制Appium始终独立于当前安装的应用程序版本安装当前的应用程序版本;默认为<code>false</code></td> 
   <td><code>true</code> ,<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>ignoreHiddenApiPolicyError</code></td> 
   <td><code>Security exception: Permission denial</code>并允许从Appium 1.18.0+开始继续会话创建过程;当Appium尝试放宽<a href="https://developer.android.com/distribute/best-practices/develop/restrictions-non-sdk-interfaces#how_can_i_enable_access_to_non-sdk_interfaces" rel="nofollow">hidden API</a>策略时，会发生此错误，尽管某些具有自定义固件的设备会拒绝此类请求;默认为<code>false</code></td> 
   <td><code>true,</code>false`</td> 
  </tr> 
  <tr> 
   <td><code>mockLocationApp</code></td> 
   <td>设置应用程序的包标识符，该标识符自Appium 1.18.0+以来用作系统模拟位置提供程序;此功能对模拟器没有影响;如果该值设置为<code>null</code>或空字符串，则Appium将跳过模拟位置提供程序设置过程;默认为Appium设置包标识符(<code>io.appium.settings.settings</code>)</td> 
   <td>e.g., <code>null, io.appium.settings, example.your.app</code></td> 
  </tr> 
  <tr> 
   <td>logcatFormat</td> 
   <td>设置自Appium 1.18.0以来logcat消息的输出格式;<a href="https://github.com/appium/appium-adb/blob/master/lib/logcat.js" rel="nofollow">此处</a>列出了支持的格式;<a href="https://developer.android.com/studio/command-line/logcat#outputFormat" rel="nofollow"> logcat#outputFormat</a>默认<code>threadtime</code></td> 
   <td>e.g.,<code>process</code></td> 
  </tr> 
  <tr> 
   <td>logcatFilterSpecs</td> 
   <td>为Appium 1.18.0之后的logcat消息设置输出筛选规则;<a href="https://developer.android.com/studio/command-line/logcat#filteringOutput" rel="nofollow">logcat#filteringOutput</a> ,<a href="https://developer.android.com/studio/debug/am-logcat" rel="nofollow">Write and View Logs with Logcat</a></td> 
   <td>e.g., <code>['*:W', 'MyActivity:D'] (MyActivity is a tag)</code></td> 
  </tr> 
  <tr> 
   <td>allowDelayAdb</td> 
   <td>是否在emulator启动时启用<code>-delay adb</code>;默认为<code>true</code></td> 
   <td><code>true</code>, <code>false</code></td> 
  </tr> 
 </tbody> 
</table>

###### UIAutomator 1 ######

<table> 
 <thead> 
  <tr> 
   <th>Capability</th> 
   <th>Description</th> 
   <th>Values</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>intentAction</code></td> 
   <td>用于启动活动的意图操作（默认值<code>android.intent.action.MAIN</code></td> 
   <td>e.g.<code>android.intent.action.MAIN, android.intent.action.VIEW</code></td> 
  </tr> 
  <tr> 
   <td><code>intentCategory</code></td> 
   <td>将用于启动活动的意图类别（默认值<code>android.intent.category.LAUNCHER</code></td> 
   <td>e.g. <code>android.intent.category.LAUNCHER, android.intent.category.APP_CONTACTS</code></td> 
  </tr> 
  <tr> 
   <td><code>intentFlags</code></td> 
   <td>将用于启动活动的标志（默认值<code>0x10200000</code>）</td> 
   <td>e.g. <code>0x10200000</code></td> 
  </tr> 
  <tr> 
   <td><code>optionalIntentArguments</code></td> 
   <td>将用于启动活动的其他intent参数 <a href="http://developer.android.com/reference/android/content/Intent.html" rel="nofollow">Intent arguments</a></td> 
   <td>e.g.<code>--esn &lt;EXTRA_KEY&gt;, --ez &lt;EXTRA_KEY&gt; &lt;EXTRA_BOOLEAN_VALUE&gt;</code>, etc.</td> 
  </tr> 
 </tbody> 
</table>

###### UIAutomator2 Only ######

请参阅UIAutomator2驱动程序[存储库][Link 1]中有关其可用功能的文档

###### Espresso Only ######

请参阅Espresso驱动程序[存储库][Link 2]中有关其可用功能的文档

##### iOS Only #####

这些功能仅在[xguitest驱动程序][xguitest]和不推荐使用的[UIAutomation驱动程序][UIAutomation]上可用

<table> 
 <thead> 
  <tr> 
   <th>Capability</th> 
   <th>Description</th> 
   <th>Values</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>calendarFormat</code></td> 
   <td>（仅限Sim卡）要为iOS模拟器设置的日历格式</td> 
   <td>e.g. <code>gregorian</code></td> 
  </tr> 
  <tr> 
   <td><code>bundleId</code></td> 
   <td>正在测试的应用程序的捆绑包ID;用于在真实设备上启动应用程序，或用于在测试启动期间使用其他需要bundle ID的caps;要使用bundle ID在真实设备上运行测试，可以省略“app”功能，但必须提供“udid”</td> 
   <td>e.g. io.appium.TestApp</td> 
  </tr> 
  <tr> 
   <td><code>udid</code></td> 
   <td>连接的物理设备的唯一设备标识符</td> 
   <td>e.g. <code>1ae203187fc012g</code></td> 
  </tr> 
  <tr> 
   <td><code>launchTimeout</code></td> 
   <td>在假定仪器挂起并使会话失败之前等待仪器的时间量（毫秒）</td> 
   <td>e.g. <code>20000</code></td> 
  </tr> 
  <tr> 
   <td><code>locationServicesEnabled</code></td> 
   <td>（仅限Sim卡）强制打开或关闭位置服务;默认设置为保持当前sim卡设置</td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>locationServicesAuthorized</code></td> 
   <td>（仅限Sim卡）通过plist将位置服务设置为对应用程序授权或未授权，以便不会弹出位置服务警报;默认设置为保持当前sim卡设置;请注意，如果使用此设置，还必须使用<code>bundleId</code>功能发送应用程序的bundle ID</td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>autoAcceptAlerts</code></td> 
   <td>自动接受所有弹出的iOS警报;这包括隐私访问权限警报（例如，位置、联系人、照片）;默认值为false</td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>autoDismissAlerts</code></td> 
   <td>如果出现所有iOS警报，则自动关闭它们;这包括隐私访问权限警报（例如，位置、联系人、照片）;默认值为<code>false</code></td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>nativeInstrumentsLib</code></td> 
   <td>使用本机仪器库（即立即禁用仪器）</td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>nativeWebTap</code></td> 
   <td>在Safari中启用“真实的”，非基于javascript的web taps;默认值：<code>false</code>;警告：取决于视口大小/比率；这可能无法准确地点击元素</td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>safariInitialUrl</code></td> 
   <td>初始safari url，默认为本地欢迎页面</td> 
   <td>e.g. <code>https://www.github.com</code></td> 
  </tr> 
  <tr> 
   <td><code>safariAllowPopups</code></td> 
   <td>（仅限Sim卡）允许javascript在Safari中打开新窗口;默认保持当前sim卡设置</td> 
   <td>true or false</td> 
  </tr> 
  <tr> 
   <td><code>safariIgnoreFraudWarning</code></td> 
   <td>（仅限Sim卡）防止Safari显示欺诈网站警告;默认保持当前sim卡设置</td> 
   <td><code>true</code>or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>safariOpenLinksInBackground</code></td> 
   <td>（仅限Sim卡）Safari是否应允许在新窗口中打开链接;默认保持当前sim卡设置</td> 
   <td><code>true</code>or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>keepKeyChains</code></td> 
   <td>（仅限Sim卡）在appium会话启动/完成时是否保留密钥链（库/密钥链）</td> 
   <td><code>true</code> or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>localizableStringsDir</code></td> 
   <td>查找可本地化字符串的位置;默认<code>en.</code>lproj<code>|en.lproj</code></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td><code>processArguments</code></td> 
   <td>使用仪器传递给AUT的参数</td> 
   <td>e.g.,<code>-myflag</code></td> 
  </tr> 
  <tr> 
   <td><code>interKeyDelay</code></td> 
   <td>键入时发送到元素的两次击键之间的延迟，以毫秒为单位</td> 
   <td>e.g., <code>100</code></td> 
  </tr> 
  <tr> 
   <td><code>showIOSLog</code></td> 
   <td>Whether to show any logs captured from a device in the appium logs. Default <code>false</code></td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>sendKeyStrategy</code></td> 
   <td>用于在测试字段中键入测试的策略;模拟器默认值：<code>oneByOne</code>;实际设备;默认值：<code>grouped</code></td> 
   <td><code>oneByOne, grouped</code>or <code>setValue</code></td> 
  </tr> 
  <tr> 
   <td><code>screenshotWaitTimeout</code></td> 
   <td>等待生成屏幕截图的最大超时时间（秒）;默认值：<code>10</code></td> 
   <td>e.g., <code>5</code></td> 
  </tr> 
  <tr> 
   <td><code>waitForAppScript</code></td> 
   <td>ios自动化脚本用于确定应用程序是否已启动，默认情况下，系统将等待页面源不为空;结果必须是布尔值</td> 
   <td>e.g.<code>true;, target.elements().length &gt; 0;, $.delay(5000); true;</code></td> 
  </tr> 
  <tr> 
   <td><code>webviewConnectRetries</code></td> 
   <td>向远程调试器发送连接消息以获取webview的次数;默认值：<code>8</code></td> 
   <td>e.g.,<code>12</code></td> 
  </tr> 
  <tr> 
   <td><code>appName</code></td> 
   <td>正在测试的应用程序的显示名称;用于在iOS9中自动备份应用程序+</td> 
   <td>e.g., <code>UICatalog</code></td> 
  </tr> 
  <tr> 
   <td><code>customSSLCert</code></td> 
   <td>（仅限Sim卡）向IOS模拟器添加SSL证书</td> 
   <td>e.g. <code>-----BEGIN CERTIFICATE-----MIIFWjCCBEKg...-----END CERTIFICATE-----</code></td> 
  </tr> 
  <tr> 
   <td><code>webkitResponseTimeout</code></td> 
   <td>（仅限真实设备）设置在Safari会话中等待WebKit响应的时间（毫秒）;默认为<code>5000</code></td> 
   <td>e.g., <code>10000</code></td> 
  </tr> 
  <tr> 
   <td><code>remoteDebugProxy</code></td> 
   <td>（仅限Sim卡，&lt;=11.2）如果设置，Appium将通过本地端口（仅限Sim卡，&lt;=11.2）上的代理或此unix套接字（仅限Sim卡&gt;=11.3）上的代理发送和接收远程调试消息，而不是直接与iOS远程调试器通信</td> 
   <td>e.g. <code>12000</code>or <code>"/tmp/my.proxy.socket"</code></td> 
  </tr> 
  <tr> 
   <td><code>enableAsyncExecuteFromHttps</code></td> 
   <td>允许模拟器使用HTTPS在页面上执行异步JavaScript的功能。默认为<code>false</code></td> 
   <td><code>true</code> or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>skipLogCapture</code></td> 
   <td>跳过以开始捕获日志，如崩溃、系统、safari控制台和safari网络;它可能会提高性能，如网络;与日志相关的命令将不起作用;默认为<code>false</code></td> 
   <td><code>true</code> or<code>false</code></td> 
  </tr> 
  <tr> 
   <td><code>webkitDebugProxyPort</code></td> 
   <td>（仅限实际设备）连接端口<code>ios-webkit-debug-proxy</code>是连通的，调试代理连接到的端口;默认值为<code>27753</code></td> 
   <td><code>12021</code></td> 
  </tr> 
  <tr> 
   <td><code>fullContextList</code></td> 
   <td>返回<a href="http://appium.io/docs/en/commands/context/get-contexts/index.html" rel="nofollow">get available context</a>命令上下文的详细信息;如果启用了这个功能，那么返回的contexts列表中的每一项都将另外包括WebView标题、完整URL和bundle标识符;默认为<code>false</code></td> 
   <td><code>true</code> or <code>false</code></td> 
  </tr> 
 </tbody> 
</table>

###### iOS Only, using XCUITest ######

Please refer to the documentation on the XCUITest driver [repository][] about its available capabilities.

###### Safaridriver Only ######

Please refer to the documentation on the safaridriver [repository][] about its available capabilities.

###### Geckodriver Only ######

Please refer to the documentation on the geckodriver [repository][repository 1] about its available capabilities.

###### MacDriver Only ######

Please refer to the documentation on the MacDriver [repository][repository 2] about its available capabilities.

###### Mac2Driver Only ######

Please refer to the documentation on the Mac2Driver [repository][repository 3] about its available capabilities.

###### You.i Engine Only ######

Please refer to the documentation on the You.i Engine driver [repository][repository 4] about its available capabilities.

###### WinAppDriver Only ######

Please refer to the documentation on the Appium Windows Diver [repository][repository 5] about its available capabilities.

###### Flutter driver only ######

Please refer to the documentation on the Flutter Diver [repository][repository 6] about its available capabilities.

[Link 1]: https://github.com/appium/appium-uiautomator2-driver#capabilities
[Link 2]: https://github.com/appium/appium-espresso-driver#capabilities
[xguitest]: http://appium.io/docs/en/drivers/ios-xcuitest/index.html
[UIAutomation]: http://appium.io/docs/en/drivers/ios-uiautomation/index.html
[repository]: https://github.com/appium/appium-safari-driver
[repository 1]: https://github.com/appium/appium-geckodriver
[repository 2]: https://github.com/appium/appium-mac-driver#desired-capabilities
[repository 3]: https://github.com/appium/appium-mac2-driver#capabilities
[repository 4]: https://github.com/YOU-i-Labs/appium-youiengine-driver#desired-capabilities
[repository 5]: https://github.com/appium/appium-windows-driver#windowsdriver-specific-capabilities
[repository 6]: https://github.com/truongsinh/appium-flutter-driver#desired-capabilities-for-flutter-driver-only