App
App对象提供了一些应用相关的数据获取能力,比如当前App的版本号、获取某个App的版本等。
currentPackageName()
返回: {string}
获取当前应用的包名,获取你当前开发的App的包名,比如在DeekeScript中执行这个函数,将获取到"top.deeke.script"
console.log(App.currentPackageName());//输出 top.deeke.scriptcurrentVersionCode()
返回: {number} 整型
返回当前App的版本号,这个在App更新的时候判断当前App的版本号时很有用
currentVersionName()
返回: {string}
返回当前App的版本名称
packageInfo(packageName)
参数: packageName {string} 包名
返回: {PackageInfo}
返回指定App的包信息,通过包信息你可以获取诸如"版本号,版本名称"等信息,可以遍历查看其属性和值
let packageInfo = App.packageInfo("top.deeke.script");
console.log(packageInfo.versionCode); // 版本号
console.log(packageInfo.versionName); // 版本名称gotoIntent(uri)
参数: uri {string}
返回: {void}
根据URI启动Activity
//打开抖音用户主页 user_id是抖音的用户ID
App.gotoIntent('snssdk1128://user/profile/' + user_id);backApp()
返回: {void}
返回到执行脚本的APP
App.backApp();launch(packageName)
参数: packageName {string}
通过包名打开应用
App.launch("top.deeke.script");//打开DeekeScriptisAppInstalled(packageName)
参数: packageName {string}
判断应用是否已安装
let isInstalled = App.isAppInstalled("top.deeke.script");getAppVersionCode(packageName)
参数: packageName {string}
获取指定应用的版本号
let version = App.getAppVersionCode("top.deeke.script");getAppVersionName(packageName)
参数: packageName {string}
获取指定应用的版本名称
let versionName = App.getAppVersionName("top.deeke.script");openAppSetting(packageName)
参数: packageName {string} 包名
返回: {void}
打开某个APP的设置页面
startActivity(intent)
2.0版本即将上线
参数: intent {Intent}
返回: {void}
根据intent启动Activity
//跳转到目标APP
let intent = new Intent(Intent.ACTION_VIEW, Uri.parse("myapp://second_activity"));
startActivity(intent);notifySuccess(title, content)
参数:
title {string}通知标题content {string}通知内容
返回: {void}
显示成功通知
App.notifySuccess("操作成功", "任务已完成");notifyInput(title, content, hint?, timeoutMs?, afterPosted?)
在通知栏放一条可回复通知,并阻塞到用户提交、取消或超时。不会把本应用拉回前台,适合停在系统设置页时抄数。无线调试首次配对:先打开开发者选项 / 无线调试,用本方法在通知栏收 6 位码,见 开启与配对。需要 POST_NOTIFICATIONS(Android 13+)且系统未关闭本应用通知。
四种调用:
App.notifyInput(title, content);
App.notifyInput(title, content, hint);
App.notifyInput(title, content, hint, afterPosted);
App.notifyInput(title, content, hint, timeoutMs, afterPosted);参数:
title {string}标题content {string}正文hint {string}可选。「输入」按钮里的提示,默认「输入内容」timeoutMs {number}可选。等待毫秒,小于等于 0 表示一直等到回复或取消afterPosted {function}可选。通知发出之后、开始等待之前调用,例如先跳到无线调试
返回: {string} 用户输入。取消、划掉通知或超时时为空字符串。没有通知权限,或系统已关闭本应用通知时抛出异常。
let code = App.notifyInput(
"无线调试配对",
"点「输入」回复 6 位配对码。不要回到本应用。",
"6 位配对码",
function () {
Adb.openWirelessDebuggingSettings();
}
);openUrl(url, packageName)
参数:
url {string}URL地址packageName {string}包名(可选,用于指定打开URL的应用)
返回: {void}
打开URL地址。如果提供了packageName参数,则优先使用指定应用打开,如果应用未安装则使用浏览器打开;如果未提供packageName参数,则直接使用浏览器打开。
// 使用浏览器打开URL
App.openUrl("https://www.baidu.com");
// 通过指定应用(如抖音)打开URL
App.openUrl("https://www.douyin.com/user/xxx", "com.ss.android.ugc.aweme");
// 如果指定应用未安装,则自动使用浏览器打开
App.openUrl("https://www.douyin.com/user/xxx", "com.ss.android.ugc.aweme");