应用 - Auto.js Pro 文档

## App app模块提供一系列函数，用于使用其他应用、与其他应用交互。例如发送意图、打开文件、发送邮件等。同时提供了方便的进阶函数startActivity和sendBroadcast，用他们可完成app模块没有内置的和其他应用的交互。 ### 获取当前版本号|versionCode | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.versionCode() | 整数型 | 当前软件版本号，整数值。例如160, 256等。 | app.versionCode - {number} 当前软件版本号，整数值。例如160, 256等。如果在Auto.js中运行则为Auto.js的版本号；在打包的软件中则为打包软件的版本号。 toastLog(app.versionCode); ### 获取当前版本名 |versionName | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.versionName() | 字符串 | 当前软件的版本名称，例如"3.0.0 Beta"。 | app.versionName - {string} 当前软件的版本名称，例如"3.0.0 Beta"。如果在Auto.js中运行则为Auto.js的版本名称；在打包的软件中则为打包软件的版本名称。 toastLog(app.versionName); ### 获取Auto.js版本号 |autojs.versionCode | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.autojs.versionCode | 整数型 | Auto.js版本号，整数值。例如160, 256等。 | app.autojs.versionCode - {number} Auto.js版本号，整数值。例如160, 256等。 ### 获取Auto.js版本名 |autojs.versionName | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.autojs.versionName | 字符串 | Auto.js版本名称，例如"3.0.0 Beta"。 | app.autojs.versionName - {string} Auto.js版本名称，例如"3.0.0 Beta"。 ### 启动应用(名称) |launchApp | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.launchApp() | 布尔型 | 通过应用名称启动应用。 | | **参数名** | **类型** | | | 应用名称 | 字符串 | | app.launchApp(appName) - `appName` {string} 应用名称通过应用名称启动应用。如果该名称对应的应用不存在，则返回false; 否则返回true。如果该名称对应多个应用，则只启动其中某一个。该函数也可以作为全局函数使用。 launchApp("Auto.js"); //启动APP if (currentPackage() != "com.chaoxing.mobile") { toast("即将打开超星！"); //直接打开学习通 app.launchApp("学习通"); } else { toast("已经在学习通中，即将开始进行下一步操作！"); }; ### 启动应用(包名) |launch | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.launch() | 布尔型 | 通过应用包名启动应用 | | **参数名** | **类型** | | | 应用包名 | 字符串 | | app.launch(packageName) - `packageName` {string} 应用包名通过应用包名启动应用。如果该包名对应的应用不存在，则返回false；否则返回true。该函数也可以作为全局函数使用。 //启动微信 launch("com.tencent.mm"); ### 启动应用(包名) |launchPackage | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.launchPackage() | 布尔型 | 通过应用包名启动应用 | | 参数名 | **类型** | | | 应用包名 | 字符串 | | app.launchPackage(packageName) - `packageName` {string} 应用包名相当于`app.launch(packageName)`。 while (true) { if (currentPackage() != "com.chaoxing.mobile") { toast("即将打开超星！"); //直接打开学习通 app.launchPackage("com.chaoxing.mobile"); sleep(5000) } else { toast("已经在学习通中，即将开始进行下一步操作！"); break; }; }; ### 获取应用包名(应用名称) |getPackageName | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.getPackageName() | 字符串 | 获取应用的包名,找不到则返回{null} | | **参数名** | **类型** | | | 应用名称 | 字符串 | | app.getPackageName(appName) - `appName` {string} 应用名称获取应用名称对应的已安装的应用的包名。如果该找不到该应用，返回null；如果该名称对应多个应用，则只返回其中某一个的包名。该函数也可以作为全局函数使用。 var name = getPackageName("QQ"); //返回"com.tencent.mobileqq" ### 获取应用名称(应用包名) |getAppName | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.getAppName() | 字符串 | 获取应用的名称。找不到则返回 null | | **参数名** | **类型** | | | 应用包名 | 字符串 | | app.getAppName(packageName) - `packageName` {string} 应用包名获取应用包名对应的已安装的应用的名称。如果该找不到该应用，返回null。该函数也可以作为全局函数使用。 var name = getAppName("com.tencent.mobileqq"); //返回"QQ" ### 打开应用设置页 |openAppSetting | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.openAppSetting() | 布尔型 | 打开应用的详情页(设置页) | | **参数名** | **类型** | | | 应用包名 | 字符串 | | app.openAppSetting(packageName) - `packageName` {string} 应用包名打开应用的详情页(设置页)。如果找不到该应用，返回false; 否则返回true。该函数也可以作为全局函数使用。 ### 应用查看文件 |viewFile | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.viewFile() | | 用其他应用查看文件。文件不存在的情况由查看文件的应用处理。 | | **参数名** | **类型** | | | 文件路径 | 字符串 | | app.viewFile(path) - `path` {string} 文件路径用其他应用查看文件。文件不存在的情况由查看文件的应用处理。如果找不出可以查看该文件的应用，则抛出`ActivityNotException`。 //查看文本文件 app.viewFile("/sdcard/1.txt"); ### 应用编辑文件 |editFile | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.editFile() | | 用其他应用编辑文件。文件不存在的情况由编辑文件的应用处理。 | | **参数名** | **类型** | | | 文件路径 | 字符串 | | app.editFile(path) - `path` {string} 文件路径用其他应用编辑文件。文件不存在的情况由编辑文件的应用处理。如果找不出可以编辑该文件的应用，则抛出`ActivityNotException`。 //编辑文本文件 app.editFile("/sdcard/1.txt/); ### 卸载应用 |uninstall | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.uninstall() | | 卸载应用。会弹出卸载应用的提示框 | | **参数名** | **类型** | | | 应用包名 | string | | app.uninstall(packageName) - `packageName` {string} 应用包名卸载应用。执行后会会弹出卸载应用的提示框。如果该包名的应用未安装，由应用卸载程序处理，可能弹出"未找到应用"的提示。 //卸载QQ app.uninstall("com.tencent.mobileqq"); ### 打开指定网站 |openUrl | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.openUrl() | | 用浏览器打开网站url。 | | **参数名** | **类型** | | | 网站的Url | 字符串 | 如果不以"http://"或"https://“开头则默认是"http://”。 | app.openUrl(url) - `url` {string} 网站的Url，如果不以"http://"或"https://“开头则默认是"http://”。用浏览器打开网站url。如果没有安装浏览器应用，则抛出`ActivityNotException`。 //创建选项菜单(右上角) ui.emitter.on("create_options_menu", menu => { menu.add("日志"); menu.add("官网"); menu.add("关于"); }); //监听选项菜单点击 ui.emitter.on("options_item_selected", (e, item) => { switch (item.getTitle()) { case "日志": app.startActivity('console'); break; case "官网": app.openUrl("http://www.baidu.com"); break; case "关于": alert("信息框标题", '我是内容\n\r提示信息'); break; } e.consumed = true; }); ### 应用发送邮件 |sendEmail | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.sendEmail() | | 根据选项options调用邮箱应用发送邮件。 | | **参数名** | **类型** | | | {Object} | json对象 | 发送邮件的参数 | app.sendEmail(options) - `options` {Object} 发送邮件的参数。包括: - `email` {string} | {Array} 收件人的邮件地址。如果有多个收件人，则用字符串数组表示 - `cc` {string} | {Array} 抄送收件人的邮件地址。如果有多个抄送收件人，则用字符串数组表示 - `bcc` {string} | {Array} 密送收件人的邮件地址。如果有多个密送收件人，则用字符串数组表示 - `subject` {string} 邮件主题(标题) - `text` {string} 邮件正文 - `attachment` {string} 附件的路径。根据选项options调用邮箱应用发送邮件。这些选项均是可选的。如果没有安装邮箱应用，则抛出`ActivityNotException`。 //发送邮件给10086@qq.com和10001@qq.com。 app.sendEmail({ email: ["10086@qq.com", "10001@qq.com"], subject: "这是一个邮件标题", text: "这是邮件正文" }); ### app.startActivity(name) - `name` {string} 活动名称，可选的值为: - `console` 日志界面 - `settings` 设置界面启动Auto.js的特定界面。该函数在Auto.js内运行则会打开Auto.js内的界面，在打包应用中运行则会打开打包应用的相应界面。 app.startActivity("console"); ## 进阶: 意图Intent Intent(意图) 是一个消息传递对象，您可以使用它从其他应用组件请求操作。尽管 Intent 可以通过多种方式促进组件之间的通信，但其基本用例主要包括以下三个： - 启动活动(Activity)： Activity 表示应用中的一个"屏幕"。例如应用主入口都是一个Activity，应用的功能通常也以Activity的形式独立，例如微信的主界面、朋友圈、聊天窗口都是不同的Activity。通过将 Intent 传递给 startActivity()，您可以启动新的 Activity 实例。Intent 描述了要启动的 Activity，并携带了任何必要的数据。 - 启动服务(Service)： Service 是一个不使用用户界面而在后台执行操作的组件。通过将 Intent 传递给 startService()，您可以启动服务执行一次性操作（例如，下载文件）。Intent 描述了要启动的服务，并携带了任何必要的数据。 - 传递广播：广播是任何应用均可接收的消息。系统将针对系统事件（例如：系统启动或设备开始充电时）传递各种广播。通过将 Intent 传递给 sendBroadcast()、sendOrderedBroadcast() 或 sendStickyBroadcast()，您可以将广播传递给其他应用。本模块提供了构建Intent的函数(`app.intent()`), 启动Activity的函数`app.startActivity()`, 发送广播的函数`app.sendBroadcast()`。使用这些方法可以用来方便的调用其他应用。例如直接打开某个QQ号的个人卡片页，打开某个QQ号的聊天窗口等。 var qq = "2732014414"; app.startActivity({ action: "android.intent.action.VIEW", data:"mqq://im/chat?chat_type=wpa&version=1&src_type=web&uin=" + qq, packageName: "com.tencent.mobileqq", }); ### 构造Intent |intent | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.intent() | 对象 | 根据选项，构造一个意图Intent对象。 | | **参数名** | **类型** | | | 选项 | Object | | app.intent(options) - `options` {Object} 选项，包括： - `action` {string} 意图的Action，指意图要完成的动作，是一个字符串常量，比如"android.intent.action.SEND"。当action以"android.intent.action"开头时，可以省略前缀，直接用"SEND"代替。参见[Actions](https://developer.android.com/reference/android/content/Intent.html#standard-activity-actions)。 - `type` {string} 意图的MimeType，表示和该意图直接相关的数据的类型，表示比如"text/plain"为纯文本类型。 - `data` {string} 意图的Data，表示和该意图直接相关的数据，是一个Uri, 可以是文件路径或者Url等。例如要打开一个文件, action为"android.intent.action.VIEW", data为"file:///sdcard/1.txt"。 - `category` {Array} 意图的类别。比较少用。参见[Categories](https://developer.android.com/reference/android/content/Intent.html#standard-categories)。 - `packageName` {string} 目标包名 - `className` {string} 目标Activity或Service等组件的名称 - `extras` {Object} 以键值对构成的这个Intent的Extras(额外信息)。提供该意图的其他信息，例如发送邮件时的邮件标题、邮件正文。参见[Extras](https://developer.android.com/reference/android/content/Intent.html#standard-extra-data)。 - `flags` {Array} intent的标识，字符串数组，例如`["activity_new_task", "grant_read_uri_permission"]`。参见[Flags](https://developer.android.com/reference/android/content/Intent.html#setFlags%28int%29)。 **[v4.1.0新增]** - `root` {Boolean} 是否以root权限启动、发送该intent。使用该参数后，不能使用`context.startActivity()`等方法，而应该直接使用诸如`app.startActivity({...})`的方法。 **[v4.1.0新增]** 根据选项，构造一个意图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](https://www.baidu.com/s?wd=android%20Intent)或参考[Android指南: Intent](https://developer.android.com/guide/components/intents-filters.html#Types)。 var intent = new Intent(); // 跳转打电话 // Intent = { // action: "android.intent.action.DIAL", // data: "tel:15012345678" // } // app.startActivity(Intent) //intent.setAction("android.settings.ACCESSIBILITY_SETTINGS"); //辅助功能 //intent.setAction("android.settings.ADD_ACCOUNT_SETTINGS"); //添加账户 //intent.setAction("android.settings.AIRPLANE_MODE_SETTINGS"); //系统设置首页 //intent.setAction("android.settings.APN_SETTINGS"); //APN设置 //intent.setAction("android.settings.APPLICATION_SETTINGS"); //应用管理 //intent.setAction("android.settings.BATTERY_SAVER_SETTINGS"); //节电助手 //intent.setAction("android.settings.BLUETOOTH_SETTINGS"); //蓝牙 //intent.setAction("android.settings.CAPTIONING_SETTINGS"); //字幕 //intent.setAction("android.settings.CAST_SETTINGS"); //无线显示 //intent.setAction("android.settings.DATA_ROAMING_SETTINGS"); //移动网络 //intent.setAction("android.settings.DATE_SETTINGS"); //日期和时间设置 //intent.setAction("android.settings.DEVICE_INFO_SETTINGS"); //关于手机 //intent.setAction("android.settings.DISPLAY_SETTINGS"); //显示设置 //intent.setAction("android.settings.DREAM_SETTINGS"); //互动屏保设置 //intent.setAction("android.settings.HARD_KEYBOARD_SETTINGS"); //实体键盘 //intent.setAction("android.settings.HOME_SETTINGS"); //应用权限,默认应用设置,特殊权限 //intent.setAction("android.settings.IGNORE_BATTERY_OPTIMIZATION_SETTINGS"); //忽略电池优化设置 //intent.setAction("android.settings.INPUT_METHOD_SETTINGS"); //可用虚拟键盘设置 //intent.setAction("android.settings.INPUT_METHOD_SUBTYPE_SETTINGS"); //安卓键盘语言设置(AOSP) //intent.setAction("android.settings.INTERNAL_STORAGE_SETTINGS"); //内存和存储 //intent.setAction("android.settings.LOCALE_SETTINGS"); //语言偏好设置 //intent.setAction("android.settings.LOCATION_SOURCE_SETTINGS"); //定位服务设置 //intent.setAction("android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS"); //所有应用 //intent.setAction("android.settings.MANAGE_APPLICATIONS_SETTINGS"); //应用管理 //intent.setAction("android.settings.MANAGE_DEFAULT_APPS_SETTINGS"); //与ACTION_HOME_SETTINGS相同 //intent.setAction("android.settings.action.MANAGE_OVERLAY_PERMISSION"); //在其他应用上层显示,悬浮窗 //intent.setAction("android.settings.MANAGE_UNKNOWN_APP_SOURCES"); //安装未知应用安卓8.0 //intent.setAction("android.settings.action.MANAGE_WRITE_SETTINGS"); //可修改系统设置权限 //intent.setAction("android.settings.MEMORY_CARD_SETTINGS"); //内存与存储 //intent.setAction("android.settings.NETWORK_OPERATOR_SETTINGS"); //可用网络选择 //intent.setAction("android.settings.NFCSHARING_SETTINGS"); //NFC设置 //intent.setAction("android.settings.NFC_SETTINGS"); //网络中的更多设置 //intent.setAction("android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS"); //通知权限设置 //intent.setAction("android.settings.NOTIFICATION_POLICY_ACCESS_SETTINGS"); //勿扰权限设置 //intent.setAction("android.settings.ACTION_PRINT_SETTINGS"); //打印服务设置 //intent.setAction("android.settings.PRIVACY_SETTINGS"); //备份和重置 //intent.setAction("android.settings.SECURITY_SETTINGS"); //安全设置 //intent.setAction("android.settings.SHOW_REGULATORY_INFO"); //监管信息 //intent.setAction("android.settings.SOUND_SETTINGS"); //声音设置 //intent.setAction("android.settings.SYNC_SETTINGS"); //添加账户设置 //intent.setAction("android.settings.USAGE_ACCESS_SETTINGS"); //有权查看使用情况的应用 //intent.setAction("android.settings.USER_DICTIONARY_SETTINGS"); //个人词典 //intent.setAction("android.settings.VOICE_INPUT_SETTINGS"); //辅助应用和语音输入 //intent.setAction("android.settings.VPN_SETTINGS"); //VPN设置 //intent.setAction("android.settings.VR_LISTENER_SETTINGS"); //VR助手 //intent.setAction("android.settings.WEBVIEW_SETTINGS"); //选择webview //intent.setAction("android.settings.WIFI_IP_SETTINGS"); //高级WLAN设置 //intent.setAction("android.settings.WIFI_SETTINGS"); //选择WIFI,连接WIFI app.startActivity(intent); //取尾部电话号码并拨打电话 var num = "88888813888888888"; var phone = num.substring(num.length - 11); log(phone); // 获取到13888888888 var intent = new Intent(Intent.ACTION_CALL, app.parseUri("tel:"+phone)); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); context.startActivity(intent); ### 启动Activity界面 |startActivity | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.startActivity() | | 启动Activity界面 | | **参数名** | **类型** | | | Activity活动名称 | 字符串/对象 | 可选的值：console日志界面 settings设置界面 | app.startActivity(options) - `options` {Object} 选项根据选项构造一个Intent，并启动该Activity。 app.startActivity({ action: "SEND", type: "text/plain", data: "file:///sdcard/1.txt" }); // 跳转短信界面 app.startActivity({ packageName: "com.android.mms", className: "com.android.mms.ui.MmsTabActivity", }); ### 发送广播 |sendBroadcast | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.sendBroadcast() | | 根据选项构造一个Intent，并发送该广播。 | | **参数名** | **类型** | | | 选项 | 对象 | | app.sendBroadcast(options) - `options` {Object} 选项根据选项构造一个Intent，并发送该广播。 ### 启动服务 |startService | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.startService() | | 根据选项构造一个Intent，并启动该服务。 | | **参数名** | **类型** | | | 选项 | 对象 | | app.startService(options) - `options` {Object} 选项根据选项构造一个Intent，并启动该服务。 ### 发送特定广播 |sendBroadcast | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.sendBroadcast() | | 发送特定名称的广播 | | **参数名** | **类型** | | | 特定的广播名称 | 字符串 | `inspect_layout_hierarchy` 布局层次分析、`inspect_layout_bounds` 布局范围 | app.sendBroadcast(name) **[v4.1.0新增]** - `name` {string} 特定的广播名称，包括： - `inspect_layout_hierarchy` 布局层次分析 - `inspect_layout_bounds` 布局范围发送以上特定名称的广播可以触发Auto.js的布局分析，方便脚本调试。这些广播在Auto.js发送才有效，在打包的脚本上运行将没有任何效果。 app.sendBroadcast("inspect_layout_bounds"); ### Intent转换Shell |intentToShell | 函数名 | 返回值 | 备注 | | --- | --- | --- | | app.intentToShell() | | 根据选项构造一个Intent，转换为对应的shell的intent命令的参数。 | | **参数名** | **类型** | | | 选项 | 对象 | | 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参数的规范](https://developer.android.com/studio/command-line/adb#IntentSpec)。 ### app.parseUri(uri) **[v4.1.0新增]** - `uri` {string} 一个代表Uri的字符串，例如"file:///sdcard/1.txt", “https://www.autojs.org” - 返回 {Uri} 一个代表Uri的对象，参见[android.net.Uri](https://developer.android.com/reference/android/net/Uri)。解析uri字符串并返回相应的Uri对象。即使Uri格式错误，该函数也会返回一个Uri对象，但之后如果访问该对象的scheme, path等值可能因解析失败而返回`null`。需要注意的是，在高版本Android上，由于系统限制直接在Uri暴露文件的绝对路径，因此如果uri字符串是文件`file://...`，返回的Uri会是诸如`content://...`的形式。 // 有时候不知道为什么这个函数并不能跳进去，用安卓API就没有问题,以下为scheme跳转 importClass(android.content.Intent); importClass(android.net.Uri); var uri = new Uri.parse("scheme://com.jingmai.video.live.startapp?type=2&id=3930193"); var intent = new Intent(Intent.ACTION_VIEW, uri); app.startActivity(intent); ### 从文件路径解析uri | app.getUriForFile(path) **[v4.1.0新增]** - `path` {string} 文件路径，例如"/sdcard/1.txt" - 返回 {Uri} 一个指向该文件的Uri的对象，参见[android.net.Uri](https://developer.android.com/reference/android/net/Uri)。从一个文件路径创建一个uri对象。需要注意的是，在高版本Android上，由于系统限制直接在Uri暴露文件的绝对路径，因此返回的Uri会是诸如`content://...`的形式。 ### app.getInstalledApps([options]) \*\* [[Pro 8.0.0新增](https://pro.autojs.org/)] \*\* - `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选项用于指定返回的应用程序携带哪些信息。 // 获取系统app let apps = $app.getInstalledApps({ get: ['meta_data'], match: ['system_only'] }); console.log(apps); ### 示例 // 打开应用 var appName = rawInput("请输入应用名称"); launchApp(appName); // 发送意图-文本消息分享 var content = rawInput('请输入要分享的文本'); app.startActivity({ action: "android.intent.action.SEND", type: "text/*", extras: { "android.intent.extra.TEXT": content }, packageName: "com.tencent.mobileqq", className: "com.tencent.mobileqq.activity.JumpActivity" }); // 强制停止应用 "auto"; var appName = rawInput("请输入应用名称"); openAppSetting(getPackageName(appName)); while(!click("强制停止")); // 卸载应用 //输入应用名称 var appName = rawInput('请输入要卸载的应用名称'); //获取应用包名 var packageName = getPackageName(appName); if(!packageName){ toast("应用不存在！"); }else{ //卸载应用 app.uninstall(packageName); } // 应用工具 var i = dialogs.select("请选择工具", "获取应用包名", "打开应用详情页", "卸载应用"); if(i == -1){ alert("没有选择任何工具！"); } switch(i){ case 0: //获取应用包名 appName = rawInput("请输入应用名称", "QQ"); packageName = getPackageName(appName); toast(packageName); setClip(packageName); toast("已复制到剪贴板"); break; case 1: //打开应用详情页 appName = rawInput("请输入应用名称", "微信"); openAppSetting(getPackageName(appName)); break; case 2: //卸载应用 appName = rawInput("请输入应用名称"); packageName = getPackageName(appName); if(packageName == ""){ toast("应用不存在"); }else if(confirm("确定卸载应用" + packageName + "吗？")){ app.uninstall(packageName); } break; }