autojs6-banner_800×224

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

****** ### 语言 (Languages) ****** 当前自述文件 `README.md` 支持以下语言: - 简体中文 [zh-Hans] # 当前 - [繁體中文 (香港) [zh-Hant-HK]](http://project.autojs6.com/blob/master/.readme/README-zh-Hant-HK.md) - [繁體中文 (台灣) [zh-Hant-TW]](http://project.autojs6.com/blob/master/.readme/README-zh-Hant-TW.md) - [English [en]](http://project.autojs6.com/blob/master/.readme/README-en.md) - [Français [fr]](http://project.autojs6.com/blob/master/.readme/README-fr.md) - [Español [es]](http://project.autojs6.com/blob/master/.readme/README-es.md) - [日本語 [ja]](http://project.autojs6.com/blob/master/.readme/README-ja.md) - [한국어 [ko]](http://project.autojs6.com/blob/master/.readme/README-ko.md) - [Русский [ru]](http://project.autojs6.com/blob/master/.readme/README-ru.md) - [العربية [ar]](http://project.autojs6.com/blob/master/.readme/README-ar.md) ****** ### 简介 ****** [Auto.js](https://github.com/hyb1996/Auto.js) 是一款 Android 平台支持 [无障碍服务](https://developer.android.com/guide/topics/ui/accessibility/service?hl=zh-cn) 的 JavaScript 自动化工具软件. Auto.js 由 [hyb1996](https://github.com/hyb1996) 于 `2017/01/27` 初次发布, 于 `2020/03/13` 停止维护, 最终版本名称为 `4.1.1 Alpha2`, 构建版本号为 `461`. AutoJs6 在 Auto.js 最终项目的基础上, 于 `2021/12/01` 进行二次开发, 继续保持开源免费. 下表列举了部分 Auto.js 相关项目 (按开发日期排序): | 项目 | 应用名称 | 开发者 | 开发日期 | 终止开发日期 | |:------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------:| | [Auto.js](https://github.com/hyb1996/Auto.js) | [Auto.js](https://github.com/TonyJiangWJ/Auto.js/commit/268ec8895bbfa28fc7715154eb15b1c1eaaefd14#diff-5e01f7d37a66e4ca03deefc205d8e7008661cdd0284a05aaba1858e6b7bf9103R2) | [hyb1996](https://github.com/hyb1996) | `2017/01/27` | `2020/03/13` | | Auto.js Pro 7 | Auto.js | [hyb1996](https://github.com/hyb1996) | `2019/03/13` | `2019/07/08` | | Auto.js Pro 8 | AutoJsPro | [hyb1996](https://github.com/hyb1996) | `2019/10/13` | `2021/07/24` | | [Auto.js](https://github.com/TonyJiangWJ/Auto.js) | [Auto.js M](https://github.com/TonyJiangWJ/Auto.js/commit/268ec8895bbfa28fc7715154eb15b1c1eaaefd14#diff-5e01f7d37a66e4ca03deefc205d8e7008661cdd0284a05aaba1858e6b7bf9103R2) | [TonyJiangWJ](https://github.com/TonyJiangWJ) | `2019/11/21` | - | | [AutoX](https://github.com/kkevsekk1/AutoX) | [Autox.js](https://github.com/kkevsekk1/AutoX/commit/8143e4ed893d4af05d22aa791b83a962f9959873#diff-5e01f7d37a66e4ca03deefc205d8e7008661cdd0284a05aaba1858e6b7bf9103R2) | [kkevsekk1](https://github.com/kkevsekk1) | `2020/07/24` | - | | [Auto.js Pro 9](https://pro.autojs.org/) | AutoJsPro | [hyb1996](https://github.com/hyb1996) | `2021/03/28` | `2023/02/09` | | [AutoJs6](https://github.com/SuperMonster003/AutoJs6) | [AutoJs6](https://github.com/SuperMonster003/AutoJs6/commit/a8ce1b9acb541e9736c33134be3194c3148a15a3#diff-833a46a97033e77558372a2dce103fd6fee29aaaa899f610022a7aece592ee7bR27) | [SuperMonster003](https://github.com/SuperMonster003) | `2021/12/01` | - | | [AutoX](https://github.com/kkevsekk1/AutoX) | [Autox.js v6](https://github.com/kkevsekk1/AutoX/commit/8b6776cff8b0fca4be4a52719b7d7d07c0a058f3#diff-51a0b488f963eb0be6c6599bf5df497313877cf5bdff3950807373912ac1cdc9R130) | [wilinz](https://github.com/wilinz) | `2022/05/26` | - | | [AutoX](https://github.com/aiselp/AutoX) | [Autox.js v7](https://github.com/aiselp/AutoX/commit/484491fd5fe12b8203d0b09c181eb0f471c0ea9f#diff-8cff73265af19c059547b76aca8882cbaa3209291406f52df1dafbbc78e80c46R120) | [aiselp](https://github.com/aiselp) | `2024/04/21` | - | 表格中的日期为预估值, 实际可能存在出入. 表格中 Auto.js Pro 7/8/9 为付费版本, 其余为免费开源版本. ****** ### 功能 ****** * 可用作 JavaScript IDE (代码补全/变量重命名/代码格式化) * 支持基于 [无障碍服务](https://developer.android.com/reference/android/accessibilityservice/AccessibilityService) 的自动化操作 * 支持浮动按钮快捷操作 (脚本录制及运行/查看包名及活动/布局分析) * 支持选择器 API 并提供控件遍历/获取信息/控件操作 (类似 [UiAutomator](https://developer.android.com/training/testing/ui-automator)) * 支持布局界面分析 (类似 Android Studio 的 LayoutInspector) * 支持录制功能及录制回放 * 支持屏幕截图/保存截图/图片找色/图片匹配 * 支持 [E4X](https://zh.wikipedia.org/wiki/E4X) (ECMAScript for XML) 编写界面 * 支持将脚本文件或项目打包为 APK 文件 * 支持利用 Root 权限扩展功能 (屏幕点击/滑动/录制/Shell) * 支持作为 Tasker 插件使用 * 支持与 VSCode 连接并进行桌面开发 (需要 [AutoJs6-VSCode-Extension](http://vscext-project.autojs6.com) 插件) ****** ### 环境 ****** - Android 操作系统 - [API](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) [24](https://developer.android.com/reference/android/os/Build.VERSION_CODES#N) ([7.0](https://zh.wikipedia.org/wiki/Android_Nougat)) [[N](https://developer.android.com/reference/android/os/Build.VERSION_CODES#N)] 及以上 ****** ### 指南 ****** * [应用文档](https://docs.autojs6.com) * [使用手册 (待编写)](https://docs.autojs6.com/#/manual) * [疑难解答](https://docs.autojs6.com/#/qa) * [项目编译构建](#project-compilation-and-build) * [脚本开发辅助](#script-development-assistance) ****** ### 主要变更 ****** 相较于 Auto.js 最终开源版本 `4.1.1 Alpha2`, AutoJs6 主要进行了以下升级或变更: * 支持通过 [Shizuku](https://shizuku.rikka.app/introduction/) 获得 ADB 特权并使用系统 API * 支持构建 [WebSocket](https://docs.autojs6.com/#/webSocketType) 实例以完成基于 [WebSocket 协议](https://zh.wikipedia.org/wiki/WebSocket) 的网络请求 * 新增模块 [ [base64](https://docs.autojs6.com/#/base64) / [crypto](https://docs.autojs6.com/#/crypto) / [sqlite](https://docs.autojs6.com/#/sqlite) / [i18n](https://docs.autojs6.com/#/i18n) / [notice](https://docs.autojs6.com/#/notice) / [ocr](https://docs.autojs6.com/#/ocr) / [opencc](https://docs.autojs6.com/#/opencc) / [qrcode](https://docs.autojs6.com/#/qrcode) / [shizuku](https://docs.autojs6.com/#/shizuku) / ... ] * 多语言适配 [ 西 / 法 / 俄 / 阿 / 日 / 韩 / 英 / 简中 / 繁中 / ... ] * 主题色适配 [ 分组 / 定位 / 搜索 / 历史记录 / 亮度及对比度自动适配 / ... ] * 夜间模式适配 [ 设置页面 / 文档页面 / 布局分析页面 / 浮动窗口 / ... ] * [VSCode 插件](http://vscext-project.autojs6.com) 支持客户端 (LAN) 及服务端 (LAN/ADB) 连接方式 * [Rhino](https://github.com/mozilla/rhino/) 引擎由 [v1.7.7.2](https://github.com/mozilla/rhino/releases/tag/Rhino1_7_7_2_Release) 升级至 [v1.8.1-SNAPSHOT](http://rhino.autojs6.com/blob/master/gradle.properties#L3) * Unicode [码位](https://developer.mozilla.org/zh-CN/docs/Glossary/Code_point) 转义支持 [辅助平面](https://zh.wikipedia.org/wiki/Unicode%E5%AD%97%E7%AC%A6%E5%B9%B3%E9%9D%A2%E6%98%A0%E5%B0%84#%E7%AC%AC%E4%B8%80%E8%BC%94%E5%8A%A9%E5%B9%B3%E9%9D%A2) 字符 ```javascript '\u{1D160}'; /* 表示 "𝅘𝅥𝅮", 传统方式: '\uD834\uDD60'. */ ``` * 支持 [Object.values()](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/values) ```javascript Object.values({name: 'Max', age: 4}); // ['max', 4] ``` * 支持 [Array.prototype.includes()](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/includes) ```javascript [10, 20, NaN].includes(20); // true ``` * 支持 [BigInt](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/BigInt) ```javascript typeof 567n === 'bigint'; // true ``` * 支持 [模板字符串](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Template_literals) ```javascript `Lucky number: ${(Math.random() * 100).toFixed(0)}` ``` * 查看 Rhino 引擎 [更多新特性](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/RHINO.md) * 查看 Rhino 引擎 [兼容性列表](https://mozilla.github.io/rhino/compat/engines.html) ****** ### 版本历史 ****** # v6.6.2 ###### 2025/04/13 * `新增` ui.statusBarAppearanceLight/statusBarAppearanceLightBy/navigationBarColor 等方法 * `新增` images.flip 方法, 用于图像翻转 _[`issue #349`](http://issues.autojs6.com/349)_ * `新增` 设置页面增加 "文件扩展名" 设置选项 * `新增` 主题色设置页面增加新布局支持 (分组/定位/搜索/历史记录/调色盘增强等) * `修复` Android 15 状态栏背景颜色与主题色不一致的问题 * `修复` plugins.load 方法无法正常加载插件的问题 _[`issue #290`](http://issues.autojs6.com/290)_ * `修复` dx 库在 Android 7.x 无法正常使用的问题 _[`issue #293`](http://issues.autojs6.com/293)_ * `修复` ScriptRuntime 使用 require 引用内置模块时可能出现的同步状态异常 (试修) _[`issue #298`](http://issues.autojs6.com/298)_ * `修复` notice 模块缺失 getBuilder 等扩展方法的问题 _[`issue #301`](http://issues.autojs6.com/301)_ * `修复` shizuku/shell 等方法无法接受字符串参数的问题 _[`issue #310`](http://issues.autojs6.com/310)_ * `修复` colors.pixel 方法无法接受单通道图像参数的问题 _[`issue #350`](http://issues.autojs6.com/350)_ * `修复` engines.execScript/execScriptFile 等方法执行脚本时默认工作路径异常 * `修复` floaty.window/floaty.rawWindow 无法在子线程执行的问题 * `修复` floaty.getClip 可能无法正常获取剪切板内容的问题 _[`issue #341`](http://issues.autojs6.com/341)_ * `修复` ui.inflate 返回值丢失 attr/on/click 等原型方法的问题 * `修复` 部分方法调用出现异常时无法被 try..catch 块捕获的问题 _[`issue #345`](http://issues.autojs6.com/345)_ * `修复` 布局分析页面生成代码时可能导致应用崩溃的问题 _[`issue #288`](http://issues.autojs6.com/288)_ * `修复` 打包应用无法正常使用 shizuku 模块的问题 _[`issue #227`](http://issues.autojs6.com/227)_ _[`issue #231`](http://issues.autojs6.com/231)_ _[`issue #284`](http://issues.autojs6.com/284)_ _[`issue #287`](http://issues.autojs6.com/287)_ _[`issue #304`](http://issues.autojs6.com/304)_ * `修复` 代码编辑器跳转到行尾时可能跳转到下一行起始位置的问题 * `修复` 设置页面连续快速点击对话框类型项目时可能导致应用崩溃的问题 * `优化` 精简打包应用模板 APK 文件大小 * `优化` 打包页面支持 Pinyin 库选项 * `优化` 打包应用主活动页面优化状态栏背景及文字颜色 * `优化` 打包应用设置页面增加访问所有文件和发送通知等特殊权限开关 _[`issue #354`](http://issues.autojs6.com/354)_ * `优化` 控件的文字及图标根据主题色亮度值自动切换合适的颜色 * `优化` 部分控件主题色与背景色对比度过低时的视觉体验 * `优化` 调色盘 HEX 输入控件增强剪贴板粘贴色值时的兼容性 * `优化` 应用内页面导航栏设置为透明或半透明以增强视觉体验 * `优化` UI 模式状态栏及导航栏默认为 `md_grey_50` 色值且设置为亮色模式 * `优化` 主页抽屉无障碍服务开关支持与脚本代码同步 * `优化` 主页文档页面搜索时支持双向查找按钮 * `优化` 主页 "文件" 标签支持通过长按切换浮动按钮可见状态 * `优化` 代码编辑器标题文字支持字体大小自适应 * `优化` 日志页面浮动按钮可见状态与列表滚动操作联动 * `优化` 脚本项目配置文件 project.json 支持更多打包选项 _[`issue #305`](http://issues.autojs6.com/305)_ _[`issue #306`](http://issues.autojs6.com/306)_ * `优化` 脚本项目配置文件 project.json 支持选项名称宽松匹配及别名兼容 * `优化` APK 文件类型信息对话框增加文件大小与签名方案信息 * `优化` APK 文件类型信息对话框增加点击监听器支持文本复制与应用详情跳转 * `优化` 尝试恢复 com.stardust 前缀包以便提升代码兼容性 _[`issue #290`](http://issues.autojs6.com/290)_ * `优化` floaty.window/floaty.rawWindow 同时支持主线程和子线程执行 * `优化` getClip 全局方法适时借助 floaty.getClip 方法以提升兼容性 * `优化` 同步最新的 Rhino 引擎官方上游代码并进行必要的代码适配 * `优化` README.md 完善项目构建与运行相关内容 _[`issue #344`](http://issues.autojs6.com/344)_ * `优化` 部分依赖或本地库版本调整 _[`CHANGELOG.md`](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/CHANGELOG.md#v662)_ # v6.6.1 ###### 2025/01/01 * `新增` pinyin 模块, 用于汉语拼音转换 (参阅项目文档 > [汉语拼音](https://docs.autojs6.com/#/pinyin)) * `新增` pinyin4j 模块, 用于汉语拼音转换 (参阅项目文档 > [汉语拼音](https://docs.autojs6.com/#/pinyin4j)) * `新增` UiObject#isSimilar 及 UiObjectCollection#isSimilar 方法, 用于确定控件或控件集合是否相似 * `新增` currentComponent 全局方法, 用于获取当前活动的组件名称信息 * `修复` 部分环境因回退版本过低而无法正常编译项目的问题 * `修复` 调用不存在的方法时可能出现的 "非原始类型值" 异常 * `修复` 部分设备无法正常添加脚本快捷方式的问题 (试修) _[`issue #221`](http://issues.autojs6.com/221)_ * `修复` automator.click/longClick 方法参数类型限制错误 _[`issue #275`](http://issues.autojs6.com/275)_ * `修复` 选择器不支持 ConsString 类型参数的问题 _[`issue #277`](http://issues.autojs6.com/277)_ * `修复` UiObjectCollection 实例缺失自身方法及属性的问题 * `优化` 打包页面支持签名配置/密钥库管理/权限设置 (by [luckyloogn](https://github.com/luckyloogn)) _[`pr #286`](http://pr.autojs6.com/286)_ * `优化` 提升浮动窗口当前包名及当前活动名的识别准确性 (优先级: Shizuku > Root > A11Y) * `优化` 提升 currentPackage/currentActivity 识别准确性 (优先级: Shizuku > Root > A11Y) * `优化` 恢复日志活动窗口单个条目文本内容的双击或长按选择功能 _[`issue #280`](http://issues.autojs6.com/280)_ * `优化` 脚本项目识别在 project.json 损坏情况下尽可能还原关键信息 * `优化` 打包单文件时自动生成的包名后缀支持将简体中文转换为拼音 (支持多音字) * `优化` UiSelector#findOnce 及 UiSelector#find 方法支持负数参数 * `优化` app.startActivity/startDualActivity 方法增强适配性 * `优化` UI 元素及 className 相关选择器支持更多的包名前缀省略形式 (如 RecyclerView, Snackbar 等) * `优化` 同步最新的 Rhino 引擎官方上游代码并进行必要的代码适配 * `优化` 部分依赖或本地库版本调整 _[`CHANGELOG.md`](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/CHANGELOG.md#v661)_ # v6.6.0 ###### 2024/12/02 - 内置模块重写, 谨慎升级 * `提示` 内置模块使用 Kotlin 重新编写以提升脚本运行效率但可能需要多次迭代逐步完善 * `提示` 内置 init.js 文件默认为空但支持开发者自行扩展内置模块或挂载外部模块 * `新增` axios 模块 / cheerio 模块 (Ref to [AutoX](https://github.com/kkevsekk1/AutoX)) * `新增` sqlite 模块, 用于 SQLite 数据库简单操作 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) (参阅项目文档 > [SQLite](https://docs.autojs6.com/#/sqlite)) * `新增` mime 模块, 用于处理和解析 MIME 类型字符串 (参阅项目文档 > [MIME](https://docs.autojs6.com/#/mime)) * `新增` nanoid 模块, 可作为字符串 ID 生成器 (Ref to [ai/nanoid](https://github.com/ai/nanoid)) * `新增` sysprops 模块, 用于获取运行时环境配置数据 (参阅项目文档 > [系统属性](https://docs.autojs6.com/#/sysprops)) * `新增` ocr 模块支持 [Rapid OCR](https://github.com/RapidAI/RapidOCR) 引擎 * `新增` 布局分析支持切换窗口 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` auto.clearCache 方法, 支持清除控件缓存 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` threads.pool 方法, 支持线程池简单应用 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` images.matchTemplate 方法增加 useTransparentMask 选项参数, 支持透明找图 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` images.requestScreenCaptureAsync 方法, 用于 UI 模式异步方式申请截图权限 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` images.requestScreenCapture 方法增加 isAsync 选项参数, 支持异步方式获取屏幕截图 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` images.on('screen_capture', callback) 等事件监听方法, 支持监听屏幕截图可用事件 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` images.stopScreenCapture 方法, 支持主动释放截图申请的相关资源 (Ref to [Auto.js Pro](https://g.pro.autojs.org/)) * `新增` images.psnr/mse/ssim/mssim/hist/ncc 及 images.getSimilarity 方法, 用于获取图像相似性度量值 * `新增` images.isGrayscale 方法, 用于判断图像是否为灰度图像 * `新增` images.invert 方法, 用于反色图像转换 * `新增` s13n.point/time 方法, 用于标准化点对象及时长对象 (参阅项目文档 > [标准化](https://docs.autojs6.com/#/s13n)) * `新增` console 模块 gravity (重力), touchThrough (穿透点击), backgroundTint (背景着色) 等相关方法 (参阅项目文档 > [控制台](https://docs.autojs6.com/#/console)) * `新增` Mathx.randomInt/Mathx.randomFloat 方法, 用于返回指定范围内的随机整数或随机浮点数 * `新增` app.launchDual/startDualActivity 等方法, 用于处理双开应用 (需要 Shizuku 或 Root 权限) (实验性) * `新增` app.kill 方法, 用于强制停止应用 (需要 Shizuku 或 Root 权限) * `新增` floaty.getClip 方法, 用于借助浮动窗口聚焦间接获取剪切板内容 * `修复` Fragment 子类 (如 [DrawerFragment](https://github.com/SuperMonster003/AutoJs6/blob/17616504ab0bba93b30ab7abc67108ee5253f39a/app/src/main/java/org/autojs/autojs/ui/main/drawer/DrawerFragment.kt#L369) / [ExplorerFragment](https://github.com/SuperMonster003/AutoJs6/blob/17616504ab0bba93b30ab7abc67108ee5253f39a/app/src/main/java/org/autojs/autojs/ui/main/scripts/ExplorerFragment.kt#L48) 等) 中存在的 View Binding 内存泄漏 * `修复` [ScreenCapture](https://github.com/SuperMonster003/AutoJs6/blob/17616504ab0bba93b30ab7abc67108ee5253f39a/app/src/main/java/org/autojs/autojs/core/image/capture/ScreenCapturer.java#L70) / [ThemeColorPreference](https://github.com/SuperMonster003/AutoJs6/blob/10960ddbee71f75ef80907ad5b6ab42f3e1bf31e/app/src/main/java/org/autojs/autojs/ui/settings/ThemeColorPreference.kt#L21) 等类中存在的实例内存泄漏 * `修复` Android 14 申请截图权限导致应用崩溃的问题 (by [chenguangming](https://github.com/chenguangming)) _[`pr #242`](http://pr.autojs6.com/242)_ * `修复` Android 14 开启前台服务导致应用崩溃的问题 * `修复` Android 14 代码编辑器运行按钮点击后无法正常亮起的问题 * `修复` 项目打包后应用可能因缺少必要库文件无法正常运行的问题 _[`issue #202`](http://issues.autojs6.com/202)_ _[`issue #223`](http://issues.autojs6.com/223)_ _[`pr #264`](http://pr.autojs6.com/264)_ * `修复` 编辑项目时可能因指定图标资源不存在而导致应用崩溃的问题 _[`issue #203`](http://issues.autojs6.com/203)_ * `修复` 截图权限申请时无法正常使用参数获取指定屏幕方向的截图资源 * `修复` 部分设备无法正常添加脚本快捷方式的问题 (试修) _[`issue #221`](http://issues.autojs6.com/221)_ * `修复` 调用 http 模块与发送请求相关的方法将出现累积性请求发送延迟的问题 _[`issue #192`](http://issues.autojs6.com/192)_ * `修复` Shizuku 服务在 AutoJs6 进入主活动页面之前可能无法正常使用的问题 (试修) _[`issue #255`](http://issues.autojs6.com/255)_ * `修复` random(min, max) 方法可能出现结果越界的问题 * `修复` pickup 方法结果类型参数无法正常传入空数组的问题 * `修复` UiObject#bounds() 得到的控件矩形可能被意外修改而破坏其不变性的问题 * `修复` text/button/input 元素的文本内容包含半角双引号时无法正常解析的问题 * `修复` text/textswitcher 元素的 autoLink 属性功能失效的问题 * `修复` 不同脚本可能错误地共享同一个 ScriptRuntime 对象的问题 * `修复` 全局变量 HEIGHT 及 WIDTH 丢失 Getter 动态属性的问题 * `修复` 脚本启动时 RootShell 随即加载可能导致启动高延迟的问题 * `修复` 控制台浮动窗口设置背景颜色导致矩形圆角样式丢失的问题 * `修复` 无障碍服务自动启动可能出现的服务异常问题 (试修) * `修复` 主页文档页面左右滑动 WebView 控件时可能触发 ViewPager 切换的问题 * `修复` 文件管理器无法识别包含大写字母文件扩展名的问题 * `修复` 文件管理器首次进入项目目录时可能无法自动识别项目的问题 * `修复` 文件管理器删除文件夹后页面无法自动刷新的问题 * `修复` 文件管理器排序文件及文件夹时可能出现 ASCII 首字母名称置后的问题 * `修复` 代码编辑器调试功能的 FAILED ASSERTION 异常 * `修复` 代码编辑器调试过程中关闭编辑器后无法再次正常调试的问题 * `修复` 代码编辑器跳转到行尾时可能遗漏末尾字符的问题 * `修复` 主活动页面启动日志活动页面时可能出现闪屏的问题 * `修复` 打包应用无法正常使用 opencc 模块的问题 * `优化` 打包页面中 "不可用 ABI" 控件的点击提示体验 * `优化` 支持使用 Shizuku 控制 "指针位置" 显示开关 * `优化` 支持使用 Shizuku 控制 "投影媒体" 及 "修改安全设置" 权限开关 * `优化` automator.gestureAsync/gesturesAsync 支持回调函数参数 * `优化` tasks 模块使用同步方式进行数据库操作避免可能的数据访问不一致问题 * `优化` 脚本执行模式支持管道符号分隔模式参数 (如 `"ui|auto";` 开头) * `优化` 脚本执行模式支持单引号及反引号且支持省略分号 (如 `'ui';` 或 `'ui'` 开头) * `优化` 脚本执行模式支持 axios, cheerio, dayjs 等模式参数快捷导入内置扩展模块 (如 `"axios";` 开头) * `优化` 脚本执行模式支持 x 或 jsox 模式参数快捷启用 JavaScript 内置对象扩展模块 (如 `"x";` 开头) * `优化` img 元素 src 及 path 属性支持本地相对路径 (如 `

) * `优化` 代码编辑器导入 Java 类和包名时支持智能判断插入位置 * `优化` images 模块支持直接使用路径作为图像参数 * `优化` importPackage 支持字符串参数 * `优化` 服务端模式 IP 地址支持剪切板导入智能识别且支持空格按键智能转换 * `优化` 文件管理器新建文件时支持默认前缀选择并自动生成合适的数字后缀 * `优化` 文件管理器运行项目时具体化异常消息提示 _[`issue #268`](http://issues.autojs6.com/268)_ * `优化` 文件管理器支持更多类型并支持显示对应的图标符号 (支持 800 多种文件类型) * `优化` 文件管理器可编辑的文件类型 (jpg/doc/pdf...) 增加编辑按钮 * `优化` 文件管理器 APK 文件支持查看基础信息, Manifest 信息及权限列表 * `优化` 文件管理器音视频等媒体文件支持查看基础信息及 MediaInfo 信息 * `优化` 打包单文件时支持自动填入合适的标准化名包并支持无效字符过滤提示 * `优化` 打包单文件时支持根据已安装同包名应用自动设置图标并自增版本号及版本名称 * `优化` 打包项目配置文件支持 abis/libs 选项指定默认包含的 ABI 架构及扩展库 * `优化` 打包项目配置文件 abis/libs 选项无效或无可用时支持相关消息提示 * `优化` LeakCanary 在正式发行版本中被排除以避免增加不必要性 * `优化` 项目源代码所有英文注释增加简体中文翻译以增强注释可读性 * `优化` README 及 CHANGELOG 支持多语言 (由脚本自动生成) * `优化` Gradle 构建脚本提升版本自适应能力 * `优化` 部分依赖或本地库版本调整 _[`CHANGELOG.md`](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/CHANGELOG.md#v660)_ ##### 更多版本历史可参阅 * [CHANGELOG.md](http://project.autojs6.com/blob/master/app/src/main/assets-app/doc/CHANGELOG-zh-Hans.md) ****** ### 项目编译构建 ****** 如需对 AutoJs6 开源项目进行调试或开发, 可使用 [Android Studio](https://pro.autojs.org/) ([Google](https://www.google.com/) 公司产品) 或 [IntelliJ IDEA](https://www.jetbrains.com/idea/) ([Jetbrains](https://www.jetbrains.com/) 公司产品). 本小节以 Android Studio 为例介绍 AutoJs6 开源项目的编译构建方法, IntelliJ IDEA 与之类似. #### Android Studio 准备下载 `Android Studio Meerkat | 2024.3.1 Patch 1` 版本 (按需选择其一): - [android-studio-2024.3.1.14-windows.exe](https://redirector.gvt1.com/edgedl/android/studio/install/2024.3.1.14/android-studio-2024.3.1.14-windows.exe) (1.22 GB) - [android-studio-2024.3.1.14-windows.zip](https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2024.3.1.14/android-studio-2024.3.1.14-windows.zip) (1.23 GB) > 注: 上述版本发布时间为 2025 年 3 月 24 日. 如需下载其他版本, 或上述链接已失效, 可访问 [Android Studio 发行版本归档](https://developer.android.com/studio/archive?hl=en) 页面. 安装或解压上述文件, 运行 Android Studio 软件 (如 `"D:\android-studio\bin\studio64.exe"`). #### Android SDK 准备 > 注: 如果计算机系统已安装 Android SDK (安卓软件开发工具包), 则可跳过此小节内容. 在 Android Studio 软件中使用快捷键 `CTRL + ALT + S` 打开设置页面: ```text 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` 打开设置页面: ```text Appearance & Behavior (外观与表现) -> System Settings (系统设置) -> Android SDK (安卓软件开发工具包) -> SDK Tools (SDK 工具) (位于右侧窗口) ``` 勾选 `Show Package Details (显示包详情)`, 依次点击 NDK 及 CMake, 确保相应版本的工具已勾选, SDK 工具的版本信息位于 AutoJs6 项目根目录的 `version.properties` 文件中. #### JDK 准备 AutoJs6 项目依赖的 `JDK (Java 开发工具包)` 发行版本不低于 `17`, 但建议不低于 `19`. 截至 2025 年 4 月 13 日, AutoJs6 可支持 JDK 最高版本为 `24`. > 注: 如果计算机系统已安装 JDK 且版本满足上述要求, 则可跳过此小节内容. JDK 可使用 IDE 直接下载, 或访问 [Oracle 网站](https://www.oracle.com/java/technologies/downloads/) 下载. 在 Android Studio 软件中使用快捷键 `CTRL + ALT + S` 打开设置页面: ```text 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 (分布式版本控制系统)](https://git-scm.com/download). #### AutoJs6 项目构建克隆完成后, 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)](http://issues.autojs6.com) 页面. > 注: 关于如何构建并运行应用的更多内容, 可参阅 [Android Docs](https://developer.android.com/studio/run?hl=zh-cn) #### AutoJs6 项目部署 (运行 App) 项目构建成功后, 可将项目作为应用程序 (简称 App) 部署到实体设备 (如手机/平板电脑) 或虚拟设备 (如 Android 模拟器) 中. - 在 `Toolbar (工具栏)` 中, 从 `Run/Debug Configurations (运行/调试配置)` 菜单中选择 `app`, 这是 AutoJs6 的主应用 - 在右侧 `Available Devices (可用设备)` 菜单中, 选择需要运行项目 App 的设备 (实体设备或虚拟设备) - 点击右侧的 `Run (运行)` 按钮 (形如三角形) 开始运行项目, 默认快捷键为 `F10` - 等待部署完成, 指定设备将自动安装并运行项目 App #### AutoJs6 项目部署 (生成 APK) 打包项目并生成可安装到安卓设备的 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](https://developer.android.com/build/build-for-release?hl=zh-cn) #### AutoJs6 预置 Gradle 构建任务除了构建项目 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 声明文件](http://dts-project.autojs6.com) 项目. 任务运行后生成一个 AutoJs6 项目最新的 JAR 文件, 利用 [Android d.ts Generator](https://github.com/NativeScript/android-dts-generator) (by [NativeScript](https://github.com/NativeScript)) 工具可生成 AutoJs6 主应用的声明文件 (d.ts 格式). - AutoJs6 [app:digest] 附加摘要信息到 release 版本编译产生的 APK 文件, 主要服务于 AutoJs6 发布最新版本到 GitHub 前确定最终的文件名. 以下为附加摘要信息前后的文件名对比: ```text 前: autojs6-v6.6.2-arm64-v8a.apk 后: autojs6-v6.6.2-arm64-v8a-0f2a9d74.apk ``` > 参阅: [Android Docs](https://developer.android.com/studio/run?hl=zh-cn) ****** ### 脚本开发辅助 ****** 开发 AutoJs6 可运行的脚本, 需使用合适的开发工具: - [VSCode](https://code.visualstudio.com/download) / [WebStorm](https://www.jetbrains.com/webstorm/download/) / [HBuilderX](https://www.dcloud.io/hbuilderx.html) ... 如需在 PC 上进行脚本编写与调试, VSCode 插件可以实现 PC 与手机的互联: - [AutoJs6-VSCode-Extension](http://vscext-project.autojs6.com) - AutoJs6 调试器 (VSCode 平台插件) 使用开发工具编写代码时, 代码智能补全功能可以更好地辅助开发者完成代码编写: - [AutoJs6-TypeScript-Declarations](http://dts-project.autojs6.com) - AutoJs6 声明文件 (代码智能补全) 编写代码时, AutoJs6 相关 API 及使用方式, 可随时查阅应用文档: - [AutoJs6-Documentation](http://docs-project.autojs6.com) - AutoJs6 应用文档现有的脚本开发项目可作为参考, 激发个人脚本项目的创作灵感: - [Ant-Forest](https://github.com/TonyJiangWJ/Ant-Forest) - 蚂蚁森林能量自动收取脚本 by [TonyJiangWJ](https://github.com/TonyJiangWJ) - [Ant-Forest](https://github.com/SuperMonster003/Ant-Forest) - 蚂蚁森林能量自动收取脚本 by [SuperMonster003](https://github.com/SuperMonster003) - [autojs](https://github.com/e1399579/autojs) - Auto.js 实用脚本 by [e1399579](https://github.com/e1399579) - [autojsDemo](https://github.com/snailuncle/autojsDemo) - Auto.js 演示示例 by [snailuncle](https://github.com/snailuncle) - [autojs 相关仓库](https://github.com/topics/autojs) - GitHub 与 autojs 话题相关的全部仓库 ****** ### 贡献参与 ****** 感谢每一位参与 AutoJs6 项目开发的贡献人员. | 贡献人员 | 提交数 | 最近提交 | |:-------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------:| | [luckyloogn](https://github.com/luckyloogn) | [3](https://github.com/SuperMonster003/AutoJs6/commits?author=luckyloogn) | `2025/01/01` | | [kvii](https://github.com/kvii) | [1](https://github.com/SuperMonster003/AutoJs6/commits?author=kvii) | `2024/10/16` | | [chenguangming](https://github.com/chenguangming) `(Tom)` | [2](https://github.com/SuperMonster003/AutoJs6/pulls?q=is%3Apr+author%3Achenguangming) | `2024/05/14` | | [LZX284](https://github.com/LZX284) `(AI)` | [17](https://github.com/SuperMonster003/AutoJs6/commits?author=LZX284) | `2023/11/19` | | [TonyJiangWJ](https://github.com/TonyJiangWJ) | [4](https://github.com/SuperMonster003/AutoJs6/commits?author=TonyJiangWJ) | `2023/10/31` | | [little‑alei](https://github.com/little-alei) `(抠脚本人)` | [12](https://github.com/SuperMonster003/AutoJs6/commits?author=little-alei) | `2023/07/12` | | [aiselp](https://github.com/aiselp) | [6](https://github.com/SuperMonster003/AutoJs6/pulls?q=is%3Apr+author%3Aaiselp) | `2023/06/14` | | [LYS86](https://github.com/LYS86) `(Lin)` | [2](https://github.com/SuperMonster003/AutoJs6/commits?author=LYS86) | `2023/06/03` | 数据更新于 2025 年 1 月 1 日. 数据条目按 `最近提交` 降序排序. 新发起的暂未处理的 Pull Request, 将在合并处理后加入数据统计. 部分贡献人员在 [GitHub Contributors](https://github.com/SuperMonster003/AutoJs6/graphs/contributors) 未能正常出现, 其提交记录为空, 仍可通过 [Pull Request](https://github.com/SuperMonster003/AutoJs6/pulls) 查看贡献记录. [//]: # ( # --------------------------------------------------------------# # Before committing and pushing to the remote GitHub repository # # --------------------------------------------------------------# - CHANGELOG.md - Update entries for AutoJs6 by checking all changed files - Update entries for Gradle plugins [ implementation ] - Update version name and released date - Append related GitHub issues to changelog entries - README.md - The summary of the latest changelog for committing to Git [ DO NOT commit or push ] - Update badges like [ android studio / rhino / ... ] - Update android studio download links and version names - Update contribution section - Remove the part like [ alpha / beta / ... ] of VERSION_NAME in version.properties - Update dependencies TypeScript declarations if needed. - Re-generate documentation/markdown by running the python script - Check the two-way versions for AutoJs6 and VSCode ext, then publish the ext to Microsoft - Run Gradle task "app:assembleInrtRelease" - Build APK to determine the final VERSION_BUILD field - Run Gradle task "app:appendDigestToReleasedFiles" - Commit and push to GitHub - Publish the latest release with signed APKs )