java版app自動化測試初始化模板
阿新 • • 發佈：2020-09-28
##### 專案目錄介紹
- 目錄結構如下：
（包含：驅動的基礎配置、全域性異常處理、異常截圖、報告自動生成、app常用操作方法封裝、常用工具類封裝）
- 各包分層關係
basepage包負責存放app公共操作方法、AndroidDriver基礎配置、testNG公共執行順序BaseTest,對外暴露驅動等。
- BaseApp類包含app操作有：封裝By型別的點選操作和輸入框輸入資料操作、切換到下一個視窗操作、上下左右滑動操作、具體座標點選操作、直接使用adb命令的操作、前進後退重新整理的操作等，其它方法可自行封住。
- 部分封裝方法如下：
```
/**
* 通過元素定位拿到 Element 元素物件
*
* @param locator By 型別元素定位
* @return 定位到的元素
*/
public WebElement locateElement(AndroidDriver driver,By locator) {
try {
wait = new WebDriverWait(driver, 10);
return wait.until(ExpectedConditions.presenceOfElementLocated(locator));
}catch (NoSuchElementException | TimeoutException e) {
System.out.println("================當前頁面未捕獲該元素，繼續執行用例==================");
}
return null;
}
/**
* 點選元素
* @param locator By 型別元素定位,做彈框或元素異常後接著往下執行
* @return 點選的元素
*/
public WebElement clickButton(AndroidDriver driver,By locator) {
try {
long time1 = DateUtils.getCurrentMillisecond();
MobileElement buttonElement = (MobileElement) locateElement(driver,locator);
wait.until(ExpectedConditions.elementToBeClickable(locator));
if (buttonElement.isEnabled()){
buttonElement.click();
log.info("該點選事件耗時時間（ms）："+(DateUtils.getCurrentMillisecond()-time1));
return buttonElement;
}
} catch (NoSuchElementException | TimeoutException e) {
System.out.println("================當前頁面未捕獲該元素，截圖保留>>>>繼續執行用例==================");
ScreenshotUtil.snapshot(driver);
}
return null;
// System.out.println("改點選事件耗時時間（ms）："+(DateUtils.getCurrentMillisecond()-time1));
}
/**
* 輸入框輸入資料
* @param locator By 型別元素定位
* @param content 輸入的內容，支援多內容，可以鍵盤輸入
* @return 輸入框元素
*/
public WebElement sendInput(AndroidDriver driver,By locator, CharSequence... content) {
WebElement inputElement = locateElement(driver,locator);
inputElement.clear();
inputElement.sendKeys(content);
return inputElement;
}
/*=====================通過動作滑動==================================*/
/**
*向上滑動操作
*/
public void swipeToUp(AndroidDriver driver) {
int width = driver.manage().window().getSize().width;
int height = driver.manage().window().getSize().height;
TouchAction action=new TouchAction(driver).press(PointOption.point(width/2, height*3/4)).waitAction(WaitOptions.waitOptions(duration))
.moveTo(PointOption.point(width/2, height/4)).release();
action.perform();
}
/**
*向下滑動操作
*/
public void swipeToDown(AndroidDriver driver) {
int height = driver.manage().window().getSize().height;
int width = driver.manage().window().getSize().width;
TouchAction action=new TouchAction(driver).press(PointOption.point(width/2, height/4)).waitAction(WaitOptions.waitOptions(duration))
.moveTo(PointOption.point(width/2, height*3/4)).release();
action.perform();
}
/**
*向左滑動操作
*/
public void swipeToLeft(AndroidDriver driver) {
int width = driver.manage().window().getSize().width;
int height = driver.manage().window().getSize().height;
TouchAction action=new TouchAction(driver).press(PointOption.point(width*3/4, height/2)).waitAction(WaitOptions.waitOptions(duration))
.moveTo(PointOption.point(width/4,height/2)).release();
action.perform();
}
/**
*向右滑動操作
*/
public void swipeToRight(AndroidDriver driver) {
int width = driver.manage().window().getSize().width;
int height = driver.manage().window().getSize().height;
TouchAction action=new TouchAction(driver).press(PointOption.point(width / 4, height / 2)).waitAction(WaitOptions.waitOptions(duration))
.moveTo(PointOption.point(width*3/4,height/2)).release();
action.perform();
}
/*=====================通過具體座標點選操作，appium&&adb兩種方式==================================*/
/**
* 通過具體座標點選
*/
public void taptest(AndroidDriver driver,int x, int y){
/**設定顯示等待時間10s driver=baseAndroidDriver.getDriver(baseConfig)
特注：顯示等待與隱式等待相對，顯示等待必須在每一個需要等待的元素前面進行宣告，如果在規定的時間內找到元素，則直接執行，即找到元素就執行相關操作
*/
wait = new WebDriverWait(driver,5);
//tap點選座標，輸入座標，然後再release()釋放座標點，用perform()去執行一系列action操作
action = new TouchAction(driver).tap(PointOption.point(x,y)).release().perform();
}
/**
* 通過adb命令驅動被測裝置
*/
public void adbInput(AndroidDriver driver ,String input){
try {
Process process = Runtime.getRuntime().exec(input);
wait = new WebDriverWait(driver,5);
process.destroy();
} catch (IOException e) {
e.printStackTrace();
}
}
```
- page包(通用PO模式)：分為data資料包和element元素操作包，把定位元素和輸入框資料統一放到data包中，元素的操作放到element包中。其中元素的操作資料來源於data包中。
- testcase包是根據業務流程編寫用例步驟（後面的用例維護均在此包下）
- resource包下可以放chromedriver驅動或者存放異常捕獲的截圖、測試報告自動生成index.html報告（由於使用springboot可以直接訪問報告）另一種測試報告用的最多的是allure2，一個開源很好的報告模板[allure2 的GitHub地址](https://github.com/allure-framework/allure2)測試報告輸出到allure-results包下。
- allure2報告整合，win下需要先下載allure2的zip包[GitHub官網下載地址allure2](https://github.com/allure-framework/allure2/releases/tag/2.13.5)，下載zip包後需要配置下環境變數，用例執行完成後會生成allure-results資料夾，在當前資料夾下執行
```
allure serve allure-results
```
即可自動開啟web測試報告，如下：
- extentreports報告樣式如圖（這裡把專案原始碼路徑修改了下，需要單獨導下包，具體見[介面自動化測試文章介紹](https://www.jianshu.com/p/5e87d078ceb2)）
[該專案原始碼地址]()
###### 模板流程說明
- 1、先在testcase包內寫測試用例流程，testcase包下的類需要繼承BaseTest 來獲取driver驅動
eg:
```
public class YynCases extends BaseTest {
/**
* 測試示例用例,繼承BaseTest獲取driver驅動
* 操作層
*/
EnterYynElemnt enterMiniElemnt = new EnterYynElemnt();
public void getDriverCase(){
System.out.println(driver);
//點選彈框按鈕
enterMiniElemnt.popupClick(driver);
}
}
```
- 2、建立page包下的element包中的元素操作類，即：EnterYynElemnt 類此包下的類需要繼承BaseApp類來獲取封裝的公共操作方法。
```
@Slf4j
public class EnterYynElemnt extends BaseApp{
/**
* 繼承BaseApp使用公共封裝方法
* */
//點選彈框
public void popupClick(AndroidDriver driver) {
//使用封裝By型別元素定位，且資料和元素分離
log.info("點選彈框");
clickButton( driver, PopupData.POPUP1);
}
}
```
- 3、建立page包下的data包的定位資料或者是輸入框資料，所有的元素定位和輸入資料均在此包下維護。上面引數POPUP1通過id定位，PopupData類下的POPUP1資料如下：
```
public class PopupData {
//升級彈框
public static final By POPUP1= By.id("com.tengyun.yyn:id/layout_confirm_cancel");
//第二個彈框
public static final By POPUP2 = By.id("com.tengyun.yyn:id/layout_activity_cancel");
```
- 4、其中第二步使用的是BaseApp封裝的公共類方法clickButton
```
public WebElement clickButton(AndroidDriver driver,By locator) {
try {
long time1 = DateUtils.getCurrentMillisecond();
MobileElement buttonElement = (MobileElement) locateElement(driver,locator);
wait.until(ExpectedConditions.elementToBeClickable(locator));
if (buttonElement.isEnabled()){
buttonElement.click();
log.info("該點選事件耗時時間（ms）："+(DateUtils.getCurrentMillisecond()-time1));
return buttonElement;
}
} catch (NoSuchElementException | TimeoutException e) {
System.out.println("================當前頁面未捕獲該元素，截圖保留>>>>繼續執行用例==================");
ScreenshotUtil.snapshot(driver);
}
return null;
// System.out.println("改點選事件耗時時間（ms）："+(DateUtils.getCurrentMillisecond()-time1));
}
```
輸入框輸入資料方法也是很常用的
```
public WebElement sendInput(AndroidDriver driver,By locator, CharSequence... content) {
WebElement inputElement = locateElement(driver,locator);
inputElement.clear();
inputElement.sendKeys(content);
return inputElement;
}
```
- 5、最後可以統一把testcase包下的類放到testNG的入口中執行測試並生成報告(由於使用springboot框架沒有用testNG的xml配置，而是通過封裝方法進行配置)
```
/**
* 測試用例總入口
* */
@Test
public void runCases(){
//執行測試用例入口
BaseTestngInit baseTestngInit = new BaseTestngInit();
baseTestngInit.baseTestngInitCode();
}
```
testNG封裝的工具類BaseTestngInit(工具類中也可以通過testng.xml初始化testng，具體看個人使用習慣)
```
/**
* 初始化testng
*/
public void baseTestngInitCode() {
//建立testng物件
TestNG testng = new TestNG();
//建立報告監聽器物件
ExtentTestNGIReporterListener reportListener = new ExtentTestNGIReporterListener();
// TestLogListener testLogListener = new TestLogListener();
//設定需要執行的測試用例類
testng.setTestClasses(new Class[] { com.iappium.testcase.YynCases.class});
//新增監聽器
testng.addListener(reportListener);
// testng.addListener(testLogListener);
//執行測試
testng.run();
}
```
[點選可獲取該專案原始碼地址](https://github.com/CuiZhongyuan/IAppium)
* *更多測試技術分享、學習資源以及一些其他福利可關注公眾號：【Coding測試】獲取：*
