简介

本项目是用于快速构建AutoJS自动化脚本项目的模板框架，基于webpack进行编译打包，因此需要在电脑上编辑并编译才能使用。纯AutoJS版本的见AutoScriptBase
相对于AutoScriptBase，本项目的优势在于，可以将脚本编译成独立的文件，可以对其进行混淆和加密。比如配合加解密插件（暂不开源）来保护自己的代码，即便不加密其混淆后的代码也是很难被人盗用编辑的。
autojs-webpack打包的插件和loader均借鉴自：https://github.com/snailuncle/webpack-autojs，优化了对webpack5的兼容和部分语法的适配。
目前已实现的功能如下：
- 图形化配置，基于Vue开发的可视化界面 可视化配置，适合无安卓开发基础的前端人员编写界面
- 多脚本执行调度，防止多个不同脚本抢占前台 RunningQueueDispatcher
- 封装了支持多脚本锁的 LockableStorage，阻塞写入并返回写入成功与否，达到锁互斥的目的
- 封装了基于文本、ID控件正则查找工具 WidgetUtils，支持控件等待，批量获取匹配控件等等
- 日志工具 LogUtils，可以保存日志到文件，支持日志级别 error\warn\info\log\debug，不同级别日志控制台中不同颜色显示，且开启日志文件后写入到不同的文件中。
  - 日志支持同步写入文件和异步写入文件两种方式，写这个仅仅是想要实现双缓冲异步写入这么个东西
  - 异步方式的日志文件不是立马刷新到文件的，在脚本完全执行完毕之后才会完全写入
  - 因此如果需要性能则选择启用异步方式，否则使用同步就行。
- 日志文件查看工具 查看日志.js 可以查看当前脚本执行时所创建的日志信息用于分析问题
- 支持 github release api 的脚本手动更新功能，支持自动检测更新，如需自动执行更新可以修改相关代码实现
- 支持自动判断Root和无障碍的自动化执行操作 Automator
- 封装了一个文本悬浮窗工具 FloatyUtil
- 支持自动解锁设备，也支持扩展自定义解锁
- 支持模拟手势自动锁定屏幕，同时支持扩展自定义锁屏代码
- 支持支付宝手势解锁
- 支持通过代码添加定时任务 Timers 来自作者 SuperMonster003
- 支持自动点击授权截图权限 TryRequestScreenCapture 来自作者 SuperMonster003
- 支持配置信息导入和导出以及配置信息加密
- 支持通过ADB授权之后自动开启无障碍功能，具体如何使用ADB请自行Google或Baidu。不同的软件请自行替换包名: Pro版为 org.autojs.autojspro 可以通过 context.getPackageName() 获取
```
adb shell pm grant org.autojs.autojs android.permission.WRITE_SECURE_SETTINGS
```
- ADB的详细使用介绍
- 封装了常用方法 CommonFunction 如保存运行时数据，倒计时延迟等等
- lib/autojs-tools.dex 中封装了更新用的一些Java方法，用于优化脚本执行性能，源码见auto-js-tools
- 执行 独立工具/布局分析悬浮窗.js 可以查看当前页面中的控件文本以及id信息方便开发脚本
具体使用详见各个js文件中的说明信息

目前基于此项目实现的脚本

暂无

纯AutoJS版本

AutoScriptBase

开发说明

首先安装node环境

前往 Node.js下载下载适合自己系统的Node.js并安装
安装完在 终端/命令提示符 中运行: npm -v 检查是否安装成功

代码编写

1. 下载本仓库
1. 进入本仓库代码所在文件夹，运行 npm install 自动下载依赖。

修改 src/simpleConfig.js 中的 CONFIG_STORAGE_NAME 和 PROJECT_NAME

  // 不同项目需要设置不同的storageName，不然会导致配置信息混乱
  let CONFIG_STORAGE_NAME = 'autoscript_version'
  let PROJECT_NAME = 'AutoJS 脚手架'

开发一个主业务逻辑代码，替换 main.js 中的 mainLoop() 方法比如创建 src/core/MainRunner.js 内容参考如下

  function MainRunner() {

    this.exec = function () {
      // 执行主要业务逻辑
    }
  }
  module.exports = new MainRunner()

再在 main.js 中调用:

  let mainExecutor = require('./core/MainExecutor.js')

  //....main.js 中的共有代码可以酌情修改 或者直接不动也可以

  // 开发模式不包裹异常捕捉，方便查看错误信息
  if (config.develop_mode) {
    mainExecutor.exec()
  } else {
    try {
      mainExecutor.exec()
    } catch (e) {
      commonFunctions.setUpAutoStart(1)
      errorInfo('执行异常, 1分钟后重新开始' + e)
      commonFunctions.printExceptionStack(e)
    }
  }

  //....

1. 修改完毕后，运行 npm run dev 生成未压缩的代码，然后将 dist 下的文件复制到手机根目录 脚本 文件夹下，如 /脚本/AutoScriptBaseWP/。
1. 在手机端调试验证功能逻辑是否正常，确认需要发布时，运行 npm run build 生成压缩后的代码。同样复制 dist 下的文件到手机里即可。
1. 打开AutoJS软件，下拉刷新就能看到AutoScriptBaseWP，点击进入然后运行 main.js 即可
- 5.1 脚本执行依赖于无障碍服务，请在自动弹出界面中打开AutoJS的无障碍权限，或者直接通过ADB赋权让脚本自动获取无障碍权限
- 5.2 另外其他需要的应用权限有 后台弹出界面 显示悬浮窗 修改系统配置（可选） 等

其他说明

npm run build 时默认启用混淆代码，所使用的插件为 javascript-obfuscator，具体配置见obfusConfig.js，配置参数详情见官方文档。如不需要自行剔除插件即可

每个独立入口文件都需要定义在 webpack.config.js 中，将会在dist中独立打包成一个文件，具体配置参考如下:

  entry: {
    "可视化配置": './src/可视化配置.js', 
    'handler/CrashCatcher': './src/lib/prototype/CrashCatcher.js',
    'main': './src/main.js',
    '独立工具/布局分析悬浮窗': './src/独立工具/布局分析悬浮窗.js',
    '独立工具/获取当前页面的布局信息': './src/独立工具/获取当前页面的布局信息.js',
    '独立工具/挂起所有脚本': './src/独立工具/挂起所有脚本.js',
    '独立工具/灰度取色': './src/独立工具/灰度取色.js',
    'update/检测更新': './src/update/检测更新.js',
    'update/历史版本下载': './src/update/历史版本下载.js',
  },

目前未对打包编译的文件进行拆分，因此上述独立文件体积都会比较大

发布更新

修改 src/simpleConfig.js 中的 github_latest_url，改为实际你自己仓库的release地址即可参考如下：

// github release url 用于检测更新状态
github_latest_url: 'https://api.github.com/repos/TonyJiangWJ/AutoScriptWB/releases/latest',

需发布时，可以参考本项目，创建一个release分支，只保存 npm run build 编译生成的 dist 下的内容。然后在github上对该分支创建发布包即可，后续运行 update/检测更新.js 便可以实现在线更新。
或者也可将源码仓库和发布仓库拆分开，发布仓库保存 dist 下的内容，修改上述配置文件中的 github_latest_url 为实际仓库的发布地址即可

开发辅助

在线取色工具：图片base64取色
在线多点取色路径生成: 多点取色辅助工具
可视化配置工具，基于webview和vue框架实现，H5内容在vue_configs下，新增配置项可以只修改vue_configs/js/commponets/configuration/*.js 和 config.js 两个文件，其他作为公用的可以不关注。如果会vue那么可以随你所想进行修改。后续版本计划将改为webpack打包的vue代码。
控件可视化辅助工具电脑上浏览器打开 控件可视化/index.html 按界面提示操作

lib下的js说明

WIKI_FOR_LIBS