Auto.js 和 Autox.js

简介

Auto.js是一个支持无障碍服务的Android平台上的JavaScript运行环境和开发环境，其发展目标是类似JsBox和Workflow。

由于原作者不再维护Auto.js项目，我计划在原来基础上继续维护该项目。本项目从autojs分叉，并将原项目命名为Autox.js。你现在看到的是基于原4.1版本的项目。接下来我将介绍如何开发和运行这个项目。欢迎更多开发者参与项目的维护和升级。最新的Autox.js地址。文档中很多原项目路径，在原项目未删除的情况下我并不打算替换，以表对原作者的尊重。这篇文档中有关加密的内容可能与实际运行情况有出入。如果你希望对代码进行加密以保护知识产权，请参考项目https://github.com/kkevsekk1/webpack-autojs。我会逐步完善更新程序代码，尽量保持一致。

本项目源自hyb1996的autojs，并命名为Autox.js（autojs的修改版本）。你现在看到的是基于原4.1版本的项目。接下来我们将介绍如何开发和运行这个项目，欢迎更多开发者参与项目的维护和升级。hyb1996采用Mozilla Public License Version 2.0+非商业性使用许可证。出于多方面考虑，本产品采用GPL-V2许可证。无论是其他贡献者还是使用者，均需遵守MPL-2.0+非商业性使用和GPL-V2的相关要求。

关于两种协议：

GPL-V2：https://opensource.org/licenses/GPL-2.0
MPL-2：(https://www.mozilla.org/MPL/2.0)

现在的Autox.js：

Autox.js文档：http://doc.autoxjs.com/
开源地址：https://github.com/kkevsekk1/AutoX
PC端开发VS Code插件
官方论坛：www.autoxjs.com
autoxjs更新日志

欢迎点赞

Autox.js下载地址：

https://github.com/kkevsekk1/AutoX/releases
如果下载速度过慢，可以右键复制Release Assets中APK文件的链接地址，粘贴到http://toolwa.com/github/等GitHub加速网站下载。

APK版本说明：

universal：通用版（不在乎安装包大小或懒得选就用这个版本，包含以下2种CPU架构so）
armeabi-v7a：32位ARM设备（备用机首选）
arm64-v8a：64位ARM设备（主流旗舰机）

特性

基于无障碍服务实现的简单易用的自动操作函数
悬浮窗录制和运行
更专业&强大的选择器API，提供对屏幕上控件的查找、遍历、获取信息、操作等功能。类似于Google的UI测试框架UiAutomator，您也可以将其作为移动版UI测试框架使用
采用JavaScript作为脚本语言，并支持代码补全、变量重命名、代码格式化、查找替换等功能，可作为JavaScript IDE使用
支持使用e4x编写界面，并可将JavaScript打包为apk文件，您可以用它来开发小工具应用
支持使用Root权限以提供更强大的屏幕点击、滑动、录制功能和运行shell命令。录制可生成js文件或二进制文件，录制动作的回放比较流畅
提供截取屏幕、保存截图、图片找色、找图等函数
可作为Tasker插件使用，结合Tasker可胜任日常工作流
带有界面分析工具，类似Android Studio的LayoutInspector，可以分析界面层次和范围、获取界面上的控件信息

本软件与按键精灵等软件的主要区别是：

Auto.js主要以自动化、工作流为目标，更多地是方便日常生活工作，例如启动游戏时自动屏蔽通知、一键与特定联系人微信视频（知乎上出现过该问题，老人难以进行复杂的操作和子女进行微信视频）等
Auto.js兼容性更好。以坐标为基础的按键精灵、脚本精灵很容易出现分辨率问题，而以控件为基础的Auto.js则没有这个问题
Auto.js执行大部分任务不需要root权限。只有需要精确坐标点击、滑动的相关函数才需要root权限
Auto.js可以提供界面编写等功能，不仅仅是作为一个脚本软件而存在

autojs信息

官方论坛：autojs.org
文档：可在这里查看在线文档。目前文档仍然不完善。
示例：可在这里查看一些示例，或者直接在应用内查看和运行。

架构图

待补充，不过是否有人真对此感兴趣？欢迎联系我交流

关于License

本产品采用GPL-V2许可证

由于历史原因还需遵循autojs项目的协议：

基于Mozilla Public License Version 2.0并附加以下条款：

非商业性使用 — 不得将此项目及其衍生项目的源代码和二进制产品用于任何商业和盈利用途

本Autox.js能否采用GPL-V2?

Regarding GPL-V2, it should be easy to understand, as the famous Linux uses this license. However, for MPL-2.0, many articles still focus on the MPL-1.1 version, causing confusion for many domestic developers. Here is a relatively standard translation for those interested in studying.

Code contributors should note:

If no license is declared in the original text, it is considered MPL-2.0. For new files or modifications (limited to your own) using GPL-V2, a relevant declaration is needed.

// SPDX-License-Identifier: GPL-2.0
// Declare your copyright

Others using Autox.js for deep development, please note:

If you use code or compiled binaries declared as GPL-2.0, you need to open-source all your code.
If you only use MPL-2.0 components, you need to open-source the related code you modified.

Discussing open source and commercial use, apart from this product:

Open source doesn't mean unrestricted use, nor does it prohibit commercial use!
Open source things can be used commercially, but you need to open-source according to regulations!
Commercial products can be open source, like Red Hat!
If you don't follow open source licenses when using open source products, look into the origin of OpenWRT and recent domestic infringement cases!

Regarding whether JS scripts developed by others and run on this platform need to follow GPL-2.0 for open-sourcing:

That's your freedom, not restricted by this agreement, just like running software on Linux.

Can this product or AutoJS products be used commercially?

Whether this product can be used commercially depends on the original AutoJS, as many features and code copyrights belong to AutoJS.
Whether AutoJS can be used commercially depends on your understanding and legal interpretation of the attached "non-commercial use" clause.
In any case, this product won't use AutoJS for commercial purposes.

Compilation related:

Environment requirement: jdk version 17 or above

Command explanation: Run commands in the project root directory. If using Windows PowerShell < 7.0, use commands containing ";"

Install debug version to device locally:

./gradlew app:buildDebugTemplateApp && ./gradlew app:assembleV6Debug && ./gradlew app:installV6Debug
# or
./gradlew app:buildDebugTemplateApp ; ./gradlew app:assembleV6Debug ; ./gradlew app:installV6Debug

The generated debug version APK file is in app/build/outputs/apk/v6/debug, using default signature

Compile release version locally:

./gradlew app:buildTemplateApp && ./gradlew inrt:cp2APP && ./gradlew app:assembleV6
# or
./gradlew app:buildTemplateApp ; ./gradlew inrt:cp2APP ; ./gradlew app:assembleV6

This generates an unsigned APK file in app/build/outputs/apk/v6/release, which needs to be signed before installation

Run debug version to device locally in Android Studio:

First, run the following command:

./gradlew app:buildDebugTemplateApp

Then click the run button in Android Studio

Compile and sign release version locally in Android Studio:

First, run the following command:

./gradlew app:buildTemplateApp

Then click Android Studio menu "Build" -> "Generate Signed Bundle /APK..." -> check "APK" -> "Next" -> select or create a certificate -> "Next" -> select "v6Release" -> "Finish" The generated APK file is in app/v6/release