Android 平台支持无障碍服务的 JavaScript 自动化工具
当前自述文件 README.md 支持以下语言:
- 简体中文 [zh-Hans] # 当前
- 繁體中文 (香港) [zh-Hant-HK]
- 繁體中文 (台灣) [zh-Hant-TW]
- English [en]
- Français [fr]
- Español [es]
- 日本語 [ja]
- 한국어 [ko]
- Русский [ru]
- العربية [ar]
Auto.js 是一款 Android 平台支持 无障碍服务 的 JavaScript 自动化工具软件.
Auto.js 由 hyb1996 于 2017/01/27 初次发布, 于 2020/03/13 停止维护, 最终版本名称为 4.1.1 Alpha2, 构建版本号为 461.
AutoJs6 在 Auto.js 最终项目的基础上, 于 2021/12/01 进行二次开发, 继续保持开源免费.
下表列举了部分 Auto.js 相关项目 (按开发日期排序):
| 项目 | 应用名称 | 开发者 | 开发日期 | 终止开发日期 |
|---|---|---|---|---|
| Auto.js | Auto.js | hyb1996 | 2017/01/27 |
2020/03/13 |
| Auto.js Pro 7 | Auto.js | hyb1996 | 2019/03/13 |
2019/07/08 |
| Auto.js Pro 8 | AutoJsPro | hyb1996 | 2019/10/13 |
2021/07/24 |
| Auto.js | Auto.js M | TonyJiangWJ | 2019/11/21 |
- |
| AutoX | Autox.js | kkevsekk1 | 2020/07/24 |
- |
| Auto.js Pro 9 | AutoJsPro | hyb1996 | 2021/03/28 |
2023/02/09 |
| AutoJs6 | AutoJs6 | SuperMonster003 | 2021/12/01 |
- |
| AutoX | Autox.js v6 | wilinz | 2022/05/26 |
- |
| AutoX | Autox.js v7 | aiselp | 2024/04/21 |
- |
表格中的日期为预估值, 实际可能存在出入.
表格中 Auto.js Pro 7/8/9 为付费版本, 其余为免费开源版本.
- 可用作 JavaScript IDE (代码补全/变量重命名/代码格式化)
- 支持基于 无障碍服务 的自动化操作
- 支持浮动按钮快捷操作 (脚本录制及运行/查看包名及活动/布局分析)
- 支持选择器 API 并提供控件遍历/获取信息/控件操作 (类似 UiAutomator)
- 支持布局界面分析 (类似 Android Studio 的 LayoutInspector)
- 支持录制功能及录制回放
- 支持屏幕截图/保存截图/图片找色/图片匹配
- 支持 E4X (ECMAScript for XML) 编写界面
- 支持将脚本文件或项目打包为 APK 文件
- 支持利用 Root 权限扩展功能 (屏幕点击/滑动/录制/Shell)
- 支持作为 Tasker 插件使用
- 支持与 VSCode 连接并进行桌面开发 (需要 AutoJs6-VSCode-Extension 插件)
相较于 Auto.js 最终开源版本 4.1.1 Alpha2, AutoJs6 主要进行了以下升级或变更:
- 支持通过 Shizuku 获得 ADB 特权并使用系统 API
- 支持构建 WebSocket 实例以完成基于 WebSocket 协议 的网络请求
- 新增模块 [ base64 / crypto / sqlite / i18n / notice / ocr / opencc / qrcode / shizuku / ... ]
- 多语言适配 [ 西 / 法 / 俄 / 阿 / 日 / 韩 / 英 / 简中 / 繁中 / ... ]
- 主题色适配 [ 分组 / 定位 / 搜索 / 历史记录 / 亮度及对比度自动适配 / ... ]
- 夜间模式适配 [ 设置页面 / 文档页面 / 布局分析页面 / 浮动窗口 / ... ]
- VSCode 插件 支持客户端 (LAN) 及服务端 (LAN/ADB) 连接方式
- Rhino 引擎由 v1.7.7.2 升级至 v1.8.1-SNAPSHOT
- Unicode 码位 转义支持 辅助平面 字符
'\u{1D160}'; /* 表示 "𝅘𝅥𝅮", 传统方式: '\uD834\uDD60'. */
- 支持 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 引擎 兼容性列表
- Unicode 码位 转义支持 辅助平面 字符
提示API 变更: ui.(status/navigation)BarAppearanceLight[By] -> ui.(status/navigation)BarIconLight[By]新增util.dpToPx/spToPx/pxToDp/pxToSp 方法, 用于像素单位转换修复屏幕旋转至横向时子标题可能显示不完整的问题修复屏幕旋转至横向时部分页面内容被侧边导航栏遮挡的问题修复Android 15 部分页面状态栏背景着色区域不完整的问题issue #398修复代码编辑器可能使用置信度不足的编码写入文件导致内容解码异常的问题 (试修)优化关于应用与开发者页面增加布局适配通用性并去除不必要的布局分类优化README.md 项目编译构建小节添加多种方式便于定位目标设置页面issue #404优化部分依赖或本地库版本调整CHANGELOG.md
新增版本历史功能, 可查看发行版本历史更新记录 (多语言) 与统计数据新增timers.keepAlive 方法 (已全局化), 用于保持脚本活跃状态新增engines.on('start/stop/error', callback) 等事件监听方法, 用于监听脚本引擎全局事件新增images.detectMultiColors 方法, 用于多点颜色校验issue #374新增images.matchFeatures/detectAndComputeFeatures 方法, 支持全分辨率找图 (Ref to Auto.js Pro)issue #366新增images.compressToBytes 方法, 用于压缩图像并生成字节数组新增images.downsample 方法, 用于像素降采样并生成新的 ImageWrapper新增ui.keepScreenOn 方法, 用于 UI 页面获取焦点时保持设备屏幕常亮新增ui.root 属性 (getter), 用于获取 UI 页面布局的 "窗口内容根容器" 节点新增webview 元素支持基于 JsBridge 的 Web 页面布局 (Ref to Auto.js Pro) [参阅 示例代码 > 布局 > 可交互 HTML / Vue2 + Vant (SFC)]issue #281修复主页文档标签及文档活动页面显示在线文档时部分内容被系统导航栏遮挡的问题修复部分页面 Toolbar 点击按钮时可能导致标题点击事件误触发的问题修复部分设备代码编辑器空行显示方框字符的问题修复主题色设置页面调色盘对话框可能无限叠加的问题修复无障碍服务关闭时音量加键停止所有脚本功能失效的问题修复定时任务页面编辑自定义广播内容时出现的输入法遮挡问题修复webview 元素中的控件无法正常激活输入法软键盘的问题修复APK 文件类型信息对话框可能无法获取应用名称及 SDK 信息的问题修复文件管理器示例代码进入项目目录时可能无法自动加载子目录文件内容的问题修复Android 15 UI 模式顶部内容被状态栏覆盖的问题修复Android 15 部分页面状态栏背景颜色可能无法动态跟随主题色的问题修复dialogs 模块无法正常使用 customView 属性的问题issue #364修复dialogs.input 方法的表达式参数可能无法获得执行结果的问题修复使用 JavaAdapter 时导致 ClassLoader 调用栈溢出的问题issue #376修复console.setContentTextColor 方法导致日志字体颜色丢失默认值的问题issue #346修复console.setContentBackgroundColor 方法无法接受颜色名称参数的问题issue #384修复images.compress 方法实现原理由像素降采样修正为编码质量变化修复images.resize 方法无法正常使用的问题修复engines.all 方法可能触发 ConcurrentModificationException 的问题issue #394修复README.md 中部分语言日期格式不正确的问题修复Gradle 构建脚本可能因获取到无效库档案文件长度而导致构建失败的问题issue #389优化布局分析支持控件隐藏 (by TonyJiangWJ)pr #371issue #355优化布局分析菜单添加渐变分隔线实现一定程度的功能分组优化脚本项目配置文件 project.json 支持 permissions 选项 (by wirsnow)pr #391issue #362优化打包单文件时自动读取并勾选已安装应用的声明权限issue #362优化主题色扩充适配范围并支持更多控件类型优化主页抽屉在横向屏幕或超宽屏幕的宽度适应性优化关于应用与开发者页面增加水平布局及小屏布局适配优化设置页面对话框相关设置支持 "使用默认值" 菜单选项优化文件管理器浮动按钮展开后点击其他区域可自动隐藏优化代码编辑器格式化代码支持??,?.,??=等运算符优化代码编辑器支持 GB18030 / UTF-16 (LE/BE) / Shift_JIS 等编码的文件读写优化代码编辑器支持显示文件详细信息 (路径/编码/换行符/字节及字符总数等)issue #395优化意图相关操作 (编辑/查看/安装/发送/播放等) 增加操作异常提示优化webview 元素的 url 属性支持相对路径优化ImageWrapper#saveTo 方法的路径参数支持相对路径优化images.save 方法使用 quality 参数时支持 png 格式的文件体积压缩issue #367优化已忽略更新记录及客户端模式连接地址记录支持清空操作优化版本更新信息支持多语言显示 (与当前显示语言同步)优化使用异步加载方式一定程度提升文件管理器列表滑动流畅性优化脚本异常消息在控制台的显示内容与格式优化示例代码支持将文件夹重置为初始内容优化APK 文件签名信息提升检测效率优化APK 文件类型信息及媒体文件类型信息优化对话框显示效率及信息展示逻辑优化Gradle 构建脚本提升版本自适应能力discussion #369优化部分依赖或本地库版本调整CHANGELOG.md
新增ui.statusBarAppearanceLight/statusBarAppearanceLightBy/navigationBarColor 等方法新增ui.statusBarHeight 属性 (getter), 用于获取状态栏高度issue #357新增images.flip 方法, 用于图像翻转issue #349新增设置页面增加 "文件扩展名" 设置选项新增主题色设置页面增加新布局支持 (分组/定位/搜索/历史记录/调色盘增强等)修复Android 15 状态栏背景颜色与主题色不一致的问题修复plugins.load 方法无法正常加载插件的问题issue #290修复dx 库在 Android 7.x 无法正常使用的问题issue #293修复ScriptRuntime 使用 require 引用内置模块时可能出现的同步状态异常 (试修)issue #298修复notice 模块缺失 getBuilder 等扩展方法的问题issue #301修复shizuku/shell 等方法无法接受字符串参数的问题issue #310修复colors.pixel 方法无法接受单通道图像参数的问题issue #350修复engines.execScript/execScriptFile 等方法执行脚本时默认工作路径异常issue #358issue #340issue #339修复floaty.window/floaty.rawWindow 无法在子线程执行的问题修复floaty.getClip 可能无法正常获取剪切板内容的问题issue #341修复ui.inflate 返回值丢失 attr/on/click 等原型方法的问题修复使用 XML 语法将 JavaScript 表达式作为属性值时, 其作用域上下文绑定错误的问题issue #319修复部分方法调用出现异常时无法被 try..catch 块捕获的问题issue #345修复布局分析页面生成代码时可能导致应用崩溃的问题issue #288修复打包应用无法正常使用 shizuku 模块的问题issue #227issue #231issue #284issue #287issue #304修复代码编辑器跳转到行尾时可能跳转到下一行起始位置的问题修复设置页面连续快速点击对话框类型项目时可能导致应用崩溃的问题优化精简打包应用模板 APK 文件大小优化应用 (以及打包应用) 支持更多权限issue #338优化打包页面支持 Pinyin 库选项优化打包应用主活动页面优化状态栏背景及文字颜色优化打包应用设置页面增加访问所有文件和发送通知等特殊权限开关issue #354优化控件的文字及图标根据主题色亮度值自动切换合适的颜色优化部分控件主题色与背景色对比度过低时的视觉体验优化调色盘 HEX 输入控件增强剪贴板粘贴色值时的兼容性优化应用内页面导航栏设置为透明或半透明以增强视觉体验优化UI 模式状态栏及导航栏默认为md_grey_50色值且设置为亮色模式优化主页抽屉无障碍服务开关 8000 持与脚本代码同步优化主页文档页面搜索时支持双向查找按钮优化主页 "文件" 标签支持通过长按切换浮动按钮可见状态优化代码编辑器标题文字支持字体大小自适应优化日志页面浮动按钮可见状态与列表滚动操作联动优化脚本项目配置文件 project.json 支持更多打包选项issue #305issue #306优化脚本项目配置文件 project.json 支持选项名称宽松匹配及别名兼容优化APK 文件类型信息对话框增加文件大小与签名方案信息优化APK 文件类型信息对话框增加点击监听器支持文本复制与应用详情跳转优化尝试恢复 com.stardust 前缀包以便提升代码兼容性issue #290优化floaty.window/floaty.rawWindow 同时支持主线程和子线程执行优化getClip 全局方法适时借助 floaty.getClip 方法以提升兼容性优化files.path 及相关方法传入空值路径参数时的兼容性优化同步最新的 Rhino 引擎官方上游代码并进行必要的代码适配优化README.md 完善项目构建与运行相关内容issue #344优化部分依赖或本地库版本调整CHANGELOG.md
如需对 AutoJs6 开源项目进行调试或开发, 可使用 Android Studio (Google 公司产品) 或 IntelliJ IDEA (Jetbrains 公司产品).
本小节以 Android Studio 为例介绍 AutoJs6 开源项目的编译构建方法, IntelliJ IDEA 与之类似.
下载 Android Studio Meerkat Feature Drop | 2024.3.2 Patch 1 版本 (按需选择其一):
- android-studio-2024.3.2.15-windows.exe (1.23 GB)
- android-studio-2024.3.2.15-windows.zip (1.23 GB)
注: 上述版本发布时间为 2025 年 5 月 28 日. 如需下载其他版本, 或上述链接已失效, 可访问 Android Studio 发行版本归档 页面.
安装或解压上述文件, 运行 Android Studio 软件 (如 "D:\android-studio\bin\studio64.exe").
注: 如果计算机系统已安装 Android SDK (安卓软件开发工具包), 则可跳过此小节内容.
打开 Android SDK (安卓软件开发工具包) 设置页面 (任选一种方式):
Help (帮助) | Find action (查找操作) # 输入 "Android SDK"
[ 或 ]
File (文件) | Settings (设置) # 搜索 "Android SDK"
[ 或 ]
File (文件) | Settings (设置) | Language & Frameworks (语言和框架) | Android SDK (安卓软件开发工具包)
[ 或 ]
File (文件) | Settings (设置) | Appearance & Behavior (外观与行为) | System Settings (系统设置) | Android SDK (安卓软件开发工具包)
Android SDK Location (安卓软件开发工具包位置) 处如果是空白内容, 可点击右侧 Edit (编辑) 按钮, 在弹出的窗口中多次点击 Next (下一步).
注: 过程中可能需要同意一个或多个相关协议才能继续.
待相关资源下载并安装完毕, 点击 Finish (完成) 按钮.
上述 Android SDK Location (安卓软件开发工具包位置) 处将自动完成路径填写, SDK 准备工作随即完成.
AutoJs6 需要使用部分 SDK 工具 (如 NDK 及 CMake).
注: 如果计算机系统已安装 AutoJs6 全部所需的 Android SDK Tools, 则可跳过此小节内容.
打开 SDK Tools (SDK 工具) 设置页面 (任选一种方式):
Help (帮助) | Find action (查找操作) # 输入 "SDK Tools"
[ 或 ]
File (文件) | Settings (设置) # 搜索 "SDK Tools"
[ 或 ]
File (文件) | Settings (设置) | Language & Frameworks (语言和框架) | Android SDK (安卓软件开发工具包) | SDK Tools (SDK 工具) (位于右侧窗口)
[ 或 ]
File (文件) | Settings (设置) | Appearance & Behavior (外观与行为) | System Settings (系统设置) | Android SDK (安卓软件开发工具包) | SDK Tools (SDK 工具) (位于右侧窗口)
勾选 Show Package Details (显示包详情), 依次点击 NDK 及 CMake, 确保相应版本的工具已勾选, SDK 工具的版本信息位于 AutoJs6 项目根目录的 version.properties 文件中.
AutoJs6 项目依赖的 JDK (Java 开发工具包) 发行版本不低于 17, 但建议不低于 19.
截至 2025 年 5 月 31 日, AutoJs6 可支持 JDK 最高版本为 24.
注: 如果计算机系统已安装 JDK 且版本满足上述要求, 则可跳过此小节内容.
JDK 可使用 IDE 直接下载, 或访问 Oracle 网站 下载.
打开 Gradle JDK 设置页面 (任选一种方式):
Help (帮助) | Find action (查找操作) # 输入 "Gradle JDK"
[ 或 ]
File (文件) | Settings (设置) # 搜索 "Gradle"
[ 或 ]
File (文件) | Settings (设置) | Build, Execution, Deployment (构建, 执行, 部署) | Build Tools (构建工具) | Gradle
Gradle JDK 处可选择或添加不同版本的 JDK.
如果列表中已存在合适版本的 JDK (>= 17), 则直接选择即可.
否则可以选择 Download JDK (下载 JDK) 下载合适的 JDK, 点击 Download (下载) 按钮并等待下载完成.
也可以选择 Add JDK (添加 JDK) 添加已存在的本地 JDK, 定位其目录并完成 JDK 添加.
在 Android Studio 主页面点击 Get from VCS (从版本控制系统获取) 按钮.
URL (统一资源定位地址) 处填入 https://github.com/SuperMonster003/AutoJs6.git,
Directory (目录) 处可根据需要修改为特定路径.
点击 Clone (克隆) 按钮, 等待 AutoJs6 项目资源在设备本地完成克隆.
注: 上述过程可能需要安装 Git (分布式版本控制系统).
克隆完成后, Android Studio 将打开 AutoJs6 的项目窗口, 并自动完成初步的 Dependencies (依赖) 下载及 Gradle 构建工作.
注: 上述过程可能非常耗时. 若网络条件欠佳, 可能需要重试多次 (点击 Retry 按钮).
如果构建未能自动进行, 或需要再次构建项目, 可执行以下步骤:
- 在
Toolbar (工具栏)中, 从Run/Debug Configurations (运行/调试配置)菜单中选择app, 这是 AutoJs6 的主应用 - 点击左侧的
Build Project (构建项目)按钮 (形如铁锤) 开始构建项目, 默认快捷键为 CTRL + F9 - 等待构建完成,
Builder Output (构建输出)标签页将出现类似 "BUILD SUCCESSFUL in 1h 17m 34s" 的消息
如果构建失败, 可将异常消息反馈到 AutoJs6 项目的 议题 (Issues) 页面.
注: 关于如何构建并运行应用的更多内容, 可参阅 Android Docs
项目构建成功后, 可将项目作为应用程序 (简称 App) 部署到实体设备 (如手机/平板电脑) 或虚拟设备 (如 Android 模拟器) 中.
- 在
Toolbar (工具栏)中, 从Run/Debug Configurations (运行/调试配置)菜单中选择app, 这是 AutoJs6 的主应用 - 在右侧
Available Devices (可用设备)菜单中, 选择需要运行项目 App 的设备 (实体设备或虚拟设备) - 点击右侧的
Run (运行)按钮 (形如三角形) 开始运行项目, 默认快捷键为F10 - 等待部署完成, 指定设备将自动安装并运行项目 App
打包项目并生成可安装到安卓设备的 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
除了构建项目 App 之外, AutoJs6 还支持一些预置的 Gradle 构建任务, 这些任务可以帮助开发者完成与项目相关的便捷操作.
在 Toolbar (工具栏) 的 Run/Debug Configurations (运行/调试配置) 菜单中, 可看到各个 Gradle 预置任务, 每个任务左侧均显示带小象图标的任务标识.
- AutoJs6 [inrt:assemble]
组装 "inrt" 构建变体, 主要服务于 AutoJs6 脚本打包功能.
AutoJs6 项目拥有不同的构建变体, 其中 "inrt" 变体用于实现 AutoJs6 的脚本打包功能, 生成打包功能依赖的模板文件 "template.apk".
使用打包功能时可能会出现以下异常消息:
java.io.FileNotFoundException: template.apk
这表明模板文件不存在, 需要手动运行一次 inrt:assemble 任务, 生成模板文件, 然后再次构建并部署 App.
注: 当主项目代码发生变更, 且希望将变更同步到打包应用时, 需要重新运行
inrt:assemble任务生成模板文件并再次部署 App
- AutoJs6 [app:bundle]
打包 debug 版本编译过程产物, 主要服务于 AutoJs6 声明文件 项目.
任务运行后生成一个 AutoJs6 项目最新的 JAR 文件, 利用 Android d.ts Generator (by NativeScript) 工具可生成 AutoJs6 主应用的声明文件 (d.ts 格式).
- AutoJs6 [app:digest]
附加摘要信息到 release 版本编译产生的 APK 文件, 主要服务于 AutoJs6 发布最新版本到 GitHub 前确定最终的文件名.
以下为附加摘要信息前后的文件名对比:
前:
autojs6-v6.6.2-arm64-v8a.apk
后:
autojs6-v6.6.2-arm64-v8a-0f2a9d74.apk
参阅: Android Docs
开发 AutoJs6 可运行的脚本, 需使用合适的开发工具:
如需在 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 项目开发的贡献人员.
| 贡献人员 | 提交数 | 最近提交 |
|---|---|---|
| wirsnow | 1 | 2025/05/19 |
| TonyJiangWJ | 5 | 2025/04/24 |
| luckyloogn | 3 | 2025/01/01 |
| kvii | 1 | 2024/10/16 |
chenguangming (Tom) |
2 | 2024/05/14 |
LZX284 (AI) |
17 | 2023/11/19 |
little‑alei (抠脚本人) |
12 | 2023/07/12 |
| aiselp | 6 | 2023/06/14 |
LYS86 (Lin) |
2 | 2023/06/03 |
数据更新于 2025 年 5 月 27 日.
数据条目按 最近提交 降序排序.
新发起的暂未处理的 Pull Request, 将在合并处理后加入数据统计.
部分贡献人员在 GitHub Contributors 未能正常出现, 其提交记录为空, 仍可通过 Pull Request 查看贡献记录.