auto.js

开发文档

1. 环境搭建

手机安装auto.js，打开无障碍权限和悬浮窗
电脑安装vscode，并安装auto.js-vscodeext插件。安装插件后，可使用一下命令：

按 Ctrl+Shift+P 或点击”查看”->”命令面板”可调出命令面板，输入 Auto.js 可以看到几个命令：

Start Server: 启动插件服务。之后在确保手机和电脑在同一区域网的情况下，在Auto.js的侧拉菜单中使用连接电脑功能连接。
Stop Server: 停止插件服务。
Run 运行当前编辑器的脚本。如果有多个设备连接，则在所有设备运行。
Rerun 停止当前文件对应的脚本并重新运行。如果有多个设备连接，则在所有设备重新运行。
Stop 停止当前文件对应的脚本。如果有多个设备连接，则在所有设备停止。
StopAll 停止所有正在运行的脚本。如果有多个设备连接，则在所有设备运行所有脚本。
Save 保存当前文件到手机的脚本默认目录（文件名会加上前缀remote)。如果有多个设备连接，则在所有设备保存。
RunOnDevice: 弹出设备菜单并在指定设备运行脚本。
SaveToDevice: 弹出设备菜单并在指定设备保存脚本。
New Project（新建项目）：选择一个空文件夹（或者在文件管理器中新建一个空文件夹），将会自动创建一个项目
Run Project（运行项目）：运行一个项目，需要Auto.js 4.0.4Alpha5以上支持
Save Project（保存项目）：保存一个项目，需要Auto.js 4.0.4Alpha5以上支持

启用start server，然后手机连接电脑ip，需要手机和电脑在同一个区域网下。可通过cmd执行ipconfig查看电脑ip
编写脚本，按快捷键F5即可在手机上测试脚本。

2. 开发说明

2.1 定义变量与输出

与es6一致, 不详细列举了

// 定义变量
var str = "我是字符串"

// 输出
log(str)
console.log(str)
toastLog(str) // 相当于log(str) + toast(str)

2.2 循环

这里也只列举两种特殊点的

// 无限循环
var i = 0
console.log(i)

while (true) {
  i = i + 1
  console.log(i)
  if (i == 100) {
    break
  }
}


var i = 1
switch (i) {
  case 0:
    console.log(0)
  case 1:
    console.log(1)
}

2.3 设备操作

console.log(device)
console.log(device.getIMEI())//返回设备的IMEI.(没获取到,应该是华为手机的原因)
console.log(device.getAndroidId())//返回设备的Android ID。
device.keepScreenOn()//一直保持屏幕常亮
device.cancelKeepingAwake()//来取消屏幕常亮。

2.4 节点操作

var sendButton = text("发送").findOne();
sendButton.click();

主要还有以下几种属性：

className 类名。类名表示一个控件的类型，例如文本控件为”android.widget.TextView”, 图片控件为”android.widget.ImageView”等。
packageName 包名。包名表示控件所在的应用包名，例如QQ界面的控件的包名为”com.tencent.mobileqq”。
bounds 控件在屏幕上的范围。
drawingOrder 控件在父控件的绘制顺序。
indexInParent 控件在父控件的位置。
clickable 控件是否可点击。
longClickable 控件是否可长按。
checkable 控件是否可勾选。
checked 控件是否可已勾选。
scrollable 控件是否可滑动。
selected 控件是否已选择。
editable 控件是否可编辑。
visibleToUser 控件是否可见。
enabled 控件是否已启用。
depth 控件的布局深度。