autojs sdk: App/小程序自动化测试 SDK - 基于 Autojs

autojs sdk

基于 Autojs 的 APP、小程序自动化测试 SDK，支持：启动应用、停留等待、判断存在、文本点击、颜色点击、循环点击、坐标拾取、语音播报、通知栏提示、音量调节、震动等数十项能力。

项目主页

https://github.com/kangour/autojs_sdk

autojs sdk 在 Auto.js 的基础上，通过大量接口优化提升了模块的通用性，并进行丰富的功能扩展。

能干啥

使用 autojs sdk，一行代码就能完成 语音播报/任意类型文本点击/循环点击/坐标拾取/自动权限控制/自动类型识别/自动按键监听/通知栏实时提示/自动移除最近任务/自动解锁 等数十项能力，更多能力陆续开放中。

开放的方法

包括但不限于以下方法，更多功能尽情期待：

    start_app: 传入应用名称，启动应用。
    wait_for: 等待文本出现
    has_text: 当前屏幕是否存在文本
    click: 点击文本或坐标
    click_item: 点击文本
    click_color: 点击颜色
    click_item_each: 点击当前屏幕的所有传入文本
    click_color_each: 点击当前屏幕的所有传入颜色
    wait_befor_click: 某文本出现之前的点击
    get_coord_by_color: 通过颜色获取坐标
    get_coord_by_text: 获取文本坐标
    set_volume: 设置设备音量
    log/warn/error: 设置调试日志

简单上手

编写基于本 sdk 的应用分为三个步骤

1. 将 autojs_sdk/lib.js 导入运行环境
2. 在新创建的应用中用 require('lib') 引入 auto_sdk
3. 编写主函数 main() 并传入 lib.start_app()

这里展示仅用 5 行代码开发一个基于网易云音乐的自动播放测试应用，实现的功能有 启动网易云音乐后的 跳过开屏广告/播放每日推荐歌曲/调节音量。

// 导入：从 lib.js 导入需要的方法
let { start_app, click_item, set_volume, wait_befor_click } = require('lib.js');

// 编写主函数：程序启动后执行的逻辑代码。
function main() {
    wait_befor_click('发现', '跳过')
    click_item('发现')
    click_item('每日推荐')
    click_item('播放全部')
    set_volume(30)
}

// 启动应用：传入参数依次为：主函数，要启动的 App 名称，当前应用描述，是否语音播报执行状态。
start_app(main, '网易云音乐', '播放日推', true)

高频函数介绍

入口函数

start_app(callback, op_app, this_app, use_tts)

程序入口函数，自动完成解锁、启动 App、权限控制、按键监听、通知栏提示等操作。

• callback：软件启动后执行的函数，如 main
• operation_app：需要启动的软件，如 网易云音乐
• this_app：当前程序的描述，如 播放每日推荐
• use_tts：执行完毕后是否使用语音提示（默认不启用）

文本点击

click_item(_text, tip_type)

自动识别文本类型，并点击文本。

• _text: 待点击的文本
• tip_type：提示类型，如果传入 no_tip，则不会在文字寻找失败后给出提示弹窗（默认启用）

颜色点击

click_color(_color, x, y, w, h)

在指定的区域点击传入的颜色

• _color：待点击的颜色
• x：区域左上角的 x 坐标
• y：区域左上角的 y 坐标
• w：区域宽度
• h：区域高度

等待前点击

wait_befor_click(target, source)

在 target 出现前，如果出现 source，就点击。

例如进入有开屏广告的应用前，点击 “跳过广告” 文本，有效节约启动时间：

wait_befor_click('首页', '跳过')

开发者的话

还有很多函数等待你去发掘，比如日期时间处理，日志，坐标处理等能力，均可参考 autojs_sdk/lib.js 的函数注释，同时也希望你能和我一起来完善它，一起构建一个易用的自动化测试工具；你可以将自己基于 autojs_sdk 编写的应用提交到 example 目录下。

项目交流群

autojs_sdk 群：984025847