appiumdesired_caps參數(shù)大全

automationName

使用哪個自動化引擎

Appium（默認(rèn)）或Selendroid或者UiAutomator2或者Espresso對于Android或XCUITestiOS或者YouiEngine使用You.i引擎構(gòu)建的應(yīng)用程序

platformName

使用哪個移動操作系統(tǒng)平臺

iOS，Android或FirefoxOS

platformVersion

移動操作系統(tǒng)版本

例如7.1，4.4

deviceName

使用的移動設(shè)備或模擬器的種類

iPhone Simulator，iPad Simulator，iPhone Retina 4-inch，Android Emulator，Galaxy S4，等....在iOS上，這應(yīng)該是與儀器返回的有效設(shè)備之一instruments -s devices。在Android上，這個功能目前被忽略，盡管它仍然是必需的。

app

一個或一個文件的絕對本地路徑或遠(yuǎn)程http URL ，或者包含其中的一個。Appium將首先嘗試在適當(dāng)?shù)脑O(shè)備上安裝這個應(yīng)用程序二進(jìn)制文件。請注意，如果您指定和功能（請參閱下文），則此功能對于Android不是必需的。與...不兼容。.ipa.apk.zipappPackageappActivitybrowserName

/abs/path/to/my.apk 要么http://myapp.com/app.ipa

browserName

移動網(wǎng)頁瀏覽器的名稱自動化。應(yīng)該是一個空字符串，而不是自動化應(yīng)用程序。

適用于iOS的“Safari”，適用于Android的“Chrome”，“Chromium”或“瀏覽器”

newCommandTimeout

在假定客戶端退出并結(jié)束會話之前，Appium將等待來自客戶端的新命令（以秒為單位）

例如 60

language

（Sim / Emu-only）為模擬器/仿真器設(shè)置的語言

例如 fr

locale

（Sim / Emu-only）為模擬器/仿真器設(shè)置的語言環(huán)境

例如 fr_CA

udid

連接的物理設(shè)備的唯一設(shè)備標(biāo)識符

例如 1ae203187fc012g

orientation

（Sim / Emu-only）從某個方向開始

LANDSCAPE 要么 PORTRAIT

autoWebview

直接進(jìn)入Webview上下文。默認(rèn)false

true， false

noReset

在此會話之前不要重置應(yīng)用程序狀態(tài)。在這里看到更多的細(xì)節(jié)

true， false

fullReset

執(zhí)行完整的重置。在這里看到更多的細(xì)節(jié)

true， false

eventTimings

啟用或禁用各種Appium內(nèi)部事件的時間報告（例如，每個命令的開始和結(jié)束等）。默認(rèn)為false。啟用，使用true。然后將這些時間作為events回應(yīng)查詢當(dāng)前會話的財產(chǎn)報告。請參閱事件時間文檔了解此響應(yīng)的結(jié)構(gòu)。

例如， true

enablePerformanceLogging

（僅限Web和webview）啟用Chromedriver（在Android上）或Safari（在iOS上）性能記錄（默認(rèn)false）

true， false

appActivity

要從包中啟動的Android活動的活動名稱。這往往需要在一個.（例如，.MainActivity而不是MainActivity）

MainActivity， .Settings

appPackage

你想運行的Android應(yīng)用程序的Java包

com.example.android.myApp， com.android.settings

appWaitActivity

活動名稱/名稱，逗號分隔，您想要等待的Android活動

SplashActivity，SplashActivity,OtherActivity，*，*.SplashActivity

appWaitPackage

您想等待的Android應(yīng)用程序的Java包

com.example.android.myApp， com.android.settings

appWaitDuration

用于等待appWaitActivity啟動的超時（以毫秒為單位20000）（默認(rèn)）

30000

deviceReadyTimeout

在等待設(shè)備準(zhǔn)備就緒的幾秒鐘內(nèi)超時

5

androidCoverage

完全合格的儀器類。通過-w在adb shell中，儀器-e覆蓋率為true -w

com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation

androidCoverageEndIntent

由您自己執(zhí)行的廣播操作，用于將覆蓋轉(zhuǎn)儲到文件系統(tǒng)。傳遞到-a在adb外殼廣播-a

com.example.pkg.END_EMMA

androidDeviceReadyTimeout

用于等待設(shè)備在啟動后準(zhǔn)備就緒的秒數(shù)

例如， 30

androidInstallTimeout

用于等待apk安裝到設(shè)備的超時（以毫秒為單位）。默認(rèn)為90000

例如， 90000

androidInstallPath

安裝前將在其中安裝apk的設(shè)備上的目錄名稱。默認(rèn)為/data/local/tmp

例如 /sdcard/Downloads/

adbPort

用于連接到ADB服務(wù)器的端口（默認(rèn)5037）

5037

remoteAdbHost

可選的遠(yuǎn)程ADB服務(wù)器主機

例如：192.168.0.101

androidDeviceSocket

Devtools套接字名稱。只有當(dāng)測試的應(yīng)用程序是Chromium嵌入式瀏覽器時才需要。套接字由瀏覽器打開，并且Chromedriver作為devtools客戶端連接到它。

例如， chrome_devtools_remote

avd

avd的名稱發(fā)射

例如， api19

avdLaunchTimeout

avd啟動并連接到ADB需要多長時間（默認(rèn)值120000）

300000

avdReadyTimeout

avd完成啟動動畫需要多長時間（默認(rèn)120000）

300000

avdArgs

啟動avd時使用的其他仿真器參數(shù)

例如， -netfast

useKeystore

使用自定義密鑰庫來簽署apks，默認(rèn) false

true 要么 false

keystorePath

自定義密鑰庫路徑，默認(rèn)?/ .android / debug.keystore

例如， /path/to.keystore

keystorePassword

自定義密鑰庫的密碼

例如， foo

keyAlias

密鑰的別名

例如， androiddebugkey

keyPassword

密鑰的密鑰

例如， foo

chromedriverExecutable

webdriver可執(zhí)行文件的絕對本地路徑（如果Chromium embedder提供了自己的webdriver，則應(yīng)該使用它來代替與Appium捆綁在一起的原始chromedriver）

/abs/path/to/webdriver

autoWebviewTimeout

等待Webview上下文激活的時間（以毫秒為單位）。默認(rèn)為2000

例如 4

intentAction

意圖操作將用于啟動活動（默認(rèn)android.intent.action.MAIN）

例如android.intent.action.MAIN，android.intent.action.VIEW

intentCategory

意圖類別，將用于啟動活動（默認(rèn)android.intent.category.LAUNCHER）

例如android.intent.category.LAUNCHER，android.intent.category.APP_CONTACTS

intentFlags

將用于啟動活動的標(biāo)志（默認(rèn)0x10200000）

例如 0x10200000

optionalIntentArguments

將用于啟動活動的其他意圖參數(shù)。請參閱意向參數(shù)

例如--esn <EXTRA_KEY>，--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>等等。

dontStopAppOnReset

在使用adb啟動應(yīng)用程序之前，不要停止被測試的應(yīng)用程序的進(jìn)程。如果被測試的應(yīng)用程序是由另一個定位應(yīng)用程序創(chuàng)建的，那么將其設(shè)置為false將允許在使用adb的測試應(yīng)用程序啟動過程中定位應(yīng)用程序的過程仍然存在。換句話說，在dontStopAppOnReset設(shè)置的時候true，我們不會-S在adb shell am start通話中包含標(biāo)志。有了這個能力被省略或設(shè)置為false，我們包括-S標(biāo)志。默認(rèn)false

true 要么 false

unicodeKeyboard

啟用Unicode輸入，默認(rèn) false

true 要么 false

resetKeyboard

使用unicodeKeyboard功能運行Unicode測試后，將鍵盤重置為原始狀態(tài)。如果單獨使用，則忽略。默認(rèn)false

true 要么 false

noSign

使用調(diào)試鍵跳過檢查和簽名應(yīng)用程序，只能使用UiAutomator，而不能使用selendroid，默認(rèn)false

true 要么 false

ignoreUnimportantViews

調(diào)用setCompressedLayoutHierarchy()uiautomator函數(shù)。此功能可以加快測試執(zhí)行速度，因為輔助功能命令將更快地忽略某些元素。被忽略的元素是不可能找到的，這就是為什么這個功能也被實現(xiàn)為可切換的設(shè)置以及功能。默認(rèn)為false

true 要么 false

disableAndroidWatchers

禁用觀察應(yīng)用程序沒有響應(yīng)和應(yīng)用程序崩潰的android觀察者，這將減少Android設(shè)備/模擬器上的CPU使用率。這個功能只能用于UiAutomator，而不能用于selendroid，默認(rèn)false

true 要么 false

chromeOptions

允許ChromeDriver傳遞chromeOptions功能。有關(guān)更多信息，請參閱chromeOptions

chromeOptions: {args: ['--disable-popup-blocking']}

recreateChromeDriverSessions

在移至非ChromeDriver網(wǎng)頁瀏覽的情況下殺死ChromeDriver會話。默認(rèn)為false

true 要么 false

nativeWebScreenshot

在Web上下文中，使用本地（adb）方法截取屏幕截圖，而不是代理ChromeDriver。默認(rèn)為false

true 要么 false

androidScreenshotPath

將要放置屏幕截圖的設(shè)備上的目錄名稱。默認(rèn)為/data/local/tmp

例如 /sdcard/screenshots/

autoGrantPermissions

讓Appium自動確定您的應(yīng)用程序需要哪些權(quán)限，并在安裝時將其授予應(yīng)用程序。默認(rèn)為false

true 要么 false

networkSpeed

設(shè)置網(wǎng)絡(luò)速度模擬。指定最大的網(wǎng)絡(luò)上傳和下載速度。默認(rèn)為full

['full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo']檢查-netspeed選項有關(guān)avds速度仿真的更多信息

gpsEnabled

在開始會話之前，切換模擬器的gps位置提供程序。默認(rèn)情況下，仿真器將根據(jù)設(shè)置的方式啟用或不啟用此選項。

true 要么 false

isHeadless

true當(dāng)不需要顯示設(shè)備顯示時，將此功能設(shè)置為無運行模擬器。false是默認(rèn)值。isHeadless也支持iOS，請檢查XCUITest的具體功能。

例如， true

calendarFormat

（僅限SIM）為iOS模擬器設(shè)置的日歷格式

例如 gregorian

bundleId

測試中的應(yīng)用程序的捆綁ID。用于在真實設(shè)備上啟動應(yīng)用程序或在測試啟動期間使用其他需要包ID的大寫字母。要使用軟件包ID在真實設(shè)備上運行測試，可以省略“應(yīng)用”功能，但必須提供“udid”。

例如 io.appium.TestApp

udid

連接的物理設(shè)備的唯一設(shè)備標(biāo)識符

例如 1ae203187fc012g

launchTimeout

假設(shè)它掛起和失敗會話之前以毫秒為單位等待儀器的時間

例如 20000

locationServicesEnabled

（僅限SIM）強制定位服務(wù)處于打開或關(guān)閉狀態(tài)。默認(rèn)是保持當(dāng)前的模擬設(shè)置。

true 要么 false

locationServicesAuthorized

（僅限SIM）通過plist將位置服務(wù)設(shè)置為授權(quán)或未授權(quán)，以便位置服務(wù)警報不會彈出。默認(rèn)是保持當(dāng)前的模擬設(shè)置。請注意，如果您使用此設(shè)置，您還必須使用該bundleId功能發(fā)送您的應(yīng)用的捆綁ID。

true 要么 false

autoAcceptAlerts

如果彈出，則自動接受所有iOS警報。這包括隱私訪問權(quán)限提醒（例如，位置，聯(lián)系人，照片）。默認(rèn)是false。不適用于XCUITest基于測試。

true 要么 false

autoDismissAlerts

如果彈出，則自動關(guān)閉所有iOS警報。這包括隱私訪問權(quán)限提醒（例如，位置，聯(lián)系人，照片）。默認(rèn)是false。不適用于XCUITest基于測試。

true 要么 false

nativeInstrumentsLib

使用本機intruments lib（即禁用儀器，無延遲）。

true 要么 false

nativeWebTap

（僅限SIM）在Safari中啟用“真實”，非基于JavaScript的網(wǎng)頁瀏覽。默認(rèn)：false。警告：根據(jù)視口的大小/比例，這可能無法準(zhǔn)確地點擊一個元素

true 要么 false

safariInitialUrl

（僅限SIM）（> = 8.1）初始Safari瀏覽器網(wǎng)址，默認(rèn)為本地歡迎頁面

例如 https://www.github.com

safariAllowPopups

（僅限Sim）允許JavaScript在Safari中打開新窗口。默認(rèn)保持當(dāng)前的模擬設(shè)置

true 要么 false

safariIgnoreFraudWarning

（僅限SIM）防止Safari顯示欺詐網(wǎng)站警告。默認(rèn)保持當(dāng)前的模擬設(shè)置。

true 要么 false

safariOpenLinksInBackground

（僅限SIM）Safari是否應(yīng)允許在新窗口中打開鏈接。默認(rèn)保持當(dāng)前的模擬設(shè)置。

true 要么 false

keepKeyChains

（Sim-only）當(dāng)appium會話開始/結(jié)束時是否保留鑰匙串（Library / Keychains）

true 要么 false

localizableStringsDir

在哪里尋找可本地化的字符串。默認(rèn)en.lproj

en.lproj

processArguments

使用工具傳遞給AUT的參數(shù)

例如， -myflag

interKeyDelay

輸入時發(fā)送到元素的擊鍵之間的延遲，以毫秒為單位。

例如， 100

showIOSLog

是否顯示從appium日志中的設(shè)備捕獲的任何日志。默認(rèn)false

true 要么 false

sendKeyStrategy

用于將測試類型輸入測試領(lǐng)域的策略。模擬器默認(rèn)：oneByOne。實際設(shè)備默認(rèn)值：grouped

oneByOne，grouped或者setValue

screenshotWaitTimeout

以秒為單位的最大超時等待生成屏幕截圖。默認(rèn)：10

例如， 5

waitForAppScript

ios自動化腳本用于確定應(yīng)用程序是否已啟動，默認(rèn)情況下系統(tǒng)等待頁面源不為空。結(jié)果必須是布爾值

例如true;，target.elements().length > 0;，$.delay(5000); true;

webviewConnectRetries

向遠(yuǎn)程調(diào)試器發(fā)送連接消息以獲取webview的次數(shù)。默認(rèn)：8

例如， 12

appName

被測應(yīng)用程序的顯示名稱。用于在iOS 9+中自動化后臺應(yīng)用程序。

例如， UICatalog

customSSLCert

（僅限Sim / Emu）向模擬器添加SSL證書。

例如 
-----BEGIN CERTIFICATE-----MIIFWjCCBEKg...
-----END CERTIFICATE-----

webkitResponseTimeout

（僅限實際設(shè)備）設(shè)置時間（以毫秒為單位）以等待Safari會話中WebKit的響應(yīng)。默認(rèn)為5000

例如， 10000