目录

• 通用应用 (App)
  • app.versionCode
  • app.versionName
  • app.autojs.versionCode
  • app.autojs.versionName
  • app.launchApp(appName)
  • app.launch(packageName)
  • app.launchPackage(packageName)
  • app.getPackageName(appName)
  • app.getAppName(packageName)
  • app.openAppSetting(packageName)
  • app.viewFile(path)
  • app.editFile(path)
  • app.uninstall(packageName)
  • app.openUrl(url)
  • app.sendEmail(options)
  • app.startActivity(name)
  • app.intent(options)
  • app.startActivity(options)
  • app.sendBroadcast(options)
  • app.startService(options)
  • app.sendBroadcast(name)
  • app.intentToShell(options)
  • app.parseUri(uri)
  • app.getUriForFile(path)
  • app.getInstalledApps([options])

通用应用 (App)#

---

此章节待补充或完善...

Marked by SuperMonster003 on Oct 22, 2022.

---

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.verionName);

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);

需要注意的是, 除非应用专门暴露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新增]

• name { string } 特定的广播名称, 包括：
  • inspect_layout_hierarchy 布局层次分析
  • inspect_layout_bounds 布局范围

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

app.sendBroadcast("inspect_layout_bounds");

app.intentToShell(options)#

[v4.1.0新增]

• options { Object } 选项

根据选项构造一个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 { string } 一个代表Uri的字符串, 例如"file:///sdcard/1.txt", "https://www.autojs.org"
• 返回 { Uri } 一个代表Uri的对象, 参见android.net.Uri.

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

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

app.getUriForFile(path)#

[v4.1.0新增]

• path { string } 文件路径, 例如"/sdcard/1.txt"
• 返回 { Uri } 一个指向该文件的Uri的对象, 参见android.net.Uri.

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

app.getInstalledApps([options])#

[Pro 8.0.0新增]

• options { Object } 选项, 包括：
  • get: 指定返回的应用信息中包含的信息
    • "activities" 应用的Activity组件信息
    • "configurations" 应用的硬件配置
    • "gids" 应用的group id
    • "instrumentation" 应用的Instrumentation信息
    • "intent_filters" 应用的意图过滤
    • "meta_data" 应用的元信息（默认）
    • "permissions" 应用的权限信息
    • "providers" 应用的ContentProvider组件信息
    • "receivers" 应用的BroadcastReceiver组件信息
    • "services" 应用的Service组件信息
    • "shared_library_files" 应用的动态链接库文件信息
    • "signatures" 应用的签名信息（已弃用
    • "signing_certificates" 应用的签名信息
    • "uri_permission_patterns"
    • "disabled_components" 被卸载的但保留了数据的应用
    • "disabled_until_used_components" 禁用直到被使用的组件
    • "uninstalled_packages" 被卸载的但保留了数据的应用
  • match: 指定要匹配的应用列表
    • "uninstalled_packages" 被卸载的但保留了数据的应用
    • "disabled_components" 被禁用的组件
    • "disabled_until_used_components" 禁用直到被使用的组件
    • "system_only" 只匹配系统应用
    • "factory_only" 只匹配预装应用
    • "apex" APEX应用
• 返回 { Array\<ApplicationInfo> }

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

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

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

let apps = $app.getInstalledApps({
    matcg
})