应用操作｜易编精灵开发文档

启动应用

System.launchApp(packageName: string): integer

根据应用包名打开桌面入口。返回成功只表示启动请求已提交；包名错误、没有可启动入口或系统拒绝启动时返回失败。

参数1 项

序号	名称	类型	参数说明
1	packageName	字	目标应用包名，可使用包名选择器填写。格式示例：com.example.app

返回值返回值可以不接收

序号	名称	类型	返回说明
1	执行状态	整	成功提交启动返回0，失败返回-1。

System.forceStopApp(packageName: string): (integer, string)

结束指定包名的应用进程。调用前必须已连接Root或Shizuku。

参数1 项

序号	名称	类型	参数说明
1	packageName	字	目标应用包名，可使用包名选择器填写。格式示例：com.example.app

返回值返回值可以不接收

序号	名称	类型	返回说明
1	执行状态	整	成功返回0，失败返回-1。
2	执行信息	字	返回强停结果或缺少权限的原因。

System.isAppInstalled(packageName: string): integer

检查指定包名是否已安装。目标应用存在且能够查询时返回1，否则返回0。

参数1 项

序号	名称	类型	参数说明
1	packageName	字	目标应用包名，可使用包名选择器填写。格式示例：com.example.app

返回值返回值可以不接收

序号	名称	类型	返回说明
1	安装状态	整	已安装返回1，未安装或无法查询返回0。

System.currentApp(): string

返回当前前台窗口所属应用的包名。应先连接无障碍服务；连接Root或Shizuku时也可用于兜底查询。

参数无参数

返回值返回值可以不接收

序号	名称	类型	返回说明
1	应用包名	字	成功返回前台应用包名，无法获取时返回空字符串。