1.Capabilities介紹
可以看下之前代碼里面設置的capabilities
DesiredCapabilities capabilities =newDesiredCapabilities();
capabilities.setCapability("automationName", "Appium");
capabilities.setCapability("platformName","Android");
capabilities.setCapability("deviceName","Android Emulator");
capabilities.setCapability("platformVersion", "4.4.2");
capabilities.setCapability("app", app.getAbsolutePath());
capabilities.setCapability("appPackage", "com.example.android.contactmanager");
capabilities.setCapability("appActivity", ".ContactManager");
Desired capability是一個JSON對象,包含一組key和value值。它由客戶端發送給服務端,告訴服務端期望的Capabilities(可以理解為一種能力)有哪些,然后服務端根據這些capabilities創建自動化會話(session)。
DesiredCapabilities位于這個包中:
importorg.openqa.Selenium.remote.DesiredCapabilities
所以在使用DesiredCapabilities的時候需要先導入這個類。
2.通用Capabilities
.automationName
這個capability主要是定義測試引擎。當你在安卓平臺上進行測試的時候,你需要確認你使用的android sdk版本,如果是小于17的話,你需要指定測試引擎為:Selendroid。如果大于等于17,你需要使用的引擎是:Appium,默認就是Appium測試引擎。具體使用代碼:
DesiredCapabilities caps =newDesiredCapabilities();
caps.setCapability("automationName","Selendroid");
當然你也可以使用Appium的java-client庫來設置capabilities,前提是你必須導入這個類:
importio.appium.java_client.remote.MobileCapabilityType
然后設置代碼如下:
caps.setCapability(MobileCapabilityType.AUTOMATION_NAME,"Selendroid");
iOS無需進行這個設置,默認就是Appium引擎。
·platformName
定義測試平臺的名字,通常用于移動設備。值有:Android、iOS和FirefoxOS。使用代碼如下:
caps.setCapability("platformName","Android");
還可以使用java-client提供的方式設置:
caps.setCapability(MobileCapabilityType.PLATFORM_NAME, "Android");
在使用的過程中,請按照實際平臺來填寫即可。
·platformVersion
測試平臺版本,移動設備固件的版本號,比如:iOS的7.1.1,9.3等,Android的4.4.2、5.1.1等。設置代碼:
caps.setCapability("platformVersion","4.4.4");
Java-client提供的設置方式:
caps.setCapability(MobileCapabilityType.PLATFORM_VERSION, "4.4.4");
還是請按照實際版本號來填寫。
·deviceName
移動設備的名字,比如iPhone 5s、Google Nexus等,設置代碼:
caps.setCapability("deviceName", "Nexus 5");
或者用java-client設置方式:
caps.setCapability(MobileCapabilityType.DEVICE_NAME,"Nexus 5");
·app
蘋果app或者安卓app的路徑,可以是本地的絕對路徑,也可以是遠程網絡路徑,只要有訪問權限即可。根據這個app capabilities,Appium會在啟動測試之前安裝好app到設備。在測試安卓的時候,appPackage 和appActivity也需要設置,和app搭配使用。appPackage 和appActivity是安卓獨有的capabilities,在5.3小節會講解這兩個capabilities。
設置方式:
caps.setCapability("app","/apps/demo/demo.apk 或者 http://app.com/app.ipa");
Java-client設置方式:
caps.setCapability(MobileCapabilityType.APP,"/apps/demo/demo.apk 或者http://app.com/app.ipa")
·browserName
如果你想測試web app,那么你就需要定義browserName。對于Android來說,你可能會一定chrome瀏覽器,設置代碼:
caps.setCapability("browserName", "Chrome");
或者使用java-client的設置方式:
caps.setCapability(MobileCapabilityType.BROWSER_NAME, "Chrome");
對于iOS來說你可能要定義Safari瀏覽器
·newCommandTimeout
為了結束appium會話(session),appium會設置一個等待從客戶端發送命令超時的時間。默認時間是60秒,如果你不進行設置,如果你需要設置,代碼如下:
caps.setCapability("newCommandTimeout", "30");
當然你可以使用java-client提供的方法設置:
caps.setCapability(MobileCapabilityType.NEW_COMMAND_TIMEOUT,"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
3.Android獨有Capabilities
·appPackage
設置安卓app的包名的capability,告訴appium你要運行哪個app。
設置代碼為:
caps.setCapability("appPackage", "com.android.calculator2");
當然你還可以使用java-client提供的方法設置:
caps.setCapability(MobileCapabilityType.APP_PACKAGE, "com.android.calculator2”);
·appActivity
設置你想要運行的app的activity(相當于一個界面或者理解成網頁),比如:LoginActivity,登錄的activity,可以理解為登錄界面。
設置代碼為:
caps.setCapability("appActivity", "com.xxx.xxx.LoginActivity ");
或者使用java-client提供的方法設置:
caps.setCapability(MobileCapabilityType.APP_ACTIVITY, "com.xxx.xxx.LoginActivity ");
·appWaitActivity
設置你想要等待的android activity,設置方式為:
caps.setCapability("appWaitActivity","com.android.calculator2.Calculator");
或者
caps.setCapability(MobileCapabilityType.APP_WAIT_ACTIVITY,"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