--shell |
null |
進入 REPL 模式 |
|
--localizable-strings-dir |
en.lproj |
IOS only: 定位 .strings所在目錄的相對路徑 |
--localizable-strings-dir en.lproj |
--app |
null |
iOS: 基於模擬器編譯的 app 的絕對路徑或者裝置目標的 bundle_id; Android: apk 檔案的絕對路徑--app /abs/path/to/my.app |
|
--ipa |
null |
(IOS-only) .ipa 檔案的絕對路徑 |
--ipa /abs/path/to/my.ipa |
-U , --udid |
null |
串連物理裝置的唯一裝置標識符 |
--udid 1adsf-sdfas-asdf-123sdf |
-a , --address |
0.0.0.0 |
監聽的 ip 地址 |
--address 0.0.0.0 |
-p , --port |
4723 |
監聽的連接埠 |
--port 4723 |
-ca , --callback-address |
null |
回調IP地址 (預設: 相同的IP地址) |
--callback-address 127.0.0.1 |
-cp , --callback-port |
null |
回調連接埠號碼 (預設: 相同的連接埠號碼) |
--callback-port 4723 |
-bp , --bootstrap-port |
4724 |
(Android-only) 串連裝置的連接埠號碼 |
--bootstrap-port 4724 |
-k , --keep-artifacts |
false |
棄用,無效。trace資訊現在保留tmp目錄下,每次運行前會清除該目錄中的資訊。 也可以參考 –trace-dir 。 |
|
-r , --backend-retries |
3 |
(iOS-only) 遇到 crash 或者 逾時,Instrument 重新啟動的次數。 |
--backend-retries 3 |
--session-override |
false |
允許 session 被覆蓋 (衝突的話) |
|
--full-reset |
false |
(iOS) 刪除整個模擬器目錄。 (Android) 通過卸載應用(而不是清除資料)重設應用狀態。在 Android 上,session 完成後也會刪除應用。 |
|
--no-reset |
false |
session 之間不重設應用狀態 (iOS: 不刪除應用的 plist 檔案; Android: 在建立一個新的 session 前不刪除應用。) |
|
-l , --pre-launch |
false |
在第一個 session 前,開機前應用 (iOS 需要 –app 參數,Android 需要 –app-pkg 和 –app-activity) |
|
-lt , --launch-timeout |
90000 |
(iOS-only) 等待 Instruments 啟動的時間 |
|
-g , --log |
null |
將日誌輸出到指定檔案 |
--log /path/to/appium.log |
--log-level |
debug |
記錄層級; 預設 (console[:file]): debug[:debug] |
--log-level debug |
--log-timestamp |
false |
在終端輸出裡顯示時間戳記 |
|
--local-timezone |
false |
使用本地時間戳記 |
|
--log-no-colors |
false |
不在終端輸出中顯示顏色 |
|
-G , --webhook |
null |
同時發送日誌到 HTTP 監聽器 |
--webhook localhost:9876 |
--native-instruments-lib |
false |
(IOS-only) iOS 內建了一個怪異的不可能避免的延遲。我們在 Appium 裡修複了它。如果你想用原來的,你可以使用這個參數。 |
|
--app-pkg |
null |
(Android-only) 你要啟動並執行apk的java包。 (例如, com.example.android.myApp) |
--app-pkg com.example.android.myApp |
--app-activity |
null |
(Android-only) 開啟應用時,啟動的 Activity 的名字(比如, MainActivity) |
--app-activity MainActivity |
--app-wait-package |
false |
(Android-only) 你想等待的 Activity 的包名。(比如, com.example.android.myApp) |
--app-wait-package com.example.android.myApp |
--app-wait-activity |
false |
(Android-only) 你想等待的 Activity 名字(比如, SplashActivity) |
--app-wait-activity SplashActivity |
--android-coverage |
false |
(Android-only) 完全合格 instrumentation 類。 作為命令 adb shell am instrument -e coverage true -w 的 -w 的參數 |
--android-coverage com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation |
--avd |
null |
(Android-only) 要啟動的 avd 的名字 |
|
--avd-args |
null |
(Android-only) 添加額外的參數給要啟動avd |
--avd-args -no-snapshot-load |
--device-ready-timeout |
5 |
(Android-only) 等待裝置準備好的時間,以秒為單位 |
--device-ready-timeout 5 |
--safari |
false |
(IOS-Only) 使用 Safari 應用 |
|
--device-name |
null |
待使用的行動裝置名字 |
--device-name iPhone Retina (4-inch), Android Emulator |
--platform-name |
null |
移動平台的名稱: iOS, Android, or FirefoxOS |
--platform-name iOS |
--platform-version |
null |
移動平台的版本 |
--platform-version 7.1 |
--automation-name |
null |
自動化工具的名稱: Appium or Selendroid |
--automation-name Appium |
--browser-name |
null |
行動瀏覽器的名稱: Safari or Chrome |
--browser-name Safari |
--default-device , -dd |
false |
(IOS-Simulator-only) 使用instruments自己啟動的預設模擬器 |
|
--force-iphone |
false |
(IOS-only) 無論應用要用什麼模擬器,強制使用 iPhone 模擬器 |
|
--force-ipad |
false |
(IOS-only) 無論應用要用什麼模擬器,強制使用 iPad 模擬器 |
|
--language |
null |
iOS / Android 模擬器的語言 |
--language en |
--locale |
null |
Locale for the iOS simulator / Android Emulator |
--locale en_US |
--calendar-format |
null |
(IOS-only) iOS 模擬器的日曆格式 |
--calendar-format gregorian |
--orientation |
null |
(IOS-only) 初始化請求時,使用 LANDSCAPE (橫屏) 或者 PORTRAIT (豎屏) |
--orientation LANDSCAPE |
--tracetemplate |
null |
(IOS-only) 指定 Instruments 使用的 tracetemplate 檔案 |
--tracetemplate /Users/me/Automation.tracetemplate |
--show-sim-log |
false |
(IOS-only) 如果設定了, iOS 模擬器的日誌會寫到終端上來 |
|
--show-ios-log |
false |
(IOS-only) 如果設定了, iOS 系統的日誌會寫到終端上來 |
|
--nodeconfig |
null |
指定 JSON 格式的設定檔 ,用來在 selenium grid 裡註冊 appiumd |
--nodeconfig /abs/path/to/nodeconfig.json |
-ra , --robot-address |
0.0.0.0 |
robot 的 ip 地址 |
--robot-address 0.0.0.0 |
-rp , --robot-port |
-1 |
robot 的連接埠地址 |
--robot-port 4242 |
--selendroid-port |
8080 |
用來和 Selendroid 互動的本地連接埠 |
--selendroid-port 8080 |
--chromedriver-port |
9515 |
ChromeDriver啟動並執行連接埠 |
--chromedriver-port 9515 |
--chromedriver-executable |
null |
ChromeDriver 可執行檔的完整路徑 |
|
--use-keystore |
false |
(Android-only) 設定簽名 apk 的 keystore |
|
--keystore-path |
(Android-only) keystore 的路徑 |
|
|
--keystore-password |
android |
(Android-only) keystore 的密碼 |
|
--key-alias |
androiddebugkey |
(Android-only) Key 的別名 |
|
--key-password |
android |
(Android-only) Key 的密碼 |
|
--show-config |
false |
列印 Appium 伺服器的配置資訊,然後退出 |
|
--no-perms-check |
false |
跳過Appium對是否可以讀/寫必要檔案的檢查 |
|
--command-timeout |
60 |
預設所有會話的接收命令逾時時間 (在逾時時間內沒有接收到新命令,自動關閉會話)。 會被新的逾時時間覆蓋 |
|
--keep-keychains |
false |
(iOS) 當 Appium 啟動或者關閉的時候,是否保留 keychains (Library/Keychains) |
|
--strict-caps |
false |
如果所選裝置是appium不承認的有效裝置,會導致會話失敗 |
|
--isolate-sim-device |
false |
Xcode 6存在一個bug,那就是一些平台上如果其他模擬器裝置先被刪除時某個特定的模擬器只能在沒有任何錯誤的情況下被建立。這個選項導致了Appium不得不刪除除了正在使用裝置以外其他所有的裝置。請注意這是永久性刪除,你可以使用simctl或xcode管理被Appium使用的裝置類別。 |
|
--tmp |
null |
可以被Appium用來管理臨時檔案的目錄(絕對路徑),比如存放需要移動的內建iOS應用程式。 預設的變數為 APPIUM_TMP_DIR ,在 *nix/Mac 為 /tmp 在windows上使用環境便令 TEMP 設定的目錄。 |
|
--trace-dir |
null |
用於儲存iOS instruments trace的 appium 目錄,是絕對路徑, 預設為 /appium-instruments |
|
--intent-action |
android.intent.action.MAIN |
(Android-only) 用於啟動 activity 的intent action |
--intent-action android.intent.action.MAIN |
--intent-category |
android.intent.category.LAUNCHER |
(Android-only) 用於啟動 activity 的intent category |
--intent-category android.intent.category.APP_CONTACTS |
--intent-flags |
0x10200000 |
(Android-only) 啟動 activity 的標誌 |
--intent-flags 0x10200000 |
--intent-args |
null |
(Android-only) 啟動 activity 時附帶額外的 intent 參數 |
--intent-args 0x10200000 |
--suppress-adb-kill-server |
false |
(Android-only) 如果被設定,阻止Appium殺掉adb執行個體。 |