Capabilities介紹
實際上它的全稱是:Desired capabilities
Desired capability是一個JSON對象,包含一組key和value值。它由客戶端發送給服務端,告訴服務端期望的Capabilities(可以理解為一種能力)有哪些,然后服務端根據這些capabilities創建自動化會話(session)
初始化參數詳解
·AUTOMATION_NAME:
DesiredCapabilities caps = new DesiredCapabilities();
//設置設備號
caps.setCapability(MobileCapabilityType.AUTOMATION_NAME,"Selendroid");
iOS無需進行這個設置,默認就是Appium引擎。
·platformName
定義測試平台的名字,通常用於移動設備。值有:Android、iOS和FirefoxOS。
使用代碼如下:
caps.setCapability("platformName","Android");
在使用的過程中,請按照實際平台來填寫即可。
·platformVersion
測試平台版本,移動設備固件的版本號,比如:iOS的7.1.1,9.3等,Android的4.4.2、5.1.1等。設置代碼:
caps.setCapability("platformVersion","4.4.4");
還是請按照實際版本號來填寫。
·deviceName
移動設備的名字,比如iPhone 5s、Google Nexus等,設置代碼:
caps.setCapability("deviceName", "Nexus 5");
·app
蘋果app或者安卓app的路徑,可以是本地的絕對路徑,也可以是遠程網絡路徑,只要有訪問權限即可。根據這個app capabilities,Appium會在啟動測試之前安裝好app到設備。在測試安卓的時候,appPackage 和appActivity也需要設置,和app搭配使用。appPackage 和appActivity是安卓獨有的capabilities
設置方式:
caps.setCapability("app","/apps/demo/demo.apk 或者 http://app.com/app.ipa");
·browserName
如果你想測試web app,那么你就需要定義browserName。對於Android來說,你可能會一定chrome瀏覽器,設置代碼:
caps.setCapability("browserName", "Chrome");
對於iOS來說你可能要定義Safari瀏覽器
·newCommandTimeout
為了結束appium會話(session),appium會設置一個等待從客戶端發送命令超時的時間。默認時間是60秒,如果你不進行設置,如果你需要設置,代碼如下:
caps.setCapability("newCommandTimeout", "30");
·autoLaunch
設置設個capability,會自動安裝app並且啟動app。設置代碼為:
caps.setCapability("autoLaunch","false");
·autoWebview
如果你測試的是混合應用並且想直接進入webview內容中,那么你需要設置設置這個capability的值為true,代碼如下:
caps.setCapability("autoWebview", "true");
更多的capabilities可以參考這里:
https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md
Android獨有Capabilities
·appPackage
設置安卓app的包名的capability,告訴appium你要運行哪個app。
設置代碼為:
caps.setCapability("appPackage", "com.android.calculator2");
·appActivity
設置你想要運行的app的activity(相當於一個界面或者理解成網頁),比如:LoginActivity,登錄的activity,可以理解為登錄界面。
設置代碼為:
caps.setCapability("appActivity", "com.xxx.xxx.LoginActivity ");
·appWaitActivity
設置你想要等待的android activity,設置方式為:
caps.setCapability("appWaitActivity","com.android.calculator2.Calculator");
·appWaitPackage
需要等待的app的包,設置方法:
caps.setCapability("appWaitPackage","com.example.android.myApp");
·unicodeKeyboard
是否使用unicode鍵盤輸入,如果設置為true,那么可以輸入中文和特殊字符,這個很常用,一般設置為true。設置代碼為:
caps.setCapability("unicodeKeyboard","true");
·resetKeyboard
是否重置鍵盤為原始狀態,比如你將鍵盤設置為了unicode鍵盤,當用例執行完成之后,將resetKeyboard設置為true,則鍵盤重置為原始狀態。設置代碼為:
caps.setCapability("resetKeyboard","true");
以上只選了幾個代表性的capability,更多的capability請參考:
https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md