$app - 应用操作
- 更新时间:2026-02-08 19:43:35
应用操作
这里包含了一写常用的应用操作、意图操作、或者一些拓展操作:发送短信等等。
getIcon(name)
获取应用图标
- 参数 : name {string} 应用名称或包名
- 返回 : {Image} 图标
- 版本 : 1.0.0
runApp(appName)
运行应用
- 参数 : appName {String} 应用名
- 返回 : {boolean} 是否运行成功
- 版本 : 1.0.0
launchApp(appName)
运行应用
这个函数的效果和$app.runApp("应用");相同
- 参数 : appName {String} 应用名称
- 返回 : {boolean} 是否运行成功
- 版本 : 1.0.0
launch(appName)
运行应用
这个函数的效果和$app.runApp("应用");相同
- 参数 : appName {String} 应用名称
- 返回 : {boolean} 是否运行成功
- 版本 : 1.0.0
launchPkg(packageName)
运行包名
此函数和$app.runPkg("包名");效果相同
- 参数 : packageName {String} 程序包名
- 返回 : {boolean} 是否跳转成功
- 版本 : 1.0.0
runPkg(packageName)
运行包名
- 参数 : packageName {String} 程序包名
- 返回 : {boolean} 是否跳转成功
- 版本 : 1.0.0
run(name)
打开应用(推荐)
最简洁的启动应用函数,推荐使用
- 参数 : name {string} 包名或程序名称
- 返回 : {boolean} 是否打开成功
- 版本 : 1.0.0
ls()
获得应用列表
- 返回 : {AppInfo[]} 应用信息列表
- 版本 : 1.0.0
lsUserApp()
获得用户应用列表
- 返回 : {AppInfo[]} 应用列表
- 版本 : 1.3.2
lsSysApp()
获得系统应用列表
- 返回 : {AppInfo[]} 应用列表
- 版本 : 1.3.2
lsRecent()
获得最近运行的应用
- 返回 : {AppTaskInfo[]} 应用信息列表
- 版本 : 1.0.1
startActivity(name)
打开AIGame中的界面
允许用户打开本应用中集成的各种调试界面:Log日志、Device设备信息、Ocr文字识别、Yolo目标检测、Shizuku高级权限等。
- 参数 : name {string} 界面名称
- 版本 : 1.6.9
startActivity(name, activityName)
启动活动
- 参数 : name {String} 包名或应用名
- 参数 : activityName {String} activity地址
- 返回 : {boolean} 是否跳转成功
- 版本 : 1.0.0
pkgExists(pkgName)
包名是否存在
- 参数 : pkgName {String} 包名
- 返回 : {boolean} 是否存在
- 版本 : 1.0.0
getPackageName(appName)
获得包名名称
效果和$app.pkgName("QQ");相同
- 参数 : appName {String} app名称
- 返回 : {String} 包名
- 版本 : 1.0.0
pkgName(appName)
获得包名名称
- 参数 : appName {String} app名称
- 返回 : {String} 包名
- 版本 : 1.0.0
appName(packageName)
根据包名拿应用名
- 参数 : packageName {String} 包名
- 返回 : {String} app名称
- 版本 : 1.0.0
installApk(apkPath)
安装apk文件
此函数会获取系统的安装意图,然后尝试安装apk文件,前提是apk文件必须存在
- 参数 : apkPath {string} 路径(支持相对路径)
- 返回 : {boolean} 是否成功获取安装意图
- 版本 : 1.3.3
uninstallApp(name)
卸载应用
- 参数 : name {string} 应用名称
- 版本 : 1.0.0
uninstallPkg(name)
卸载包名
部分手机不支持
- 参数 : name {string} 应用名称或包名
- 版本 : 1.0.0
uninstall(name)
卸载
- 参数 : name {string} 应用名称或包名
- 版本 : 1.0.0
openUrl(url)
打开链接
如果传入的网址不是以"http"开头的,则默认追加"http://"到连接前面
- 参数 : url {string} 网页链接
- 版本 : 1.0.0
shareImg(imgPath)
分享图片
- 参数 : imgPath {string} 图片路径
- 版本 : 1.0.0
shareText(content)
分享文本
- 参数 : content {string} 内容
- 版本 : 1.0.0
sendSms(phone, message)
发送短信
跳转到发送短信的界面
- 参数 : phone {string} 电话号码
- 参数 : message {string} 短信内容
- 版本 : 1.0.0
call(phoneNumber)
拨打电话
如果拥有电话权限会直接拨通电话
- 参数 : phoneNumber {string} 电话号码
- 版本 : 1.0.0
sendMail(mail, title, content)
发送邮件
需要手机有自带的邮箱功能或应用
- 参数 : mail {string} 收件邮箱
- 参数 : title {string} 标题
- 参数 : content {string} 内容
- 返回 : {boolean} 是否发送成功
- 版本 : 1.0.0
openAppSetting(name)
打开应用设置
和$app.appSetting("AIGame Pro");效果相同
会打开应用详情设置界面
- 参数 : name {string} 应用名称或包名
- 返回 : {boolean} 是否打开成功
- 版本 : 1.0.0
appSetting(name)
打开应用设置
会打开应用详情设置界面
- 参数 : name {string} 应用名称或包名
- 返回 : {boolean} 是否打开成功
- 版本 : 1.0.0
viewFile(path)
查看文件
- 参数 : path {string} 文件路径
- 返回 : {boolean} 是否打开成功
- 版本 : 1.0.0
editFile(path)
编辑文件
- 参数 : path {string} 文件路径
- 返回 : {boolean} 是否打开成功
- 版本 : 1.0.0
hasUsagePermit()
是否有使用情况权限
- 返回 : {boolean} 是否有使用情况权限
- 版本 : 1.0.1
getUsagePermit()
获取使用情况权限
- 返回 : {boolean} 是否打开成功
- 版本 : 1.0.1
intent(options)
创建意图
- 参数 : options {Object} 配置参数
- 返回 : {Intent} 意图
- 版本 : 1.0.1
这里我给个我自己经常使用的工具函数,就是添加QQ群函数。
sendBroadcast(intent)
发送异步广播
- 参数 : intent {Intent} 意图
- 版本 : 1.0.1
sendBroadcast(intent, permis)
发送异步广播(含权限)
- 参数 : intent {Intent} 意图
- 参数 : permis {string} 权限
- 版本 : 1.0.1
sendOrderedBroadcast(intent, permis)
发送同步广播
- 参数 : intent {Intent} 意图
- 参数 : permis {string} 权限
- 版本 : 1.0.1
startActivity(intent)
用意图启动Activity
- 参数 : intent {Intent} 意图
- 版本 : 1.0.1
startActivity(options)
启动Activity
- 参数 : options {Object} 意图配置
- 版本 : 1.1.1
getForeApps()
获取前台应用
此方法只在低版本安卓中有明显效果,建议使用 $root.lsRunningApps((pkg)=>{}); 来获取前台应用
- 返回 : {String[]} 前台应用包名列表
- 版本 : 1.0.4
kill(name)
杀死应用
如果有root权限,优先使用root权限来杀死应用,如果有shizuku则使用shizuku来杀死应用
在低版本的安卓中,直接就可以通过活动管理器杀死应用,但是在较高版本的安卓中(安卓9+)很可能无法直接杀死应用进程。
- 参数 : name {string} 应用名或包名
- 版本 : 1.0.4
sendMms(phone, title, message, imgPath)
发送彩信
- 参数 : phone {string} 电话号码
- 参数 : title {string} 主题(可为null)
- 参数 : message {string} 短信内容
- 参数 : imgPath {string} 图片全路径(无法支持相对路径)
- 版本 : 1.4.9
openSelf()
打开自身
打开自身的主活动(通常是启动器图标点击后的活动)。
此方法尝试使用启动器意图来打开应用。如果失败(例如,应用未安装),则会创建一个新的意图来启动主活动。
如果是打包后的apk则会打开打包后的apk主界面
- 版本 : 1.6.2