史上最全最新微信小程序自动化教程appium自动化小试牛刀

青旅半醒 2023-10-01 19:58 91阅读 0赞

### 背景 ###

微信小程序作为现在流行的一种应用载体，很多小伙伴都有对其做自动化测试的需求，由于腾讯系 QQ、微信等是基于腾讯自研 X5 内核，不是谷歌原生 webview，所以调试会有些许差异（现在很多 app 产品也开始流行采用 X5 内核作为其内嵌 Web 浏览服务）。

需要注意的是 X5 内核只支持手机，模拟器是不支持的。

我们的教程以最主流的 Appium 自动化技术为例讲解如何对微信小程序做自动化测试。

### 准备工作 ###

## step1：打开微信小程序 webview 调试开关 ##

聊天窗口输入如下两个 URL：

[http://debugmm.qq.com/?forcex5=true][http_debugmm.qq.com_forcex5_true]

[X5内核调试专用页][X5]

![47b207befe9bdc2f7fe209b43b16203f.png][]

在第二个 URL 打开的页面中勾选：

![259b533321cfa494c2d36fe439ffc920.png][]

## step2：安装 UC 开发者工具并识别小程序页面元素信息 ##

Chrome 自带的 inspect 工具识别小程序/内嵌 Web 页面需要访问外网，很多小伙伴不具体这样的条件，所以推荐大家安装 UC 开发者调试工具，这样不用 FQ 也可识别到小程序的页面元素信息

下载地址：[https://dev.ucweb.com/][https_dev.ucweb.com]

安装完之后如果有小伙伴发现识别不了可进行如下设置：

![58d78e7d5c155636a5a9f936123355c3.png][]

进入微信主页面-> 向下滑动展开小程序列表-> 点击对应小程序

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA56iL5bqP5aqb5pyI5LiL_size_20_color_FFFFFF_t_70_g_se_x_16][]

这里我们即可使用工具获取元素的信息并写出定位表达式了，比如定位到【课程】这个元素：//a\[contains(text(),"课程")\]

## step3：确认微信小程序对应的进程名 ##

微信有很多的进程，我们要确定当前小程序是位于哪个进程中（当前查询到的是 com.tencent.mm:appbrand0）：

![c2933af453dfa651814337b7d8b8766e.png][]

这里需要注意：进行该操作的时候最好重启微信（在后台清理应用重新点击启动），目的是为了保证被测小程序在微信后台只有一个，跟代码执行过程保持同步。

step3：chromeDriver 驱动匹配

小程序本质上还是 Web 页面，我们可以通过 chromeDriver 驱动小程序页面执行，小程序因为使用的 X5 内核是经过腾讯二次开发过之后的，所以 chromeDriver 驱动与 webview 版本匹配并不严格按照官方 Appium 说明的匹配规则，这里试验了几个版本的 chromeDriver，发现 V2.40 版本的 chromeDriver 是比较合适的：

下载地址：[https://npm.taobao.org/mirrors/chromedriver][https_npm.taobao.org_mirrors_chromedriver]

下载完毕后解压，将 chromeDriver 替换到 Appium 的自带 chromeDriver 所在路径：

`Appium.exe所在路径\resources\app\node_modules\appium\node_modules\appium-chromedriver\chromedriver\win`

### 编写脚本 ###

这里以 Java 语言为例，我们使用 Maven 项目管理工具在项目中引入 Appium 的客户端库

<dependency>
        <groupId>io.appium</groupId>
        <artifactId>java-client</artifactId>
        <version>7.0.0</version>
    </dependency>

Appium 启动 App 的常规代码就不再赘述了，这里需要注意的是 Appium 启动微信做小程序自动化测试除了常规的配置如：deviceName、platformName、appPackage、appActivity 之外，还需添加如下配置参数：

// 支持X5内核应用自动化配置
    desiredCapabilities.setCapability("recreateChromeDriverSessions", true);
    ChromeOptions options = new ChromeOptions();
    //com.tencent.mm:appbrand0为前面通过adb命令查询到的小程序进程名，同之前保持一致
    options.setExperimentalOption("androidProcess", "com.tencent.mm:appbrand0");
    desiredCapabilities.setCapability(ChromeOptions.CAPABILITY, options);
    // 初始化会默认将chrome浏览器打开，需要将Browser置为空
    desiredCapabilities.setBrowserName("");

进入到小程序可以通过常规方式：

启动微信进入到主页-> 下滑展开小程序列表-> 点击对应小程序

进入到小程序之后我们需要切换 context：

driver.context("WEBVIEW_com.tencent.mm:appbrand0");

划重点！！！切换 context 之后如果直接定位元素会发现元素是定位不到了，这是因为小程序打开之后会存在三个 Web 窗口：

![07b9b5f8486e4c2d297f1604efa1892e.png][]

所以我们这里一定要记得切换（通过 handle 句柄）

//需要找到正确的web窗口--xxx（切换句柄）
    //获取所有的窗口句柄
    Set<String> allHandles = driver.getWindowHandles();
    for (String handle:allHandles){
        //通过窗口的标题来判断
        if(driver.getTitle().equals("xxx")){
            break;
        }else {
            //切换句柄
            driver.switchTo().window(handle);
        }
    }

之后我们就可以通过常规的方式去定位/操作元素了：

driver.findElement(By.xpath("//a[contains(text(),\"课程\")]")).click();

### 总结 ###

微信小程序与普通的 Hybrid 应用做自动化测试存在很多的区别，不管是 webview 调试开关的开启方式，还是小程序需要的特殊启动参数配置，以及 chromeDriver 与小程序 webview 的版本匹配，种种因素导致微信小程序执行并不是很稳定，而且切换 webview 速度也比较慢。随着微信版本的迭代更新，可能一些配置会失效。

目前微信自己有发布了支持小程序自动化测试的框架 Minium，但坑比较多。第三方的一些图像识别框架也可以支持小程序的自动化测试，比如网易的 Airtest，上手简单，但准确性和稳定性不高。总的来说目前市面上并没有一款足够好用、足够稳定的微信小程序自动化测试的框架/工具。当然，随着后续技术的升级，应该会有很多的优秀工具涌现出来。

**PS：想要完整代码的同学可以私信作者或者评论区留言。**

[http_debugmm.qq.com_forcex5_true]: http://testingpai.com/forward?goto=http%3A%2F%2Fdebugmm.qq.com%2F%3Fforcex5%3Dtrue
[X5]: http://testingpai.com/forward?goto=http%3A%2F%2Fdebugx5.qq.com
[47b207befe9bdc2f7fe209b43b16203f.png]: https://img-blog.csdnimg.cn/img_convert/47b207befe9bdc2f7fe209b43b16203f.png
[259b533321cfa494c2d36fe439ffc920.png]: https://img-blog.csdnimg.cn/img_convert/259b533321cfa494c2d36fe439ffc920.png
[https_dev.ucweb.com]: http://testingpai.com/forward?goto=https%3A%2F%2Fdev.ucweb.com%2F
[58d78e7d5c155636a5a9f936123355c3.png]: https://img-blog.csdnimg.cn/img_convert/58d78e7d5c155636a5a9f936123355c3.png
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA56iL5bqP5aqb5pyI5LiL_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/3d703122d8564bd1a439808d008a63a5.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA56iL5bqP5aqb5pyI5LiL,size_20,color_FFFFFF,t_70,g_se,x_16
[c2933af453dfa651814337b7d8b8766e.png]: https://img-blog.csdnimg.cn/img_convert/c2933af453dfa651814337b7d8b8766e.png
[https_npm.taobao.org_mirrors_chromedriver]: http://testingpai.com/forward?goto=https%3A%2F%2Fnpm.taobao.org%2Fmirrors%2Fchromedriver
[07b9b5f8486e4c2d297f1604efa1892e.png]: https://img-blog.csdnimg.cn/img_convert/07b9b5f8486e4c2d297f1604efa1892e.png