一钦听、安裝Android Studio環(huán)境
請參考其他文章安裝
二、安裝手機模擬器
請參考其他文章安裝
三福青、安裝appium desktop版本
appium desktop版本下載地址:https://github.com/appium/appium-desktop/releases/
四犹菱、Android Studio中創(chuàng)建工程
通過“new project”先創(chuàng)建一個工程,然后在project中通過"new module"創(chuàng)建一個模塊用例實現(xiàn)測試用例肪跋。具體請參考其他文章。
五土砂、selenium 庫和appium 庫導入AS
有兩種導入方式州既,一種是下載jar包后手動導入,還有一種是在線導入萝映;
第一種吴叶,手動下載導入:
selenium 下載地址:http://selenium-release.storage.googleapis.com/index.html
appium 下載地址:https://search.maven.org/search?q=g:io.appium%20AND%20a:java-client
?也可以從appium網站進入下載鏈接: http://appium.io/downloads.html
還有個工具jar包 commons-lang3-3.1.jar 也會用到。
將下載的jar包直接拷入前面創(chuàng)建的new module的libs目錄下就可以了:
確保module的build.gradle中有如下聲明序臂,就會自動找到這兩個jar包:
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
}
第二種在線下載導入:
通過如下菜單選中demoTest模塊蚌卤,點擊加號中的“Library Dependency”:
然后如下菜單中搜索需要的庫,可以通過通配符匹配奥秆,注意查詢的格式如下標紅處逊彭,比如查詢selenium庫(org.seleniumhq.selenium:selenium* )如下:
類似輸入"io.appium:java-client*"可查找appium的對應庫,完成后如下:
另外吭练,測試用例還需要 junit:junit:4.12 這個庫相同方法在線導入一個诫龙,版本號盡量選新點的析显。
導入成功后會在demoTest的build.gradle中生成如下內容鲫咽,實際上手動在這里寫入如下內容效果也是一樣的:
dependencies {
implementation 'junit:junit:4.12'
implementation 'org.seleniumhq.selenium:selenium-server-standalone:2.53.0'
implementation 'io.appium:java-client:7.3.0'
}
同時签赃,工程的"External libraries"中會增加一堆jar包。
不過分尸,在線導入的 org.seleniumhq.selenium:selenium-server-standalone:2.53.0 這個庫版本太老了不知道為什么搜不到最新的庫锦聊,我后面的測試代碼用的的函數(shù)里面沒有,所以箩绍,除了junit:junit:4.12 這個在線導入孔庭,其他兩個我還是選擇了第一種本地導入的方式。
六材蛛、用例實現(xiàn)
用例源碼如下:
package com.example.demotest;
import java.io.File;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.List;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import io.appium.java_client.android.AndroidDriver;
import io.appium.java_client.android.AndroidElement;
public class MyClass {
private AndroidDriver<AndroidElement> driver;
@Before
public void init() {
File classpathRoot = new File(System.getProperty("user.dir"));
// 獲取apps文件
File appDir = new File(classpathRoot, "/src/main/java/apps/");
// 獲取apk文件
File app = new File(appDir, "ContactManager.apk");
DesiredCapabilities capabilities = new DesiredCapabilities();
// 設備名圆到,這里是模擬器的設備名
capabilities.setCapability("deviceName", "127.0.0.1:12");
// 系統(tǒng)平臺版本
capabilities.setCapability("platformVersion", "7.1.2");
capabilities.setCapability("app", app.getAbsolutePath());
capabilities.setCapability("appPackage", "com.example.android.contactmanager");
// app的入口啟動activity
capabilities.setCapability("appActivity", ".ContactManager");
// 連接appium啟動相應app
try {
driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
} catch (MalformedURLException e) {
e.printStackTrace();
}
System.out.println("App is launched!");//
}
@Test
public void start() throws InterruptedException {
Thread.sleep(100);
// 找到相應元素
WebElement el = driver.findElement(By.xpath(".//*[@text='Add Contact']"));
el.click();// 模擬點擊
// 找到eidit控件
List<AndroidElement> textFieldsList = driver.findElementsByClassName("android.widget.EditText");
textFieldsList.get(0).sendKeys("New Contact Name");
Thread.sleep(100);
WebElement spin = driver.findElement(By.id("com.example.android.contactmanager:id/contactPhoneTypeSpinner"));
spin.click();
Thread.sleep(100);
WebElement t = driver.findElement(By.xpath(".//*[@resource-id='android:id/text1']"));
t.click();
Thread.sleep(100);
textFieldsList.get(2).sendKeys("Some@example.com");
Thread.sleep(500);
WebElement spin2 = driver.findElement(By.id("com.example.android.contactmanager:id/contactEmailTypeSpinner"));
spin2.click();
Thread.sleep(500);
WebElement tt = driver.findElement(By.xpath(".//*[@text='\u5176\u4ED6']"));
System.out.println();
tt.click();
Thread.sleep(100);
System.out.println("App is done!");
}
@After
public void end() {
driver.quit();
}
}
七、編譯及運行
典型錯誤1:
build project時發(fā)現(xiàn)不會編這個demoTest模塊卑吭,需要將此模塊和app做如下依賴:
進入后可以選擇 demoTest芽淡,這樣在build project的時候就同時會去編譯demoTest這個依賴模塊了。
但是發(fā)現(xiàn)豆赏,編譯后會報類似如下錯誤:
Duplicate class org.openqa.selenium.SearchContext found in modules java-client-7.3.0.jar (java-client-7.3.0.jar) and selenium-server-standalone-3.141.59.jar (selenium-server-standalone-3.141.59.jar)
這個主要是導入的各種jar包(包括app和demoTest依賴的各種包)有類重復定義挣菲,折騰很久不知怎么去掉,后來發(fā)現(xiàn)如果只是跑測試用例不需要build整個project掷邦,只要Make Module 這個demoTest就可以了:
典型錯誤2:
運行中報如下錯誤:
org.openqa.selenium.InvalidSelectorException: Locator Strategy 'name' is not supported for this session
For documentation on this error, please visit: https://www.seleniumhq.org/exceptions/invalid_selector_exception.html
是由于新版的appium默認不支持用name來查詢控件元素白胀,可以考慮改成其他方式查詢,查看appium配置默認可以支持如下幾種:
path: Appium\resources\app\node_modules\appium\node_modules\appium-android-driver\build\lib\driver.js
class AndroidDriver extends _appiumBaseDriver.BaseDriver {
...
this.locatorStrategies = ['xpath', 'id', 'class name', 'accessibility id', '-android uiautomator'];
this.desiredCapConstraints = _desiredCaps.default;
...
}
比如抚岗,如下代碼:
WebElement el = driver.findElement(By.name("Add Contact"));
el.click();// 模擬點擊
可以改成:
WebElement el = driver.findElement(By.xpath(".//*[@text='Add Contact']"));
el.click();// 模擬點擊
或者:
List<AndroidElement> el = driver.findElementsById("com.example.android.contactmanager:id/addContactButton");
el.get(0).click();// 模擬點擊
典型錯誤3:
運行中查找中文字符時會報查找不到或杠,需要將中文轉換成unicode碼,例如:
WebElement tt = driver.findElement(By.xpath(".//*[@text='其他']"));
改成如下宣蔚,注意unicode碼的表示方法:
WebElement tt = driver.findElement(By.xpath(".//*[@text='\u5176\u4ED6']"));
典型錯誤4:
報錯“錯誤: 編碼GBK的不可映射字符”廷痘,如下:
在項目下的build.gradle中添加以下代碼即可解決:
tasks.withType(JavaCompile) {
options.encoding = "UTF-8"
}
此方法同時可以解決典型錯誤3中的問題。
最后件已,通過run test就可以跑這個用例了笋额。