其他分享
首页 > 其他分享> > auto.js常见的APP脚本指令

auto.js常见的APP脚本指令

作者:互联网

app

app模块提供一系列函数,用于使用其他应用、与其他应用交互。例如发送意图、打开文件、发送邮件等。

同时提供了方便的进阶函数startActivity和sendBroadcast,用他们可完成app模块没有内置的和其他应用的交互。

app.versionCode

当前软件版本号,整数值。例如160, 256等。

如果在Auto.js中运行则为Auto.js的版本号;在打包的软件中则为打包软件的版本号。

toastLog(app.versionCode);

app.versionName

当前软件的版本名称,例如"3.0.0 Beta"。

如果在Auto.js中运行则为Auto.js的版本名称;在打包的软件中则为打包软件的版本名称。

toastLog(app.versionName);

app.autojs.versionCode

Auto.js版本号,整数值。例如160, 256等。

app.autojs.versionName

Auto.js版本名称,例如"3.0.0 Beta"。

app.launchApp(appName)

通过应用名称启动应用。如果该名称对应的应用不存在,则返回false; 否则返回true。如果该名称对应多个应用,则只启动其中某一个。

该函数也可以作为全局函数使用。

launchApp("Auto.js");

app.launch(packageName)

通过应用包名启动应用。如果该包名对应的应用不存在,则返回false;否则返回true。

该函数也可以作为全局函数使用。

//启动微信
launch("com.tencent.mm");

app.launchPackage(packageName)

相当于app.launch(packageName)

app.getPackageName(appName)

获取应用名称对应的已安装的应用的包名。如果该找不到该应用,返回null;如果该名称对应多个应用,则只返回其中某一个的包名。

该函数也可以作为全局函数使用。

var name = getPackageName("QQ"); //返回"com.tencent.mobileqq"

app.getAppName(packageName)

获取应用包名对应的已安装的应用的名称。如果该找不到该应用,返回null。

该函数也可以作为全局函数使用。

var name = getAppName("com.tencent.mobileqq"); //返回"QQ"

app.openAppSetting(packageName)

打开应用的详情页(设置页)。如果找不到该应用,返回false; 否则返回true。

该函数也可以作为全局函数使用。

app.viewFile(path)

用其他应用查看文件。文件不存在的情况由查看文件的应用处理。

如果找不出可以查看该文件的应用,则抛出ActivityNotException

//查看文本文件
app.viewFile("/sdcard/1.txt");

app.editFile(path)

用其他应用编辑文件。文件不存在的情况由编辑文件的应用处理。

如果找不出可以编辑该文件的应用,则抛出ActivityNotException

//编辑文本文件
app.editFile("/sdcard/1.txt/);

app.uninstall(packageName)

卸载应用。执行后会会弹出卸载应用的提示框。如果该包名的应用未安装,由应用卸载程序处理,可能弹出"未找到应用"的提示。

//卸载QQ
app.uninstall("com.tencent.mobileqq");

app.openUrl(url)

用浏览器打开网站url。

如果没有安装浏览器应用,则抛出ActivityNotException

app.sendEmail(options)

根据选项options调用邮箱应用发送邮件。这些选项均是可选的。

如果没有安装邮箱应用,则抛出ActivityNotException

//发送邮件给10086@qq.com和10001@qq.com。
app.sendEmail({
    email: ["10086@qq.com", "10001@qq.com"],
    subject: "这是一个邮件标题",
    text: "这是邮件正文"
});

app.startActivity(name)

启动Auto.js的特定界面。该函数在Auto.js内运行则会打开Auto.js内的界面,在打包应用中运行则会打开打包应用的相应界面。

app.startActivity("console");

app.intent(options)

根据选项,构造一个意图Intent对象。

例如:

//打开应用来查看图片文件
var i = app.intent({
    action: "VIEW",
    type: "image/png",
    data: "file:///sdcard/1.png"
});
context.startActivity(i);

Intent(意图) 是一个消息传递对象,您可以使用它从其他应用组件请求操作。尽管 Intent 可以通过多种方式促进组件之间的通信,但其基本用例主要包括以下三个:

需要注意的是,除非应用专门暴露Activity出来,否则在没有root权限的情况下使用intent是无法跳转到特定Activity、应用的特定界面的。例如我们能通过Intent跳转到QQ的分享界面,是因为QQ对外暴露了分享的Activity;而在没有root权限的情况下,我们无法通过intent跳转到QQ的设置界面,因为QQ并没有暴露这个Activity。

但如果有root权限,则在intent的参数加上"root": true即可。例如使用root权限跳转到Auto.js的设置界面为:

app.startActivity({
    packageName: "org.autojs.autojs",
    className: "org.autojs.autojs.ui.settings.SettingsActivity_",
    root: true
});

另外,关于intent的参数如何获取的问题,一些intent是意外发现并且在网络中传播的(例如跳转QQ聊天窗口是因为QQ给网页提供了跳转到客服QQ的方法),如果要自己获取活动的intent的参数,可以通过例如"intent记录","隐式启动"等应用拦截内部intent或者查询暴露的intent。其中拦截内部intent需要XPosed框架,或者可以通过反编译等手段获取参数。总之,没有简单直接的方法。

更多信息,请百度安卓Intent或参考Android指南: Intent

app.startActivity(options)

根据选项构造一个Intent,并启动该Activity。

app.startActivity({
    action: "SEND",
    type: "text/plain",
    data: "file:///sdcard/1.txt"
});

app.sendBroadcast(options)

根据选项构造一个Intent,并发送该广播。

app.startService(options)

根据选项构造一个Intent,并启动该服务。

app.sendBroadcast(name)

[v4.1.0新增]

发送以上特定名称的广播可以触发Auto.js的布局分析,方便脚本调试。这些广播在Auto.js发送才有效,在打包的脚本上运行将没有任何效果。

app.sendBroadcast("inspect_layout_bounds");

app.intentToShell(options)

[v4.1.0新增]

根据选项构造一个Intent,转换为对应的shell的intent命令的参数。

例如:

shell("am start " + app.intentToShell({
    packageName: "org.autojs.autojs",
    className: "org.autojs.autojs.ui.settings.SettingsActivity_"
}), true);

参见intent参数的规范

app.parseUri(uri)

[v4.1.0新增]

解析uri字符串并返回相应的Uri对象。即使Uri格式错误,该函数也会返回一个Uri对象,但之后如果访问该对象的scheme, path等值可能因解析失败而返回null

需要注意的是,在高版本Android上,由于系统限制直接在Uri暴露文件的绝对路径,因此如果uri字符串是文件file://...,返回的Uri会是诸如content://...的形式。

app.getUriForFile(path)

[v4.1.0新增]

从一个文件路径创建一个uri对象。需要注意的是,在高版本Android上,由于系统限制直接在Uri暴露文件的绝对路径,因此返回的Uri会是诸如content://...的形式。

app.getInstalledApps([options])

** [Pro 8.0.0新增] **

返回为当前用户安装的所有应用程序包的列表。如果设置了match选项 uninstalled_packages,则包括被删除但保留了数据的应用程序。 获取安装的应用列表。

返回值是ApplicationInfo对象的数组。 如果没有安装任何应用,则返回一个空数组。

选项options的match选项用于指定要返回哪些应用程序,get选项用于指定返回的应用程序携带哪些信息。

// 获取系统app
let apps = $app.getInstalledApps({
    get: ['meta_data'],
    match: ['system_only']
});
console.log(apps);

标签:string,auto,APP,js,options,intent,应用,Intent,app
来源: https://www.cnblogs.com/wineman520/p/16607049.html