Android 平台支持无障碍服务的 JavaScript 自动化工具

简介

Auto.js 是一款 Android 平台支持无障碍服务的 JavaScript 自动化工具软件.

Auto.js 由 hyb1996 于 2017/01/27 初次发布, 于 2020/03/13 停止维护, 最终版本名称为 4.1.1 alpha2.

AutoJs6 在 Auto.js 最终项目的基础上, 于 2021/12/01 进行二次开发, 继续保持开源免费.

基于 Auto.js 二次开发的开源项目 (以开发时间排序, 仅部分列举):

项目名称	应用名称	开发者	开发时间
Auto.js	Auto.js M	TonyJiangWJ	`2019/11/21`
AutoX	Autox.js / Autox.js v6	kkevsekk1	`2020/07/24`
AutoJs6	AutoJs6	SuperMonster003	`2021/12/01`

功能

可用作 JavaScript IDE (代码补全/变量重命名/代码格式化)
支持基于无障碍服务的自动化操作
支持浮动按钮快捷操作 (脚本录制及运行/查看包名及活动/布局分析)
支持选择器 API 并提供控件遍历/获取信息/控件操作 (类似 UiAutomator)
支持布局界面分析 (类似 Android Studio 的 LayoutInspector)
支持录制功能及录制回放
支持屏幕截图/保存截图/图片找色/图片匹配
支持 E4X (ECMAScript for XML) 编写界面
支持将脚本文件或项目打包为 APK 文件
支持利用 Root 权限扩展功能 (屏幕点击/滑动/录制/Shell)
支持作为 Tasker 插件使用
支持与 VSCode 连接并进行桌面开发 (需要 AutoJs6-VSCode-Extension 插件)

环境

Android 操作系统
API 24 (7.0) [N] 及以上

指南

主要变更

VSCode 插件支持客户端 (LAN) 及服务端 (LAN/ADB) 连接方式
多语言适配 (西/法/俄/阿/日/韩/英/简中/繁中等)
夜间模式适配 (设置页面/文档页面/布局分析页面/浮动窗口等)
Rhino 引擎由 v1.7.7.2 升级至 v1.7.15-SNAPSHOT
- 支持 Object.values()
```
Object.values({name: 'Max', age: 4}); // ['max', 4]
```
- 支持 Array.prototype.includes()
```
[10, 20, NaN].includes(20); // true
```
- 支持 BigInt
```
typeof 567n === 'bigint'; // true
```
- 支持模板字符串
```
`Lucky number: ${(Math.random() * 100).toFixed(0)}`
```
- 查看 Rhino 引擎更多新特性
- 查看 Rhino 引擎兼容性列表

版本历史

v6.4.1

2023/11/02

修复 构建工具无法自适应未知平台的问题 (by TonyJiangWJ) pr #158
修复 脚本退出时可能导致应用崩溃的问题 issue #159
修复 http 模块获取响应对象的 body.contentType 返回值类型错误 issue #142
修复 device.width 及 device.height 返回数据不正确的问题 issue #160
修复 代码编辑器长按删除时可能导致应用崩溃的问题 (试修) issue #156
修复 代码编辑器反向选择文本后进行常规操作可能导致应用崩溃的问题
修复 部分设备长按 AutoJs6 应用图标无法显示快捷方式菜单的问题
修复 部分设备打包项目时点击确认按钮无响应的问题
修复 app.sendBroadcast 及 app.startActivity 无法使用简称参数的问题
修复 floaty 模块 JsWindow#setPosition 等方法首次调用时的功能异常
优化 增加 Termux 相关权限以支持 Intent 调用 Termux 执行 ADB 命令 issue #136
优化 http 模块获取的响应对象可重复使用 body.string() 及 body.bytes() 方法
优化 增加 GitHub Actions 自动打包支持 (by TonyJiangWJ) pr #158
优化 构建工具自适应 Temurin 平台
优化 部分依赖或本地库版本调整 CHANGELOG.md

v6.4.0

2023/10/30

新增 ocr 模块支持 Paddle Lite 引擎 (by TonyJiangWJ) pr #120
新增 打包功能支持内置插件与外部插件两种打包方式 (by LZX284) pr #151
新增 WebSocket 模块 (参阅项目文档 > WebSocket)
新增 barcode / qrcode 模块 (参阅项目文档 > 条码 / 二维码)
新增 shizuku 模块 (参阅项目文档 > Shizuku) 及主页抽屉权限开关
新增 device.rotation / device.orientation 等方法
新增 内部 Java 类支持 class 静态属性访问
新增 支持在安卓系统设置页面选择并切换应用语言 (安卓 13 及以上)
新增 支持设置页面添加或长按应用图标激活应用快捷方式 , 可启动文档和设置等页面
修复 重新合并部分 PR (by aiselp) 以解决部分脚本无法正常结束运行的问题 pr #75 pr #78
修复 打包应用无法使用 AutoJs6 新增 API 的问题 (by LZX284) pr #151
修复 打包应用在系统夜间模式下的样式异常
修复 VSCode 插件保存文件到本地时文件扩展名信息丢失的问题
修复 使用协程特性运行项目产生未捕获异常致使应用崩溃的问题
修复 重启或退出应用时浮动按钮无法记录其位置状态信息的问题
修复 设备屏幕方向改变时无法获取更新后的设备配置信息的问题 issue #153
修复 屏幕旋转至横向时 Toolbar 标题字体过小的问题
修复 屏幕旋转至横向时应用主页的页签排版过于拥挤的问题
修复 屏幕旋转至横向时浮动按钮可能溢出屏幕的问题 issue #90
修复 屏幕多次旋转时无法恢复浮动按钮的坐标及屏幕侧边方向的问题
修复 部分设备消息浮动框可能出现遗漏显示或重复显示的问题
修复 消息浮动框在多个脚本同时运行时可能存在被遮蔽的问题 issue #67
修复 使用广播分析布局时点击布局无法弹出菜单且导致应用崩溃的问题
修复 第二次及以后创建的 WebSocket 实例均无法正常触发监听器的问题
修复 撤销 importPackage 的全局重定向方法以避免某些作用域下的包导入异常 issue #88
修复 日志活动页面使用复制或导出功能时可能导致应用崩溃的问题
优化 日志活动页面导出功能重命名为发送功能并重新实现符合实际意义的导出功能
优化 日志活动页面发送功能支持条目数量过大时自动截取并作出提示
优化 ocr 模块同时兼容 Google MLKit 及 Paddle Lite 引擎 (参阅项目文档 > 光学字符识别)
优化 提升无障碍服务自动启动的成功概率
优化 Kotlin 注解处理由 kapt 迁移至 KSP
优化 构建工具支持 IntelliJ Idea EAP 版本
优化 构建工具自适应 Java 发行版本以尽量避免 "无效的发行版本" 问题
优化 构建工具优化 IDE 及相关插件的版本退级逻辑并增加版本预测能力
优化 适配 VSCode 插件 1.0.7
优化 部分依赖或本地库版本调整 CHANGELOG.md

v6.3.3

2023/07/21

新增 代码编辑器的代码注释功能 (by 抠脚本人) pr #98
新增 auto.stateListener 用于无障碍服务连接状态监听 (by 抠脚本人) pr #98
新增 UiObject 类型添加 nextSibling / lastChild / offset 等方法 (参阅项目文档 > 控件节点)
修复 VSCode 插件在脚本字符总长度超过四位十进制数时无法解析数据的问题 issue #91 issue #93 issue #100 issue #109
修复 VSCode 插件无法正常保存文件的问题 issue #92 issue #94
修复 浮动按钮菜单项 "管理无障碍服务" 点击后可能未发生页面跳转的问题
修复 runtime.requestPermissions 方法丢失的问题 issue #104
修复 events.emitter 不支持 MainThreadProxy 参数的问题 issue #103
修复 在 pr #78 中存在的代码编辑器无法格式化代码的问题
修复 使用 JavaAdapter 时导致 ClassLoader 调用栈溢出的问题 issue #99 issue #110
优化 调整模块作用域 (by aiselp) pr #75 pr #78
优化 移除发行版本应用启动时的签名校验 (by LZX284) pr #81
优化 在 pr #98 基础上的编辑器代码注释功能的行为, 样式及光标位置处理
优化 在 pr #98 基础上添加代码注释菜单项
优化 适配 VSCode 插件 1.0.6
优化 UiObject#parent 方法增加级数参数支持 (参阅项目文档 > 控件节点)

项目编译构建

如需对 AutoJs6 开源项目进行调试或开发, 可使用 Android Studio 或 IntelliJ IDEA (Jetbrains 公司产品).

本小节以 Android Studio 为例介绍 AutoJs6 开源项目的编译构建方法, IntelliJ IDEA 与之类似.

Android Studio 准备

下载 Android Studio Hedgehog | 2023.1.1 RC 2 版本 (按需选择其一):

android-studio-2023.1.1.24-windows.exe (1.1 GB)
android-studio-2023.1.1.24-windows.zip (1.1 GB)

注: 上述版本发布时间为 2023 年 10 月 30 日. 如需下载其他版本, 或上述链接已失效, 可访问 Android Studio 发行版本归档页面.

安装或解压上述文件, 运行 Android Studio 软件 (如 "D:\android-studio\bin\studio64.exe").

Android SDK 准备

注: 如果计算机系统已安装 Android SDK (安卓软件开发工具包), 则可跳过此小节内容.

在 Android Studio 软件中使用快捷键 CTRL + ALT + S 打开设置页面:

Appearance & Behavior (外观与表现) -> 
System Settings (系统设置) -> 
Android SDK (安卓软件开发工具包)

Android SDK Location (安卓软件开发工具包位置) 处如果是空白内容, 可点击右侧 Edit (编辑) 按钮, 在弹出的窗口中多次点击 Next (下一步).

注: 过程中可能需要同意一个或多个相关协议才能继续.

待相关资源下载并安装完毕, 点击 Finish (完成) 按钮.
上述 Android SDK Location (安卓软件开发工具包位置) 处将自动完成路径填写, SDK 准备工作随即完成.

Android SDK Tools 准备

AutoJs6 需要使用部分 SDK 工具 (如 NDK 及 CMake).

注: 如果计算机系统已安装 AutoJs6 全部所需的 Android SDK Tools, 则可跳过此小节内容.

在 Android Studio 软件中使用快捷键 CTRL + ALT + S 打开设置页面:

Appearance & Behavior (外观与表现) -> 
System Settings (系统设置) -> 
Android SDK (安卓软件开发工具包) -> 
SDK Tools (SDK 工具) (位于右侧窗口)

勾选 Show Package Details (显示包详情), 依次点击 NDK 及 CMake, 确保相应版本的工具已勾选 (截至 2023 年 10 月 30 日, NDK 所需版本为 21.1.6352462, CMake 所需版本为 3.10.2).

SDK 工具的版本信息位于 AutoJs6 项目根目录的 version.properties 文件中.

JDK 准备

AutoJs6 项目依赖的 JDK (Java 开发工具包) 发行版本不低于 17, 但建议不低于 19.

需额外留意, 截至 2023 年 10 月 30 日, AutoJs6 暂不支持 JDK 最新版本 21.

注: 如果计算机系统已安装 JDK 且版本满足上述要求, 则可跳过此小节内容.

JDK 可使用 IDE 直接下载, 或访问 Oracle 网站下载.

在 Android Studio 软件中使用快捷键 CTRL + ALT + S 打开设置页面:

Build, Execution, Deployment (构建, 执行, 开发) ->
Build Tools (构建工具) -> 
Gradle

Gradle JDK 处可选择或添加不同版本的 JDK.

如果列表中已存在合适版本的 JDK (>= 17), 则直接选择即可.
否则可以选择 Download JDK (下载 JDK) 下载合适的 JDK, 点击 Download (下载) 按钮并等待下载完成.
也可以选择 Add JDK (添加 JDK) 添加已存在的本地 JDK, 定位其目录并完成 JDK 添加.

AutoJs6 资源克隆

在 Android Studio 主页面点击 Get from VCS (从版本控制系统获取) 按钮.
URL (统一资源定位地址) 处填入 https://github.com/SuperMonster003/AutoJs6.git,
Directory (目录) 处可根据需要修改为特定路径.
点击 Clone (克隆) 按钮, 等待 AutoJs6 项目资源在设备本地完成克隆.

注: 上述过程可能需要安装 Git (分布式版本控制系统).

AutoJs6 项目构建

克隆完成后, Android Studio 将打开 AutoJs6 的项目窗口, 并自动完成初步的 Dependencies (依赖) 下载及 Gradle 构建工作.

注: 上述过程可能非常耗时. 若网络条件欠佳, 可能需要重试多次 (点击 Retry 按钮).

构建完成后, Android Studio 的 Build 标签页将出现类似 BUILD SUCCESSFUL in 1h 17m 34s 的消息.

打包项目并生成可安装到安卓设备的 APK 文件:

调试版 (Debug Version)
- Build (构建) -> Build Bundle(s) / APK(s) -> Build APK(s)
- 生成带默认签名的调试版安装包
- 路径示例: "D:\AutoJs6\app\build\outputs\apk\debug\"
发布版 (Release Version)
- Build (构建) -> Generate Signed Bundle / APK
- 选择 APK 选项
- 准备好签名文件 (新建或选取), 生成已签名的发布版安装包
- 路径示例: "D:\AutoJs6\app\release\"

参阅: Android Docs

脚本开发辅助

开发 AutoJs6 可运行的脚本, 需使用合适的开发工具:

VSCode / WebStorm / HBuilderX ...

如需在 PC 上进行脚本编写与调试, VSCode 插件可以实现 PC 与手机的互联:

AutoJs6-VSCode-Extension - AutoJs6 调试器 (VSCode 平台插件)

使用开发工具编写代码时, 代码智能补全功能可以更好地辅助开发者完成代码编写:

AutoJs6-TypeScript-Declarations - AutoJs6 声明文件 (代码智能补全)

编写代码时, AutoJs6 相关 API 及使用方式, 可随时查阅应用文档:

AutoJs6-Documentation - AutoJs6 应用文档

现有的脚本开发项目可作为参考, 激发个人脚本项目的创作灵感:

Ant-Forest - 蚂蚁森林能量自动收取脚本 by TonyJiangWJ
Ant-Forest - 蚂蚁森林能量自动收取脚本 by SuperMonster003
autojs - Auto.js 实用脚本 by e1399579
autojsDemo - Auto.js 演示示例 by snailuncle
autojs 相关仓库 - GitHub 与 autojs 话题相关的全部仓库

贡献参与

感谢每一位参与 AutoJs6 项目开发的贡献人员.

贡献人员	提交数	最近提交
TonyJiangWJ	4	`2023/10/31`
LZX284 (Ai)	13	`2023/10/09`
little-alei (抠脚本人)	12	`2023/07/12`
aiselp	6	`2023/06/14`
LYS86 (LYS)	2	`2023/06/03`

数据更新于 2023/10/31.

数据条目按 最近提交 降序排序.

新发起的暂未处理的 Pull Request, 将在合并处理后加入数据统计.

部分贡献人员在 GitHub Contributors 未能正常出现, 其提交记录为空, 仍可通过 Pull Request 查看贡献记录.

gszs / autojs6 Goto Github PK

autojs6's Introduction

简介

功能

环境

指南

主要变更

版本历史

v6.4.1

2023/11/02

v6.4.0

2023/10/30

v6.3.3

2023/07/21

更多版本历史可参阅

项目编译构建

Android Studio 准备

Android SDK 准备

Android SDK Tools 准备

JDK 准备

AutoJs6 资源克隆

AutoJs6 项目构建

脚本开发辅助

贡献参与

Recommend Projects

Recommend Topics

Recommend Org