链接：https://pan.baidu.com/s/12rdtbU83bScF6KPOWKGu4A 

提取码：aarc 

 

Auto.js文档综述

Auto.js使用JavaScript作为脚本语言，目前使用Rhino 1.7.7.2作为脚本引擎，支持ES5与部分ES6特性。

因为Auto.js是基于JavaScript的，学习Auto.js的API之前建议先学习JavaScript的基本语法和内置对象，可以使用教程前面的两个JavaScript教程链接来学习。

如果您想要使用TypeScript来开发，目前已经有开发者公布了一个可以把使用TypeScript进行Auto.js开发的工具，参见Auto.js DevTools。

如果想要在电脑而不是手机上开发Auto.js，可以使用VS Code以及相应的Auto.js插件使得在电脑上编辑的脚本能推送到手机运行，参见Auto.js-VSCode-Extension。

本文档的章节大致上是以模块来分的，总体上可以分成"自动操作"类模块(控件操作、触摸模拟、按键模拟等)和其他类模块(设备、应用、界面等)。

"自动操作"的部分又可以大致分为基于控件和基于坐标的操作。基于坐标的操作是传统按键精灵、触摸精灵等脚本软件采用的方式，通过屏幕坐标来点击、长按指定位置模拟操作，从而到达目的。例如click(100, 200), press(100, 200, 500)等。这种方式在游戏类脚本中比较有可行性，结合找图找色、坐标放缩功能也能达到较好的兼容性。但是，这种方式对一般软件脚本却难以达到想要的效果，而且这种方式需要安卓7.0版本以上或者root权限才能执行。所以对于一般软件脚本(例如批量添加联系人、自动提取短信验证码等等)，我们采用基于控件的模拟操作方式，结合通知事情、按键事情等达成更好的工作流。这些部分的文档参见基于控件的操作和基于坐标的操作。

其他部分主要包括：

app: 应用。启动应用，卸载应用，使用应用查看、编辑文件、访问网页，发送应用间广播等。

console: 控制台。记录运行的日志、错误、信息等。

device: 设备。获取设备屏幕宽高、系统版本等信息，控制设备音量、亮度等。

engines: 脚本引擎。用于启动其他脚本。

events: 事件与监听。按键监听，通知监听，触摸监听等。

floaty: 悬浮窗。用于显示自定义的悬浮窗。

files: 文件系统。文件创建、获取信息、读写。

http: HTTP。发送HTTP请求，例如GET, POST等。

images, colors: 图片和图色处理。截图，剪切图片，找图找色，读取保存图片等。

keys: 按键模拟。比如音量键、Home键模拟等。

shell: Shell命令。

threads: 多线程支持。

ui: UI界面。用于显示自定义的UI界面，和用户交互。

除此之外，Auto.js内置了对Promise。

Q & A

如何定时运行脚本

点击脚本右边的菜单按钮->更多->定时任务即可定时运行脚本，但是必须保持Auto.js后台运行(自启动白名单、电源管理白名单等)。同时，可以在脚本的开头使用device.wakeUp()来唤醒屏幕；但是，Auto.js没有解锁屏幕的功能，因此难以在有锁屏密码的设备上达到效果。

定时任何如何获取外部参数

如果一个脚本是用intent"启动"的，比如定时任务中的特定事件（网络状态变化等）触发而启动的，则可以通过engines.myEngine().execArgv.intent获取启动的intent，从而获取外部参数。

如何把图片和脚本一起打包，或者打包多个脚本

如果除了单脚本以外还有其他脚本、图片、音乐等资源一起打包，则需要使用项目功能。

点击Auto.js的"+"号，选择项目，填写项目名称、包名等信息以后，点击"√"即可新建一个项目。可以在项目中放多个脚本、模块、资源文件，点击项目工具栏的apk打包图标即可打包一个项目，点击工具栏可以重新配置项目。

例如，主脚本要读取同一文件夹下的图片1.png，再执行找图，则可以通过images.read("./1.png")来读取，其中"./1.png"表示同一目录1.png图片；ui中的图片控件要引用同一文件夹的2.png图片则为<img src="file://2.png"/>。Auto.js内置的函数和模块都支持相对路径，但是，其他情况则需要使用files.path()函数来把相对路径转换为绝对路径。

如何使打包的应用不显示主界面

需要使用项目功能。新建项目后，修改项目下的project.json文件，增加以下条目：

"launchConfig": {

    "hideLogs": true

}

例如：

{

  "name": "项目名称",

  "versionName": "1.0.0",

  "versionCode": 1,

  "packageName": "org.autojs.example",

  "main": "main.js",

  "launchConfig": {

      "hideLogs": true

  }

}

"launchConfig"表示启动配置，"hideLogs"表示隐藏日志。

参见项目与项目配置。

Auto.js自带的模块和函数中没有的功能如何实现

由于Auto.js支持直接调用Android的API，对于Auto.js没有内置的函数，可以直接通过修改Android代码为JavaScript代码实现。例如旋转图片的Android代码为：

import android.graphics.Bitmap;

import android.graphics.Matrix;

 

public static Bitmap rotate(final Bitmap src,

                            final int degrees,

                            final float px,

                            final float py) {

    if (degrees == 0) return src;

    Matrix matrix = new Matrix();

    matrix.setRotate(degrees, px, py);

    Bitmap ret = Bitmap.createBitmap(src, 0, 0, src.getWidth(), src.getHeight(), matrix, true);

    return ret;

}

转换为JavaScript的代码后为：

importClass(android.graphics.Bitmap);

importClass(android.graphics.Matrix);

 

function rotate(src, degrees, px, py){

    if (degrees == 0) return src;

    var matrix = new Matrix();

    matrix.setRotate(degrees, px, py);

    var ret = Bitmap.createBitmap(src, 0, 0, src.getWidth(), src.getHeight(), matrix, true);

    return ret;

}

有关调用Android和Java的API的更多信息，参见Work with Java。