smartapp-automator

###### API 文档

smartapp-automator SDK 是为开发者提供的一套通过 Node.js 脚本操控小程序的方案，从而实现小程序自动化测试的目的。

快速开始

$3

请根据你的电脑类型，按文档配置你的运行环境：Mac 电脑运行环境配置

$3

请在你的工程目录里运行以下命令，安装 smartapp-automator SDK：

`` shell
$ npm i smartapp-automator --save
`

$3

smartapp-automator 对于曾经使用过其它 UI 测试框架的同学来说，会觉得非常的熟悉。

你可以创建一个设备实例打开小程序，然后使用 smartapp-automator 的 API 操控它。

示例 - 用 Android 设备跳转 CTS 小程序首页并进行截屏：

我们将该脚本命名为 screenshot.js

` Javascript
const automator = require('smartapp-automator');

automator.launch({
deviceType: 'android', // 要驱动的真机设备类型，这里为 Android 手机
deviceId: '37bf1128' // 要驱动的真机设备 ID，Android 手机的 serial 号，可通过 adb devices 获取
}).then(async device => {
let smartapp await device.newSmartapp(
'baidu', // 驱动运行小程序的宿主 APP 的代号，baidu 为百度 APP 的代号
'VPKGrAKy7fQfAG9scxLPQV10OeGErWmp_dev1' // 要驱动运行的小程序的 AppKey，可通过开发者工具预览打包功能获取
);
await smartapp.goto(); // 跳转小程序首页
await smartapp.screenshot(); // 截屏
await device.close(); // 关闭设备实例
});
`

资源文件

- API 文档

测试

` shell


仅支持使用 Mac 电脑和 Android 设备运行测试


$ npm run test
`

如何贡献

- 提交 pr 的时候，新增的每一个能力，都需要在 ./docs` 下完善文档，否则不予合入

讨论

Q: 谁在维护 smartapp-automator ？

百度小程序测试中台团队在维护着这个 SDK。

Q: 在执行输入操作的时候，突然杀死进程，即使拔除 usb 线，iOS 仍然会以 1 字/秒的速度键入字符，怎么解决？

这个「灵魂输入事件」，我觉得，可以通过捕获杀死进程事件，强制等待 input 操作结束，来稍加避免该情况发生。
发生该情况的时候，也只能等待键入完成/重启手机了。

Q: Android 在运行一段时间后（5-10 天），atx-agent 会频繁挂掉，怎么解决？

Android 设备上的进程死掉，一般是因为 OOM，Android 系统对内存的使用几无限制，当内存被各类 APP 占用后，低优先级的进程就会被优先干掉。
一个不成熟的建议：删除跑任务设备上的其它 APP。

Q: DOM 中 attribute 和 property 是啥区别？

attribute 是由 HTML 定义的，出现在 HTML 标签内的属性都是 attribute，总是 string 类型。
property 是 js 的 DOM 对象的属性，即 document.getElementById('go').xxx 的 xxx，xxx 可以是任意类型。
但注意，w3c 标准定义的 attribute 和 property 是 1:1 对应关系，如：id, class（对的 className，因为 js 里 class 是关键字）, title 等。
一般，property/attribute 改变会改变对应的 attribute/property，但不一般情况如 input 的 value 改变其 property 的时候，attribute 不变。
一般，我们使用 property，因为比较快。

Q: iOS wda 仅支持端控件元素输入，能否支持小程序元素输入

再看看。