# autojs-vue **Repository Path**: mengjing333/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**: 1 - **Forks**: 127 - **Created**: 2023-12-25 - **Last Updated**: 2023-12-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AutoJs-Vue 特性 ## 用JS任意控制手机上的其他APP ##### 帮助开发者,快速生产友好的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限制 #### ## QQ群： 820320773 [效果图1](http://robots.shen-x.com/static/git/1.jpg)， [效果图2](http://robots.shen-x.com/static/git/3.jpg)， [效果图3](http://robots.shen-x.com/static/git/6.jpg)， [效果图4](http://robots.shen-x.com/static/git/5.jpg)，

## 开发环境 ### 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]`1. HbuilderX开发工具顶部 -> 运行 -> 运行到终端 -> 1.初始化/依赖包 ###### `[步骤2]`2. HbuilderX开发工具顶部 -> 运行 -> 运行到终端 -> 2.更新/安装基座 #### 2. 配置调试基座(手机上的app) ###### `[步骤3]` HbuilderX开发工具顶部 -> 运行 -> 手机或模拟器 -> 运行基座选择 -> 自定义基座 * 如果忘记勾选，会意外安装错误的手机程序，会提示Robot对象不存在 #### 3. 执行 (调试/运行) ###### `[步骤4]`3.1. 运行到手机 ###### 1. 连接手机(需ADB生效) ###### 2. HbuilderX开发工具顶部 -> 运行 -> 手机或模拟器 -> 选择你的手机名字 ###### 3.2. 运行到模拟器 1. HbuilderX开发工具顶部 -> 工具 -> 设置 -> 运行配置 -> 模拟器端口 2. HbuilderX开发工具顶部 -> 运行 -> 手机或模拟器 -> 选择模拟器名字建议用真机，雷电，夜游神，或安卓8以上的 ## 发布/升级，生成APK ###### `[步骤]`1. HbuilderX开发工具顶部 -> 发行 -> 本地打包 -> 生成app资源 ###### `[步骤]`2. HbuilderX开发工具顶部 -> 运行 -> 运行到终端 -> 生成APK #### 自定义manifest.json文件 ```js { "name" : "app名称", "appid" : "__UNI__xxxx", /* 一定要改!!!!! */ "appkey" : "去官方申请962a0c8a982ae去官方申请", /* appkey去官方申请： https://nativesupport.dcloud.net.cn/AppDocs/usesdk/appkey */ "package" : "com.xxxx.yyy", "SHA1" : "BF:28:B5:FB:9D:A3:20:27:28:FD:51:77:59:9B:F4:BA:23:E8:A1:88", /* 固定值 */ "logo" : "static/logo.png", /* APP图标 */ "splash" : "static/splash.png", /* 开屏等待页广告 */ "versionName" : "1.0.37", /* 热补丁之前修改*/ "versionCode" : 10037, /* 在做热补丁之前修改*/ } ``` # vue与autojs的交互建议先大致了解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 ``` #### 【第3步】从Hbuilder中启动app， ``` 菜单：运行/手机或模拟器/选择你的手机 ``` ``` (此时手机上会自动安装调试app)， APP启动后，请为这个app授权”无障碍“，”悬浮窗“，”从后台启动” ``` . ## 参数解释 #### 在VUE页面，立即执行autojs代码 ```js var {autojs} = require('robot-tools'); //立即执行autojs脚本（无需js文件或执行js脚本，可立即执行本代码） autojs.exec(function(){ //在vue的代码文件里，直接执行机器人代码， console.log('开始振动 '); console.show(); device.vibrate(2000); launchApp('抖音'); //click('朋友圈'); }); //偶尔用一下，不要太依赖 //todo: //1. 作用域在autojs内，此处暂不支持对VUE的访问，下一版补上；(如果需要访问VUE，看下面的start方法) //2. 如果需要用require方法引用其他的js文件，请先用autojs.robot.setJsDir("/sdcard/")设置工作路径； // 或者用autojs.init({file:'demo.js'})设置个假的文件，工作路径参考下文 ``` #### 执行autojs文件 ```js var {autojs} = require('robot-tools'); var param = { file: 'demo.js', //[必选],机器人脚本(static/robots/demo.js)，或绝对路径/sdcard/xxx.js，或远程URL(也可以用发布的打包加密代码) vue: this, //可选, 将本vue对象传递给机器人 arguments: {}, //可选, json,传递给机器人的参数。[提示]如果不传递，则系统会默认使用'当时'的vue的data数据； onMessage: (data)=>{}, //可选,回调函数，机器人给VUE发送消息，感觉快淘汰了 start: ()=>{}, //可选,脚本启动事件 finish: (obj)=>{},//可选,脚本执行完毕事件 fail: (msg)=>{},//可选,脚本发生意外事件 } /* file: //1. 机器人脚本(static/robots/目录下的demo.js)， //2. 或绝对路径/sdcard/xxx.js， //3. 或远程URL(也可以用发布的打包加密代码) arguments: //可选, json,传递给机器人的参数。 //可以在autojs脚本中用app.args获取 //如果不传递参数，则系统会默认传递'当时'的vue的$data数据； //如果autojs想动态获取vue的$data的数据，请往下看 */ //启动脚本 autojs.start(param); //停止脚本 autojs.stop(); //仅设置初始化参数，不执行代码 autojs.init(param); //根据上面设置好的参数，执行代码；也可以在悬浮机器人上点启动按钮 autojs.start(); autojs.menu.show(); //显示悬浮机器人图标 autojs.menu.hide(); //隐藏悬浮机器人图标 autojs.menu.move(x,y); //移动悬浮机器人图标 autojs.menu.close(); //隐藏悬浮机器人图标 autojs.showMenu(param); //执行脚本并显示机器人图标 //在当前运行的环境中立即执行autojs脚本(需要在xxx.js脚本启动后，再调用该方法) autojs.eval(function(){ //在vue的代码文件里，直接执行机器人代码， launchApp('抖音'); sleep(4000); console.log(text('我')); //click('朋友圈'); }); //立即执行autojs脚本（代码可以是字符串） autojs.exec( ` console.log(device.getIMEI()); launchApp('抖音'); ` ); var isEnabled = autojs.permission();//检查是否启动了无障碍 ``` #### autojs机器人获取VUE发过来的参数(启动机器人时传递的) ```js app.args //json对象, app.arguments //参数字符串 app.args.scriptStartFrom //null 或 'menu'；可以通过不同的启动方式，执行不同的代码 app.args._debug //调试模式，还是正式模式 ``` #### 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() //访问VUE的methods里面的test函数。此用法可以淘汰上面的onMessage回调 ``` #### 例index.vue ```html ``` # 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(){ ;;//进去页面了，干点啥 //处理完毕后，会回到原页面 //如图期待的页面没出现请用 return 'click_fail'; }); //点击粉丝列表 click('粉丝', () => { //打开了粉丝列表页面 var pp = desc('粉丝列表').findOne(); var fanslist = listChildren(pp); //在粉丝列表页面上进行一系列操作 dosomthing(fanslist); }); ``` ## 2. 输入向本界面中的输入框输入文字 ```js setText("你好"); setText(0, "你好"); //第几个输入框 ``` ## 3. 查找控件 ```js //1. 查找界面上是否有文字为“消息”的控件，返回数组 text("消息"); text("消息").find(); //2. 界面上是否有控件包含“入购物车”这几个字，返回数组 text("*入购物车").find(); desc("*个赞") //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 className('RecyclerView');//控件的类 classNameContains('RecyclerView');//类 //10. //遍历过滤器 var uc = className("TextView").filter(function(w){ return w.text().length == 10; }); //11. //对象在屏幕内，比如查找抖音的点赞按钮时，会有两个在屏幕外。就需要这个函数来锁定 inScreen(desc('赞')); inScreenOne(desc('赞')); //或者用扩展搜索 desc('赞').visibleToUser(true); //控件是否可见。 //10 其他扩展搜索条件: /* cls('classname') 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); ``` ### 3.3.4 逆向搜索 //逆向搜索，从我开始,向其他节点搜索 ```js var mynode = text('回复').findOne(); var targetSelector = className('androidx.recyclerview.widget.RecyclerView') var obj = lookup(mynode, targetSelector); ``` ### 3.3.5 图片查找 ```js //查找尺寸的图片 var ckRect= {w1:100} //宽度大于100的图片 var ckRect = {w2:200} //宽度小于200的图片 var ckRect = {w1:100, w2:200} //宽度在100-200之间的图片 var ckRect = {h1:100, h2:500} //高度在100-500之间的图片 //或者数组 ckRect = [w1,w2,h1,h2] //查找所有符合尺寸的图片 var images = findPictures(parentObj, ckRect); //查找尺寸的图片，取第一个 var img = findPicture(parentObj, ckRect); //查找大控件 bigSize(classname);//d大于半个屏幕大小的类 bigSize(classname, 500); ``` ### 3.3.6 按尺寸查找 ```js findsize(list, chRect) //list控件数组， ckRect参考上面找图的参数 //过滤器 var uc = className("ImageView").filter(function(w){ var b = w.bounds(); return b.width() > 10; //宽度大于10的图片 }); ``` ### 3.3.6 其他 ```js //寻祖 parent(obj, 2) //祖父 parent(obj, 3) //祖父的父亲 //查找本控件及所有子控件，并返回文本及控件 loopElementsText(obj, false); loopElementsText(obj, true); //只返回文本 alltext(obj) //同上,只返回文本(压在一起了) listChildren(obj)//返回数组，枚举每个子控件(及内部所有文本) ``` ## 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('日志'); //内容可使用HTML console.log('红色文字'); //内容可使用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.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, '粗体文字'); //添加html文字 console.addText(console.window.myid, '红色文字'); //添加html文字 //设置日志本地存储 console.logfile ; console.setLogfile('/sdcard/1.txt'); console.removeLogfile();//删除log内容 console.getLog();//获取log内容 ``` ## 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群： 820320773 ```js 如果喜欢这个项目，可以请赠我一包华子 ```