| .idea | ||
| app | ||
| gradle/wrapper | ||
| .gitignore | ||
| app0.17.0205.apk | ||
| build.gradle | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE.md | ||
| Readme.md | ||
| settings.gradle | ||
免Root脚本机器人
#简介 一个不需要root权限的类似脚本精灵、按键精灵的自动操作的软件。可以实现自动点击、滑动、输入文字、打开应用等,例如QQ自动抢红包。当然了你也可以把它当做js的IDE来写JavaScript(作为IDE而言目前还比较弱,没有自动补全和包列表等)。另外由于不使用root权限,要点击屏幕上的精确位置是不能实现的,像游戏刷副本自动签到什么的基本上不能做到,这些还是用root权限的脚本精灵吧~~ #基本语法与API 目前支持的自动操作函数还比较少,未来会逐渐增加。
###一、语法 本软件使用JavaScript语言(ECMAscript E5/E5.1),基于Duktape引擎拓展一些自动操作(点击、长按、滑动等)函数。因而语法参见JavaScript(例如w3cschool教程)。
###二、自动操作函数 自动操作的函数都需要开启"自动操作服务"才能执行,否则执行到相应函数时脚本会停止运行。
click(text)点击文本text所在的区域,并返回是否点击成功。当前界面没有出现该文本或者该文本所在区域不可点击时返回false。例如click("发现"),是点击"发现"。如果要点击"发现"直至点击成功可以用while(!click("发现"))。
文本所在区域指的是,从文本处向其父视图寻找,直至发现一个可点击的部件为止。
click(left, top, bottom, right)
有些按钮或者部件是图标而不是文字(例如发送朋友圈的照相机图标以及QQ下方的消息、联系人、动态图标),这时不能通过
click(text)来点击,只能通过描述图标所在的区域来点击。left, bottom, top, right描述的就是点击的区域。至于要定位点击的区域,可以在侧拉菜单开启"点击区域辅助"(或者安卓7.0以上在通知栏点击"修改"添加点击区域辅助快捷设定图标),之后每次点击或长按都会提示这次点击或长按的区域并自动保存,可以在编辑器的右侧拉菜单中插入。
点击与长方形范围严格匹配的区域,并返回是否点击成功。其中left为长方形左边与屏幕左边的像素距离,top为上边与屏幕上边的像素距离,right为右边与屏幕左边的像素距离, bottom为下边与屏幕上边的距离。区域严格匹配。
以下的longClick、select、scrollUp、scrollDown的参数均与click类似,不再赘述。
longClick长按select选择scrollUp上滑。不加参数时会寻找"最大"的可滑动的控件上滑,例如微信消息列表等。scrollDown下滑。不加参数时与scrollUp类似。input(text)把所有输入框的文本都置为text。例如input("测试")。input(i, text)把第i个输入框的文本设为text。i从0开始。
###三、其他函数
sleep(n)暂停执行n毫秒时间。toast(text)显示提示文本。launch(packageName)运行包名为packageName的应用。例如launch("com.tencent.mm")是运行微信,应用包名可以通过一些工具获取;获取通过函数launchApp代替launch(packageName, className)运行包名为packageName,类名(Activity)为className的应用。launchApp(appName)运存应用名称为appName的应用。例如launchApp("QQ")。不同应用名称可能相同,这时只运行其中某一个应用。notStopped若当前脚本处于运行状态时返回true, 否则返回false。对于某些循环, 例如while(true),请用while(notStopped())代替,以免死循环造成的脚本无法正常停止。isStoppd若当前脚本处于停止状态时返回true, 否则返回false。 ###四、全局变量contextApplicationContext,参见安卓android.content.Context
这里的context由于是ApplicationContext,是不可见的,不能用于dialog和其他UI相关。如果要显示弹窗或者视图,请启动UI模式(代码的第一行为
"ui";既可)并使用activity代替。
activityUI模式下会启动一个Activity来运行脚本,并在UI线程下运行。可通过该变量来获取该activity。
###五、在脚本中调用Java 使用importClass来引入要使用的库,例如:
importClass("android.view.View.OnClickListener")
view.setOnClickListener(new OnClickListener(function(){
Toast.makeText(activity, "Button1 Clicked", Toast.LENGTH_SHORT).show();
var intent = new Intent(activity, "com.furture.react.activity.DetailActivity");
activity.startActivity(intent);
}));
view2.setOnClickListener(new OnClickListener({
onClick: function(){
Toast.makeText(activity, "Button2 Clicked", Toast.LENGTH_SHORT).show();
}
}));
详细文档参见DuktapeJava Java Docs。
#License CC-BY-NC-SA 不要能用于商业、盈利与非法用途