四 Android Capabilities講解

標籤：lob   firefox   等於   iphone 5   輸入中文   預設   理解   重設   移動   

1.Capabilities介紹

可以看下之前代碼裡面設定的capabilities

DesiredCapabilities capabilities = new DesiredCapabilities();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位於這個包中：

import org.openqa.Selenium.remote.DesiredCapabilities

所以在使用DesiredCapabilities的時候需要先匯入這個類。

 

2.通用Capabilities

 

.automationName 

這個capability主要是定義測試引擎。當你在安卓平台上進行測試的時候，你需要確認你使用的android sdk版本，如果是小於17的話，你需要指定測試引擎為：Selendroid。如果大於等於17，你需要使用的引擎是：Appium，預設就是Appium測試引擎。具體使用代碼：

DesiredCapabilities caps = new DesiredCapabilities();caps.setCapability("automationName","Selendroid");

當然你也可以使用Appium的java-client庫來設定capabilities，前提是你必須匯入這個類：

import io.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

四 Android Capabilities講解