Appium + java 实现Android app自动化测试

一、Appium：
是一个开源测试自动化框架，可用于原生，混合和移动Web应用程序测试。它使用WebDriver协议驱动iOS，Android和Windows应用程序；
UiAutomator测试框架是AndroidSDK自带的App UI自动化测试Java库；
appium在Android端基于WebDriver协议，利用Bootstrap.jar，最后通过调用UiAutomator的命令，实现App的自动化测试。
demo：https://github.com/vachelx/AutoTest

二、工作原理

appium_principle.png

1.Client端将自动化测试脚本发送给Service；
2.Server端与移动设备连接，将脚本解析后通过UiAutomator命令控制和监听移动设备；
3.appium针对主流语言分别开发的相应的appium库（Python Java PHP Ruby等），均已经集成在Server端，所以Service端可解析多种语言的测试脚本；
4.appium针对每种语言都开发了对应的Client，我们只需要选择想用的语言对应的Client。

三、Java + appium配置
1.安装appium服务端：
提供了可视化版本appium-desktop:
https://github.com/appium/appium-desktop/releases/tag/v1.18.3
安装后主页面Host和port使用默认的即可。

image.png

Edit Configurations中配置Android SDK和jdk对应的路径；然后可以启动Service

2.Server链接测试用移动设备：连上usb，预配置链接设备相关参数（cilent初始化需要和这些参数对应）
deviceName：adb devices -l 获取；
platformVersion：adb shell getprop ro.build.version.release 获取；
appPackage：测试应用的包名
appActivity：要测试的页面
（这里服务器地址要记住，在Client中需要）
启动会话后移动设备和server会连接上；（appium-desktop提供了录制功能直接操作移动设备生成脚本）

image.png

3.Client端配置
这里使用Android studio + java编译测试脚本
直接依赖java-client库https://github.com/appium/java-client即可
脚本运行可以借助junit4
(如若使用Python，需要安装Python3+Python3的appium库，最好再安装Python的IDE）

使用
新建空的Android项目-> 新建java library module;
项目build.gradle中添加:

allprojects {
    repositories {
        google()
        jcenter()
        //项目build.gradle的中添加
        maven { url "https://jitpack.io" }
    }
}

library module的build.gradle中添加依赖

apply plugin: 'java-library'

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'junit:junit:4.12'
    implementation 'androidx.test:runner:1.3.0'
    // 生成测试报告的extentreports库
    implementation group: 'com.aventstack', name: 'extentreports', version: '5.0.4'
    // java-client
    implementation 'com.github.appium:java-client:7.3.0'
}

接下来可以编写测试脚本了
脚本测试开始前需要配置与服务端的链接，拿到AndroidDriver以对移动设备进行指定操作；
需要在Junit合适的地方进行该初始化操作（和上面的服务端预配置参数一致）

  public AndroidDriver initDriver() {
        DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
        desiredCapabilities.setCapability("platformName", "Android");
        desiredCapabilities.setCapability("appPackage", "com.tencent.mm");
        desiredCapabilities.setCapability("deviceName", "V1838A");
        desiredCapabilities.setCapability("platformVersion", "10");
        desiredCapabilities.setCapability("appActivity", "com.tencent.mm.ui.LauncherUI");
        desiredCapabilities.setCapability("resetKeyboard", true);
        desiredCapabilities.setCapability("noReset", true);
        desiredCapabilities.setCapability("automationName", "UiAutomator2");
        desiredCapabilities.setCapability("ensureWebviewsHavePages", true);
// 这里Url为服务端url driver即为服务端链接的移动设备驱动者
        driver = new AndroidDriver(new URL(Config.REMOTE_URL), desiredCapabilities);
        return driver;
    }

demo：

public class JumpWXFriends{
    private AndroidDriver mDriver; // 测试手机的控制者
    private static ExtentReports mExtent;
    
    @BeforeClass
    public static void beforeClass(){ // 在类初始化前初始化报告生成器
         String reportPath = "reports/" + Util.getMarkDate() + "/" + Util.getMarkTime() + ".html";
         mExtent = new ExtentReports();
         ExtentSparkReporter spark = new ExtentSparkReporter(reportPath);
         spark.config().setOfflineMode(true);
        mExtent .attachReporter(spark);
    }
    
    // 监听每个@Test方法执行前后的额外操作->记录报告
    @Rule
    public TestWatcher eu = new ExtendWatcher(mExtent); 
    
    // case开始前初始化与Service链连接
    @Before
    public void setUp() throws MalformedURLException {
        // 上面的与服务器链接的初始化操作 
        mDriver = getDriver();
    }
    
    @After
    public void tearDown() {
        // testcase测试结束后关闭连接
       mDriver.quit();
    }
    
    @Test
    public void testJumpWXFriends(){ 
        Util.waitActivity(MAIN_ACTIVITY, 30, mDriver);
        Util.sleep(1);
// 这个是Appium-desktop生成的脚本代码
// 从微信主页 - 发现 - 朋友圈 - 向下滑动一段
        MobileElement el1 = (MobileElement) mDriver.findElementByXPath("//android.widget.FrameLayout[@content-desc=\"当前所在页面,与的聊天\"]/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.view.ViewGroup/android.widget.FrameLayout[1]/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.RelativeLayout/android.widget.LinearLayout/android.widget.RelativeLayout[3]/android.widget.LinearLayout/android.widget.RelativeLayout/android.widget.ImageView[1]");
        el1.click();
        MobileElement el2 = (MobileElement) mDriver.findElementByXPath("//android.widget.FrameLayout[@content-desc=\"当前所在页面,与的聊天\"]/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.view.ViewGroup/android.widget.FrameLayout[1]/android.widget.FrameLayout/android.widget.FrameLayout/com.tencent.mm.ui.mogic.WxViewPager/android.widget.FrameLayout/android.widget.RelativeLayout/android.widget.ListView/android.widget.LinearLayout[1]/android.widget.LinearLayout/android.widget.LinearLayout[1]/android.widget.LinearLayout/android.widget.LinearLayout/android.widget.LinearLayout/android.widget.LinearLayout/android.widget.LinearLayout");
        el2.click();
        new TouchAction(mDriver).press(PointOption.point(1200, 787)).moveTo(PointOption.point(734, 271)).release().perform();
    }
}