# autojs-vue

**Repository Path**: motongbike/autojs-vue

## Basic Information

- **Project Name**: autojs-vue
- **Description**: 帮助开发者生产更友好的AutoJS程序
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 127
- **Created**: 2022-01-10
- **Last Updated**: 2022-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 
# AutoJs-Vue 特性

## 帮助开发者,快速生产友好的AutoJS程序
## 
#### 1. 全面支持(信息量很大):  
[AutoJS](https://hyb1996.github.io/AutoJs-Docs/#/)：全接口支持

[VUE](https://cn.vuejs.org/)：著名的渐进式JavaScript框架(傻瓜->高手),

[color-Ui](http://demo.color-ui.com/)：优雅的前端视觉交互设计(默认内置，也可以换成其他UI框架)

[HTML5plus](http://www.html5plus.org/doc/)：让JS拥有与App一样的能力标准

[组件](https://uniapp.dcloud.io/component/README)，[API](https://uniapp.dcloud.io/api/README)，
[框架](https://uniapp.dcloud.io/collocation/App)：增强APP的手机系统访问功能

[插件社区](https://ext.dcloud.net.cn/)，
[云开发](https://uniapp.dcloud.io/uniCloud/README)，
[uni开发者社群](https://dcloud.io/), 开发者600万+， 12亿手机端月活用户

#### 2. 对AutoJS接口进行了一些增加
#### 3. 项目自动部署，自动升级，代码加密, 或远程脚本
#### 4. 无目标APP限制
###### 5. 可一键转微信小程序,支付宝小程序等(但不支持autojs)
#### 
## QQ群： 868229959

[效果图1](http://robots.vnool.com:81/static/git/1.jpg)，
[效果图2](http://robots.vnool.com:81/static/git/3.jpg)，
[效果图3](http://robots.vnool.com:81/static/git/6.jpg)，
[效果图4](http://robots.vnool.com:81/static/git/5.jpg)，

<img src='http://robots.vnool.com:81/static/git/1.jpg'>
<img src='http://robots.vnool.com:81/static/git/3.jpg' width="300">
<img src='http://robots.vnool.com:81/static/git/6.jpg' width="300">
<img src='http://robots.vnool.com:81/static/git/5.jpg' width="300">
 

## 开发环境
1. 下载安装开发工具[HbuilderX](https://www.dcloud.io/hbuilderx.html)
	> 推荐下载使用HbuilderX App开发版 进行开发
2. 克隆或下载源码
	#### a.示例项目(入门推荐) 
		此方式为整个AJ_VUE演示项目，里面有Color UI组件库，演示，模板等，建议用户可以下载 此项目运行用于查看演示效果，通过里面的示例，可以快速掌握项目用法。
	  github地址(github)：[https://github.com/yooge/robot](https://github.com/yooge/robot)
	  
	  gitee地址[网速快]：[https://gitee.com/vnool/autojs-vue](https://gitee.com/vnool/autojs-vue)
	
	  直接下载zip包：
	  
	###### b.空白项目(最小化项目，不含UI交互，高手使用)
		此连接为一个空白的AJ_VUE示例工程，无任何ui组件，熟练开发后使用
	    项目地址：请github搜索 autojs-vue-mini
## 运行示例项目
####	 1. 初始化项目文件
		>  1. HbuilderX开发工具顶部 -> 运行 -> 运行到终端 -> 1.初始化/依赖包
		>  2. HbuilderX开发工具顶部 -> 运行 -> 运行到终端 -> 2.更新/安装基座
####	2. 配置调试基座(手机上的app)
		<br>如果忘记勾选，会意外安装错误的手机程序，会提示Robot对象不存在
		>  HbuilderX开发工具顶部 -> 运行 -> 手机或模拟器 -> 运行基座选择 -> 自定义基座
####	3. 执行 (调试/运行)
		###### 运行到手机 
		>  1. 连接手机(需ADB生效) 
		>  2. HbuilderX开发工具顶部 -> 运行 -> 手机或模拟器 -> 选择你的手机名字
		
		###### 运行到模拟器
		>  1. HbuilderX开发工具顶部 -> 工具 -> 设置 -> 运行配置 -> 模拟器端口
		>  2. HbuilderX开发工具顶部 -> 运行 -> 手机或模拟器 -> 选择模拟器名字
		>  建议 雷电，夜游神，或安卓8以上的
	
## 发布/升级，生成APK
		>  1. HbuilderX开发工具顶部 -> 发行 -> 本地打包 -> 生成app资源
		>  2. HbuilderX开发工具顶部 -> 运行 -> 运行到终端 -> 发布
		```
		app名称：manifest.json文件中: name
		热更新id：manifest.json文件中:appid
		app图标：static/logo.png
		```
# UI与autojs的交互
	<br>建议先大致了解Vue项目结构后进行
	```
	项目主体UI：pages/   各种UI样式举例
	项目主体UI：pages/robots/		2个启动界面举例 
	项目AJ脚本：static/robots/	(默认)用于存放AutoJs代码
	```

## 从UI启动autojs脚本(举例)
#### 不想看例子的人，请直接看这两个路径的源码
```
pages/robots/
static/robots/
```
#### 【第1步】. 新建autojs机器人脚本： 在项目路径~/static/robots下新建文件demo.js
```js
launchApp("微信"); 
click("发现"); 
click("朋友圈");
desc("评论").findOne().click();
click("赞");
```
 

#### 【第2步】. 修改页面内容 pages/index/index.vue
```html
<template>
<view> 
	<button class="cu-btn bg-green shadow" @tap="test">启动</button>
	<button class="cu-btn bg-green shadow" @tap="stop">停止</button>
</view>
</template>
<script> 
var {autojs} = require('robot-tools');
export default {
    methods: {
        test() {
            var param = {
                file: 'demo.js', //文件路径为./static/robots/demo.js 
            }
            autojs.stop();
            autojs.start(param);
        }
    }
}
</script>
```
#### 【第3步】. 在Hbuilder中启动，
菜单：`运行/手机或模拟器/选择你的手机`
(此时手机上会自动安装调试app)，请为这个app授权”无障碍“，”悬浮窗“，”从后台启动”

.
.
.
## 参数解释
```js
var {autojs} = require('robot-tools');
var param = { 
	file: 'demo.js', //机器人脚本(static/robots/目录下)，或绝对路径/sdcard/xxx.js，或远程URL(也可以用发布的打包加密代码)
	vue:  this, //可选, 将本vue对象传递给机器人
	arguments: {}, //可选, json,传递给机器人的参数。[提示]如果不传递，则系统会默认使用'当时'的vue的data数据
	onMessage: (data)=>{}, //回调函数，机器人给VUE发送消息， 感觉快淘汰了
	start: ()=>{}, //脚本启动事件
	finish: (obj)=>{},//脚本执行完毕事件
	fail: (msg)=>{},//脚本发生意外事件
}
//启动机器人
autojs.start(param); 

//在当前环境中立即执行autojs脚本
autojs.exec(function(){ 
    //在vue的代码文件里，直接执行机器人代码，
   console.log(device.getIMEI());
   launchApp('抖音');
   //click('朋友圈');
});

//停止脚本
autojs.stop();
```
#### autojs机器人获取VUE发过来的参数(启动机器人时传递的)
```js
app.args //json对象
app.arguments
```
#### autojs机器人给VUE层发消息
```js
app.post2host("hello vue"); 
//autojs机器人用这个方法给VUE层发消息,(在上面的onMessage中接收消息)
```

#### autojs机器人脚本直接访问VUE页面对象
```js
app.vue  //autojs直接访问vue的对象，上面传递进来的对象this(或别的对象)
app.vue.abc   //访问data里的abc变量
app.vue.abc = 999; //给data里面的abc赋值
app.vue.test() //访问methods里面的 test函数。 此用法可以淘汰上面的onMessage回调

```
#### 例index.vue
```html
<template>
<view> 
	{{abc}}
</view>
</template>
<script> 
var {autojs} = require('robot-tools');
export default {
    data: {
        abc: 123
    }
    methods: {
        test() {
            console.log('autojs call test');
        }
    }
}
</script>
```




# AutoJs 新手/老手，请阅读
### 支持AutoJS的全部API， 补充了一些 
1. 启动app
```js
launchApp("浏览器");
```
## 1. 点击

#### click全局函数[推荐] 
#### 无论元素是否有clickable属性，都会强制点击到对应的坐标上

```js
click("按钮1");
click("赞", 0);  //点击第0个赞
```
点击文字为“按钮1”的界面元素(按钮，文字等)

```js
click("*入购物车");  //点击包含这个文字的元素

click(desc('购物车').findOne());	
click(desc('购物车'),  0);	
```
点击文字包含"入购物车"的界面元素(按钮，文字等)

```js
click(300,500); //点击坐标(300,500)


click('购物车', 10,10);  //右下角偏移 10,10
click('购物车', -10,10); //左下角
click('购物车', 10,-10); //右上角
click('购物车', -10,-10); //左上角 
click(desc('购物车'));	 //新
click(desc('购物车'), 2);	 //新
click(desc('购物车').findOne());	 //
click(desc('购物车').findOne(), -10,-10);	 //购物车的左上角 10,10点击一下 ，以购物车的左上角为参考
click(desc('购物车').findOne(), 10,10);	 //购物车的右下角 10,10点击一下 ，以购物车的 右下角为参考
click(desc('购物车'), 10,10);
text('购物车').findOne().click(); //点击购物车，此方法点击的是元素本身(如果元素只是普通文本，则会失效)
click(text('购物车').findOne()); //(推荐)点击购物车，此方法点击的是屏幕，如果自己不可点击，会把事件传递给父控件
```

#### 点击进入页面，然后再回来
* 适合多页面跳来跳去的交互场景 *
```js
click(desc('购物车'), function(){
	;;//进去页面了，干点啥
	//处理完毕后，会回到原页面
});
click('粉丝', () => { 
		var pp = desc('粉丝列表').findOne();
		var fanslist = listChildren(pp);
		dosomthing(fanslist);
	});
```

## 2. 输入
向本界面中的输入框输入文字
```js
setText("你好");
setText(0, "你好"); //第几个输入框
```

## 3. 查找控件
```js
//1. 查找界面上是否有文字为“消息”的控件，返回数组
text("消息"); 

//2. 界面上是否有控件包含“入购物车”这几个字，返回数组
text("*入购物车"); 

//3. 查找并返回一个
text("消息").findOne(); 
//4. 查找并返回一个，超时5秒
text("消息").findOne(5000);
// 是否存在
text("消息").exists();

//5. 等待界面出现“”这个字的控件，等5秒(默认20秒)
text("消息").waitFor(5000); 
waitFor("消息");
waitFor("消息", 5000);

//6. 等待这个文字消失, 默认超时20秒
waitGone("消息");
waitGone("消息", 5000);
//7. 
textEx  //是text的临时补充版
textEx("#") //查找输入框
textEx("#139101") //查找输入框，里面内容为139101
textEx("#*请输入") //查找输入框，里面内容 包含 请输入

//8.
desc("赞").findOne(); //控件的Content-Description属性
descContains("评论数").findOne(); 

//9.
//对象在屏幕内，比如查找抖音的点赞按钮时，会有两个在屏幕外。就需要这个函数来锁定
inScreen(desc('赞'));
inScreenOne(desc('赞'));
//或者 用扩展搜索
desc('赞').visibleToUser(true);  //控件是否可见。

//10 其他扩展搜索条件:
/*
bounds(0,0, 600, 900) 控件在屏幕上的范围。
indexInParent(2) 控件在父控件的位置。
editable(true) 控件是否可编辑。
visibleToUser(true) 控件是否可见。
drawingOrder(2) 控件在父控件的绘制顺序。
clickable(true) 控件是否可点击。
longClickable(true) 控件是否可长按。
checkable(true) 控件是否可勾选。
checked(true) 控件是否可已勾选。
scrollable(true) 控件是否可滑动。
selected(true) 控件是否已选择。
enabled(true)
*/
```
### 3.0 控件的[属性]
`** 控件有很多属性，请打印一下获取的对象看看`

### 3.1 控件的【方法】
```js
var box = desc('body').findOne();
box.click(); //点击控件
box.longClick();
box.text();  //获取控件的文本
box.setText('xxx'); //设置文本
box.bounds();  //获取控件的坐标 top, left, right, bottom
box.paste();; //粘贴 ， setClip("你好");
box.children(); //子元素的数组
listChildren(box); //新增，同上， 增加了 textAll属性，所有的子元素的文本
box.child(i); //第3个子元素
box.parent(); //父控件
box.findOne(desc("赞")); //查找子元素
box.find(desc("赞")).get(1); //查找子元素，获取第2个
box.find(desc("赞")).empty(); //是否为空
```


### 3.2 页面是否匹配某些内容

根据页面是否匹配某些内容，来判断页面功能
```js
//函数
matchContents(matchkeys);

//查找当前页面是否同时包含 这4个项(主界面)
matchContents("消息 & 通讯录 & 工作台 & *待办");
//查找当前页面是否有如下情况(搜索手机号页面)
// A. 手机号 与 输入框  B. 出现文字‘搜索’ 与输入框
matchContents("手机号 & # | *搜索 & #");
//添加好友页面
matchContents("*好友中添加 & 已发邀请 | *好友中添加 & 添加");
```

 ### 3.3 复杂的查找/等待分支
 在流程中，可能出现任意个不同界面的时候，需要进行分支切换
 
```js
//等待出现两个控件中的一个， 返回 0或1，失败返回-1；超时5秒（默认20秒）
//这个功能 主要用在一个动作后，可能出现两个窗口中的一个。
var i = either("*加为好友", "用户不存在");
var i = either("*加为好友", "用户不存在", 5000);

```
```js
//1. 等待出现多个控件中的一个， 返回 0,1,2,3，失败返回-1； 超时5秒（默认20秒）
//这个功能 主要用在比如一个点击动作后，可能出现多个窗口中的一个。
var i = appear(["*加为好友", "用户不存在", "*无权限"], 5000);

//2. 或者，返回key, 失败则返回-1
var key = appear({"ok":"*加为好友", "unexist":"用户不存在", "denial": "*无权限"}, 5000);
```

## 4. 窗口操作（设计的不好）

1. 启动app
```js
launchApp("浏览器");
```
2. 获取当前的包名
//如 com.tencent.mm
```js
currentPackage();
```

3. 等待窗口出现
```js
waitForActivity("*.launch.WwMainActivity", 4000);
//建议多使用，等待内容出现的函数 waitFor
```
4. (从深层堆栈中回退)一直点击返回键，让页面一直返回，直至遇到某窗口(# 有点费劲， 推荐使用click的回调功能)
```js
//参数：窗口类名/或数组，包名，超时时间，忽略其他窗口的存在；
//返回: 该类名（有点复杂，可以放弃，请参考4.2）
back2activity("*.launch.WwMainActivity");
back2activity("*.launch.WwMainActivity","com.tencent.wework");
back2activity("*.launch.WwMainActivity","com.tencent.wework", 12000);
back2activity("*.launch.WwMainActivity","com.tencent.wework", 12000, ["*.xxActivity","*.yyyActivity"]);
//也可以是数组，返回对应的类名
back2activity(["*.launch.WwMainActivity", "*.LaunchSplashActivity"]);
```
4.2 从深层堆栈中回退) 一直点击返回键，让页面一直返回，直至遇到某窗口
```js
//自动点击返回键，回调页面包含xx内容的窗口
//matchList可以为字符串，或数组， 回到包含该内容的页面，参考 matchContents函数
back2activityEx(matchList, timeout)

back2activityEx("消息 & 通讯录", 5000);
back2activityEx(["消息 & 通讯录", "已发邀请 | 添加"], 5000);
```

5. 等待窗口消失
```js
activityWaitGone("*.launch.WwMainActivity", 5000);
```
推荐使用waitGone('文字')


## 5. 按键
```js
home(); //桌面
back(); //返回
recents(); //任务列表
notifications(); //拉出通知栏
```

## 6. 其他

```js
sleep(1000);//暂停1秒
//
console.log("xxxxx"); //会同时打印到电脑,手机
console.show();  //打开悬浮日志窗口(日志同时会往这里输出)
//---
//用新的控制台
console.useNew(); //使用新的模式!!(使下面的这些功能)，老控制台则用这个访问console_old
console.useNew('patchs/log_layout.xml'); //指定layout
console.log2ide("xxxx"); //仅仅显示在电脑里
console.log2app("xxxx");  //仅仅显示在手机上
console.title('修改标题内容');
console.toast('修改标题内容');
toast('修改标题内容');

console.msg('覆盖日志区域内容');//内容可使用HTML，可作为自定义统计页
console.log('日志');
console.log('<b>日志</b>'); //内容可使用HTML
console.info('蓝色提示');
console.warn('黄色警告');
console.verbose('低级日志');
console.error('红色警告');

console.error.color = '#DD0099';//设置颜色
console.error.color = 'red';//设置颜色
console.info.color = 'blue';
console.warn.color = 'yellow';
console.log.color = 'white';
console.verbose.color = 'gray';
 
//设置日志本地存储
console.logfile = '/sdcard/1.txt';

console.resize(400, 400);  //设置日志浮窗 宽度，高度
console.resize(-1, 400);  //宽度为全屏
console.setPosition(0, 502);  //设置位置

console.window 浮窗对象 
可以控制layout中的节点,比如:
console.window.resize(400, 400)
console.window.title.setText('hello') //设置文字
console.window.myid.setTextSize(20) //设置字体大小（请在自定义layout中加入这个myid节点）

console.setText(console.window.body, '<b>粗体文字</b>'); //添加html文字
console.addText(console.window.myid, '<font color=red>红色文字</font>'); //添加html文字
```



## 7. 手指操作
 

```js
//滑动
swipeUp() //上滑
swipeUp(800)  //800px

swipeTo('张三') //滑到某个内容
swipeTo(desc('张三')) 
swipeTo({key:'张三'}) //滑到某个内容
swipeTo({key,timeout,length,to}) //滑到某个内容

//
scrollTo('添加');
scrollUp(1)
scrollDown(0)
scrollForward()
scrollLeft()
scrollRight()

longClick(text[, i])
click(text[, i])


swipe(200, 1500, 200, 400, 500); //500毫秒
swipe(x1, y1, x2, y2, 500); //500毫秒
//连续滑动
gesture(1000, [0, 0], [500, 500], [500, 1000])
//多指连续滑动
gestures([delay1, duration1, [x1, y1], [x2, y2], ...], [delay2, duration2, [x3, y3], [x4, y4], ...], ...)

gestures([0, 500, [800, 300], [500, 1000]],
         [0, 500, [300, 1500], [500, 1000]]);
```


### 截图 (原API，没有新增，老手请请忽略)
```js

//请求
requestScreenCapture(true);
//1,截图
var img = captureScreen(); 

var color = images.pixel(img, 100, 100);
//
toast(colors.toString(color));


//2,找到红色
while(true){
    var img = captureScreen();
    var point = findColor(img, "#ff0000");
    if(point){
        toast("找到红色，坐标为(" + point.x + ", " + point.y + ")");
    }
}

//3.
//指定找色区域(400, 500),宽为300,长为200的区域，色临界值 默认4 (范围:0-255) 
var point = findColor(img, "#00ff00", {
     region: [400, 500, 300, 200],
     threshold: 4
 });
 
 //4, 根据颜色找坐标
 var p = findColorEquals(captureScreen(), "#f64d30");
 
 //5. 找图片
 var img = images.read("/sdcard/大图.png");
 var template = images.read("/sdcard/小图.png");
 var p = findImage(img, template);
 if(p){
     toast("找到啦:" + p);
 }else{
     toast("没找到");
 }
 img.recycle();
 template.recycle();
 
 //在一定范围内找
 var p = findImage(captureScreen(), template, {
     region: [0, 50],
     threshold: 0.8 //相似度,默认值0.9
 });
 
 //
 var j=findImage(img, template, {
     region: [x, y, width, height],
     threshold: 0.8 //相似度
 })
 
 //找100个给给我
 var result = images.matchTemplate(img, template, {
     region: [x, y, width, height],
	 threshold:0.8,
	 max: 100
 });
 //result.matches 
```
.
.

 
## QQ群：  868229959
 
```js
  如果喜欢这个项目，可以请赠我一包华子 
```