App 模块
android.app 负责设备基础信息、应用控制、插件加载和部分系统级能力，是大多数接入项目最先调用的模块。
典型场景
- 获取设备信息与运行环境
- 控制应用前后台切换
- 拉起其他应用或回到 AccBot 自身
- 显示提示、管理任务栏或桌面图标
- 查询 SDK 构建信息与插件列表
常用方法
getDeviceInfo()
获取当前设备的基础信息。
- 所属模块：
android.app - 参数：无
- 返回值：
Promise<GetDeviceInfoRes> - 常见字段：
model、version、packName、screenWidth、screenHeight
const info = await android.app.getDeviceInfo()
console.log(info.packName, info.screenWidth, info.screenHeight)getDeviceInfoSys()
获取更偏底层视角的设备信息。
- 参数：无
- 返回值：
Promise<GetDeviceInfoSysRes>
const info = await android.app.getDeviceInfoSys()
console.log(info.manufacturer, info.hardware)getRam()
获取设备与当前进程内存信息。
- 参数：无
- 返回值：
Promise<GetRamRes> - 典型字段：
availMem、totalMem、usedMemInBytes
toast(msg, t)
显示 Toast 提示。
- 参数：
msg: string：提示内容t: number：显示时长（毫秒）
- 返回值：
Promise<void>
await android.app.toast('连接成功', 3000)openPm()
点亮屏幕或唤醒电源相关状态。
- 参数：无
- 返回值：
Promise<void>
runApp(packageName)
启动目标应用。
- 参数：
packageName: string - 返回值：
Promise<boolean | void> - 常见用法：跳转到设置页、打开业务应用后再做节点查找
await android.app.runApp('com.android.settings')backToSelf()
回到 AccBot 自身应用。
- 参数：无
- 返回值：
Promise<boolean | void>
showTaskBar(show)
控制是否显示在最近任务中。
- 参数：
show: boolean - 返回值：
Promise<void>
showIcon(show)
控制桌面图标显示状态。
- 参数：
show: boolean - 返回值：
Promise<void> - 注意：某些场景下关闭图标可能影响应用入口显示，发布前应谨慎验证。
registerRouteApp(app, fun) / registerRouteSys(app, fun)
注册自定义路由方法。
- 参数：
app: string：模块名fun: string：方法名
- 返回值：
Promise<void> - 适用场景：扩展自定义能力或接入额外控制器
返回值说明
App 模块很多方法返回对象，字段会随着底层能力变化。实际接入时，建议先 console.log 一次完整结果，再提取你真正依赖的字段，避免把临时字段写死在业务里。