Appium Desired Capabilities
Desired Capabilities 是由 keys 和 values 組成的 JSON 對象。
舉個簡單例子:
{
“platformName”: “iOS”,
“platformVersion”: “11.0”,
“deviceName”: “iPhone 7”,
“automationName”: “XCUITest”,
“app”: “/path/to/my.app”
}
基本參數
參數 描述 實例
automationName 自動化測試引擎 Appium或 Selendroid
platformName 手機操作系統 iOS, Android, 或 FirefoxOS
platformVersion 手機操作系統版本 如： 7.1, 4.4；ios的 9.0
deviceName 手機或模擬器設備名稱 android的忽略，ios如iPhone Simulator
app .ipa .apk文件路徑 比如/abs/path/to/my.apk或http://myapp.com/app.ipa
browserName 啓動手機瀏覽器 iOS如:Safari，Android如:Chrome,Chromium,Browser
newCommandTimeout 設置命令超時時間，單位：秒。 比如 60
autoLaunch Appium是否需要自動安裝和啓動應用。默認值true true, false
language (Sim/Emu-only) 設定模擬器 ( simulator / emulator ) 的語言。 如： fr
locale (Sim/Emu-only) 設定模擬器 ( simulator / emulator ) 的區域設置。 如： fr_CA
udid ios真機的唯一設備標識 如： 1ae203187fc012g
orientation 設置橫屏或豎屏 LANDSCAPE (橫向) 或 PORTRAIT (縱向)
autoWebview 直接轉換到 WebView 上下文。 默認值 false、 true, false
noReset 不要在會話前重置應用狀態。默認值false。 true, false
fullReset (iOS) 刪除整個模擬器目錄。(Android)通過卸載默認值 false true, false
Android特有
關鍵字 描述 實例
appActivity 啓動app包,一般點開頭 如：.MainActivity, .Settings
appPackage Android應用的包名 比如com.example.android.myApp
appWaitActivity 等待啓動的Activity名稱 SplashActivity
deviceReadyTimeout 設置超時時間 5
androidCoverage 用於執行測試的 instrumentation類 com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation
enablePerformanceLogging (僅適用於 Chrome 和 webview) 開啓 Chromedriver 的性能日誌。(默認 false) true, false
androidDeviceReadyTimeout 等待設備在啓動應用後超時時間，單位秒 如 30
androidDeviceSocket 開發工具的 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 or false
keystorePath 自定義keystore路徑。默認~/.android/debug.keystore 如 /path/to.keystore
keystorePassword 自定義 keystore 的密碼。 如 foo
keyAlias key 的別名 如 androiddebugkey
keyPassword key 的密碼 如 foo
chromedriverExecutable webdriver可執行文件的絕對路徑 應該用它代替Appium 自帶的 webdriver) /abs/path/to/webdriver
autoWebviewTimeout 毫秒爲單位，Webview上下文激活的時間。默認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 啓動應用時不要停止被測應用的進程。默認值： false true 或 false
unicodeKeyboard 使用 Unicode 輸入法。默認值 false true 或 false
resetKeyboard 重置輸入法到原有狀態，默認值 false true 或 false
noSign 跳過檢查和對應用進行 debug 簽名的步驟。默認值 false true 或 false
ignoreUnimportantViews 調用 uiautomator 的函數這個關鍵字能加快測試執行的速度。默認值 false true 或 false
disableAndroidWatchers 關閉 android 監測應用無響ANR和崩潰crash的監視器默認值： false。 true 或者 false
chromeOptions 允許傳入 chrome driver 使用的 chromeOptions 參數。請查閱 chromeOptions 瞭解更多信息。 chromeOptions: {args: [‘–disable-popup-blocking‘]}
iOS特有
關鍵字 描述 實例
calendarFormat (Sim-only) 爲iOS的模擬器設置日曆格式 如 gregorian (公曆)
bundleId 被測應用的bundle ID，真機上執行測試時，你可以不提供 app 關鍵字，但你必須提供udid 如 io.appium.TestApp
udid 連接真機的唯一設備編號 ( Unique device identifier ) 如 1ae203187fc012g
launchTimeout 以毫秒爲單位，在Appium運行失敗之前設置一個等待 instruments的時間 比如： 20000
locationServicesEnabled (Sim-only) 強制打開或關閉定位服務。默認值是保持當前模擬器的設定 true 或 false
locationServicesAuthorized 使用這個關鍵字時，你同時需要使用 bundleId 關鍵字來發送你的應用的 bundle ID。 true 或者 false
autoAcceptAlerts 當 iOS 的個人信息訪問警告 (如 位置、聯繫人、圖片) 出現時，自動選擇接受( Accept )。默認值 false。 true 或者 false
autoDismissAlerts 當 iOS 的個人信息訪問警告 (如 位置、聯繫人、圖片) 出現時，自動選擇不接受( Dismiss )。默認值 false。 true 或者 false
nativeInstrumentsLib 使用原生 intruments 庫 (即關閉 instruments-without-delay ) true 或者 false
nativeWebTap (Sim-only) 在Safari中允許"真實的"，默認值： false。注意：取決於 viewport 大小/比例， 點擊操作不一定能精確地點中對應的元素。 true 或者 false
safariInitialUrl (Sim-only) (>= 8.1) Safari 的初始地址。默認值是一個本地的歡迎頁面 例如： https://www.github.com
safariAllowPopups (Sim-only) 允許 javascript 在 Safari 中創建新窗口。默認保持模擬器當前設置。 true 或者 false
safariIgnoreFraudWarning (Sim-only) 阻止 Safari 顯示此網站可能存在風險的警告。默認保持瀏覽器當前設置。 true 或者 false
safariOpenLinksInBackground (Sim-only) Safari 是否允許鏈接在新窗口打開。默認保持瀏覽器當前設置。 true 或者 false
keepKeyChains (Sim-only) 當 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;