Appium Desired Capabilities詳解

本文轉載自查看原文 2020-05-14 21:11 859 Appium+robotframework框架問題小結及總結

Desired Capabilities 是由 keys 和 values 組成的 JSON 對象。

舉個簡單例子:

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


或：

{
    "platformName": "ANDROID", "platformVersion": "7.0", "deviceName": "ANDROID", "appPackage":"75b77ec u0 com.taobao.taobao"
 "appActivity":"com.taobao.browser.BrowserActivity"
 "app": "*******.apk"



我用的是robotframework框架，顯示的是：

Open Application http://127.0.0.1:4723/wd/hub platformName=Android platformVersion=10 deviceName=6HJC18033 appPackage=com.tencent.qqmusic appActivity=com.tencent.qqmusic.activity.AppStarterActivity unicodeKeyboard=True resetKeyboard=True
sleep 20

基本參數

參數	描述	實例
`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;`