官方网站:官方网站地址

官网文档提取镜像网址:官方文档提取镜像

该笔记是为了防止以后遗忘掉，所以记录下基础的知识方便以后可以快速上手。

快速上手牢记三个方法：

1：翻看以前的autojs写过的脚本的源码，都是自己写的，很快就能想起来。

2：查找官方函数文档的相关函数说明，很快就能找到一些解释。

3：牢记最基础也是最核心的操作也就是如何确定要操作的控件(唯一性)，总结有以下三个方法基本可满足日常：

     ①depth-desc-id-classname等控件的常规的唯一属性.

     ②findone.parent().child(xx)等控件的父子依存顺序关系.

     ③最后实在无法确定可用坐标法bounds，click(x,y)操作控件

Auto.JS作为一款基于JavaScript语言的一款脚本，基本语法和结构可通过学习JavaScript来了解。要知道，安卓的app界面就是由一堆控件组成的，这些父子控件相互嵌套，组成了我们熟悉的app界面，因此，你要执行自动化操作，那么最常用的就是先精确的找到这个控件(唯一性)，再来说下一步对其进行操作，而我个人认为Auto.JS之所以方便好用，最大的一点就是查找你想要操作的控件(包括但不限于点击、设置文本等)时特别方便明了，一眼就能看懂并能迅速定位。

比如，在Auto.JS悬浮窗点击[探测]按钮(图1.1)，选择[布局范围分析]，之后Auto.JS会自动分析当前范围界面的控件组成，在分析探测完成后(图1.2)，可以点击[查看控件信息]来查看想要操作的控件的各种属性，控件最基本也最常见的属性有：

 在这里以右上角的【⋮】按钮为例，我想要点击它，那么先查看其控件属性(图1.3)，如其所示，在该控件的诸多属性里，有此控件的bounds()，id()，className()，depth()，desc()等(图1.4)，这就是该按钮所有的特性，同样的，其他控件也同此控件一样，具有这些属性，我们要利用Auto.JS执行自动化操作，核心无非就是利用各种方法先找到这个控件，其次再操作这个控件。因此，学习Auto.JS的基础部分就是学习如何唯一的确定想要操作的控件。

通过查看这些属性，我们不难发现有其中一项属性desc("更多选项")，很可能是不和其他控件相同的，也就是此控件属性具有唯一性，能唯一的确定此控件，这个属性就是我们要找的。因此，我们想要对其进行操作只需要：

上述代码执行后，在该界面时，desc("更多选项")首先会被查找(findonce)，查找后执行点击(click)，从而【⋮】按钮也就被点击了。总结下无非就是我们找到了此按钮的唯一控件属性desc("更多选项")从而再对其操作，仅此而已。

另外，加上“.exist()”是为了增加程序鲁棒性，万一控件不存在或者没找到，则程序不会执行，否则对不存在(或没找到)的控件操作会抛出异常。基于此，往往要判定控件存在与否后再进行操作，而“.exist()”返回的是一个布尔值，方便后续进行判断和操作。另外一个常用的操作就是加上“while(!)”死循环等待控件出现，如：

当分析了很多控件后不难发现，控件的文本信息往往是以desc或text属性来呈现的，比如一个该按钮名为"更多选项"，其控件的desc属性或text属性就是其按钮名字，确定其名字也就确定了此控件，针对此按钮具体来说，就是其desc属性是"更多选项"。（此处要说的意思就是要具体问题具体分析，文本信息不是desc就是text，如果是desc属性就操作desc，是text属性就操作text）但是，往往就有时候我们只知道包含的部分desc或text，这时候可用这四个函数来确定：

当然，更多情况是desc和text属性并不能唯一确定要操作的控件，我们往往用其他属性(常用的有className、id、depth等)一起叠加使用来尽可能的使之唯一，比如：

 需要注意的是：在不同的Android系统上，同一版本的app的控件属性可能会变化。同样，app版本更新后，控件属性、布局也可能发生变化，所以，若要对不同版本不同系统具有兼容性，应尽可能选择不变化的控件属性。

有时候，控件属性是变化的、随机的，这时候我们便不能通过控件的本身固有属性如id，className，depth等来唯一的确定出需要的控件，这时候我们可以通过控件之间的上下级关系(也叫父子关系)来确定出需要操作的控件。

首先需要了解的是控件间的依存关系，还是以之前的app界面为例，我们这次来分析右下角的的“+”号按钮，和之前一样利用Auto.JS分析控件布局，我们点击右下角的“+”号按钮，点击[在布局层次中查看]，便可以查看当前控件在整个布局层次中的上下级关系(父子关系)，如图1.6所示，不难发现，从上到下，左侧五颜六色的竖棍丨就代表着其层级关系，竖棍丨越多也就越处于底层，该“+”号按钮控件名为“ImageButton”，对应着拥有8根竖棍丨，所以其是在第八级。

另外，和“ImageButton”平级的控件是图1.6所示的8.2—“ImageView”控件，“ImageButton”的父控件也就是它的上级控件是图1.6所示的7.3—“android.view.View”控件，所以我们可以建立以下关系：

                                      8.1中“ImageButton”的parent() = 7.3中“android.view.View”

                                      7.3中“android.view.View”的child(0) = 8.1中“ImageButton”

                                      7.3中“android.view.View”的child(1) = 8.2中“ImageView”

                                      7.3中“android.view.View”的parent() = 6中“android.view.View”

                                      6中“android.view.View”的child(0)  = 7.1中“LinearLayout”

                                      6中“android.view.View”的child(1)  = 7.2中“android.view.View”

                                      6中“android.view.View”的child(2)  = 7.3中“android.view.View”

 建立了以上隶属关系，我们就可以通过唯一确定任意其中一个不变的固定控件，便可通过控件间的隶属关系来确定我们想要的控件，从而规避了我们要找的控件属性动态变化这一情况。

 在这里，我们假定以之前右上角的【⋮】按钮为固定控件(因为"更多选项"这几个字基本不会变化)，通过【⋮】按钮来和控件间的父子关系来确定出右下角的“+”号按钮。

首先分析右上角的【⋮】按钮的层级关系，如图1.7所示，【⋮】按钮位于第10级，它的父级parent是图1.7所示的9.3—“android.support.v7.widget.LinearLayoutCompat”，9.3的父级是8—“android.view.View”,以此类推，发现我们想要操作的控件也就是“ImageButton”控件(8.1)和右上角的【⋮】按钮即“ImageView”控件(10)关系是：

                                  “ImageView”控件(10)是从7.1—“LinearLayout”继承下来的；

                                  “ImageButton”控件(8.1)是从7.3—“android.view.View”继承下来的；

                                     而7.1和7.3是平级关系，拥有共同的父级6—“android.view.View”

明白了这一点，我们便可通过【⋮】按钮(10)来确定右下角的“+”号按钮(8.1)，如下所示：

 此处例子里的的两个控件【⋮】按钮(10)和右下角的“+”号按钮(8.1)之间相差了很多层，因此显着有些复杂，在实际情况中，我们往往不需要跨越这么多的层级来确定控件，一般情况下不会那么复杂。实际上，父子关系嵌套两三层往往即可确定出另一控件。最后，在这里需要注意的是，确定控件时要加上“.findone()”，此方法调用后会返回所有符合条件的控件集合。因此，首先要找到一个不容易变化的或容易找的控件“.findone()”后再在此基础上进行“.parent()”“.child(index)”操作找到另一控件。

如果一个控件本身无法通过click()点击，那么我们可以利用bounds()函数获取其坐标，再利用坐标点击。总体来说，基于坐标来确定要操作的控件比较简单，核心是确定要操作的控件的坐标即可。Auto.JS里可以直接获取控件的坐标，每一个控件包含其“.bounds()”属性，bounds()其实表示的是一个范围矩阵。此处还是以右下角的“+”号按钮为例，查看控件属性信息，包含“.bounds()”属性如下图：

从上图看，bounds()属性是四个坐标值，其分别为(left, top, right, buttom)，各值含义如图1.9所示：

                                                                left：控件左边缘与屏幕左边的距离

                                                                top：控件上边缘与屏幕上边的距离

                                                                right：控件右边缘与屏幕左边的距离

                                                                buttom ： 控件下边缘与屏幕上边的距离

因此，在获得控件的坐标bounds()属性后，就可以对控件执行基于坐标的操作，常见的操作有：

                                                 bounds().left：长方形左边界的x坐标

                                                 bounds().right：长方形右边界的x坐标

                                                 bounds().top：长方形上边界的y坐标

                                                 bounds().bottom：长方形下边界的y坐标

                                                 bounds().centerX()：长方形中点x坐标

                                                 bounds().centerY()：长方形中点y坐标

                                                 bounds().width()：长方形宽度也就是控件宽度

                                                 bounds().height()：长方形高度也就是控件高度

                                                 click(x,y)：坐标(x,y)处执行点击操作  //注意:安卓7以下点击需要root权限且函数为Tap(x,y)

                                                 bounds(left, right, top, bottom).clickable().click()：点击该长方形区域

另外，因为不同设备的分辨率大小是不同的，那么我们click(x,y)在不同分辨率下就会出错，Auto.JS针对这一问题内置了一个函数"setScreenMetrics(width, height)"，具体用法如下：

   当我们使用540，960分辨率的设备（x，y各缩小了一半）后执行上述代码时，他会自动计算缩放的比例，从而实际点击的是坐标(400，100)和（150，250）这两个坐标值。

当然，基于坐标的操作不仅有click()操作，常用的还有swipe()滑动操作，gesture()手势滑动操作等，具体可查看官方文档，在这里仅对swipe()，gesture()这两个函数进行介绍。

swipe(x1,y1,x2,y2,time)：(x1,y1)代表起始点坐标，(x2,y2)代表终点坐标，time代表滑动所需要的时间

//注意：安卓7以下的滑动需要root权限，且函数名变为Swipe(x1,y1,x2,y2,time)

gesture(time,[x1,y1],[x2,y2],[x3,y3]...)：time同，(x1,y1)是起始点坐标，(x2,y2)是途径点坐标，最后一个坐标是终点

下面以一个某APP注册时的滑动验证为例(为防止被人恶意利用，在此打上码。再次声明，此处做仅举例用，所有代码仅供学习交流！)，如图2.0所示，当我们输入手机号点击注册时，此时需要将滑块拖动到指定位置处才可以发送验证码从而进行下一步的注册。在这里，我们将想要拖动的滑块称为控件①，想要拖到的目标处称为控件②。那么，如果想要实现一个自动化拖动首先就要确定的是控件①和控件②的坐标，又因为其坐标每次都是随机的，所以只需要根据两个控件的特有属性唯一确定出控件①和控件②，再每次获取其坐标即可。

通过对两个控件的属性分析，如图2.1所示，我们不难发现，控件①和控件②的indexInParent()不同，因此可通过此分别唯一的定位出两个控件，确定控件后，我们再调用swipe()或gesture()函数来执行滑动，从而实现自动滑动的操作。

具体实现代码如下：

click是点击操作，实际上，使用click函数我们可以对坐标进行点击，也可以对控件进行点击，最后也可以对某些特定字符点击，总结如下：

之前说过，根据我们设定的一些属性，我们可以对屏幕上的控件进行搜索和查找，并返回符合条件的控件。因此，想要对返回的控件进行下一步操作的前提是必须要“.findone()”，如前面所述，要想从父子关系查找关联控件必须先“.findone().parent()”,再比如要想获取控件的坐标矩阵也必须“.findone().bounds()”。三个搜索函数“.find()” “.findone()” “.findonce()”在使用上是有点差别的，具体如下：

Auto.JS上下滑动可以是对整个屏幕的滑动或对某特定控件的滑动，对整个屏幕滑动如下例2.3.1所示：

例2.3.1：

在很多时候，我们经常会见到className名为“.ListView”的控件，实际上其往往是充当装在很多list的集合，以此控件为例，我们可以实现对此控件的上下滑动，如下例2.3.2所示：

例2.3.2：

 在此只是以“.ListView”的控件进行举例，实际使用过程中，只要控件是可上下滑动的，都可以调用函数“scrollForward()”和“scrollBackward()”来实现对控件的滑动操作。

因为Auto.JS是基于JavaScript的语言，因此基本的语法结构、很多两者通用的函数等都是可以在JavaScript里面找到，如常见的“.replace()”“.indexof()”“.test()”等这些都在JavaScript网站上有相关的用法说明。可见：JavaScript学习

另外，Auto.JS的一些全局函数如启动程序函数“launch(“XXX”)”，控制台的函数如“console.show()”、“console.log()”等，再如返回函数“back()”，随机函数“random(start,end)”等这些都可在官方的提取文档里找到。可见：Auto.JS官方提取文档

1. 对于文本设置函数“.setText(index,文本内容)”，如果index没有，则默认是在当前页面找所有文本框中填入“文本内容”。

2. 函数“.split("")”可用于分割字符串，比如文本“我爱你中国”会被分成“我”“爱”“你”“中”“国”，可以用在取随机姓名时百家姓的分割。

3.有些控件的“.clickable()”属性是为false的，这意味着你进行click()点击操作会返回false失败，因此，在对控件操作时要注意查看其“.clickable()”属性，如果其不可点击，我们可用一些屏幕点击或坐标点击的方法来对其进行点击。