AutoJs6

- Overview - 综述
- About - 关于文档
- Progress - 文档部署进度
- Changelog - 文档更新日志

- Manual - AutoJs6 使用手册
- Q & A - 疑难解答

- Global - 全局对象
- Automator - 自动化
- AutoJs6 - 本体应用
- App - 通用应用
- Color - 颜色
- Image - 图像
- OCR - 光学字符识别
- Barcode - 条码
- QR Code - 二维码
- Keys - 按键
- Device - 设备
- Storage - 储存
- File - 文件
- Engine - 引擎
- Task - 任务
- Module - 模块
- Plugins - 插件
- Toast - 消息浮动框
- Notice - 消息通知
- Console - 控制台
- Shell
- Shizuku
- Media - 多媒体
- Sensor - 传感器
- Recorder - 记录器
- Timer - 定时器
- Thread - 线程
- Continuation - 协程
- Event - 事件监听
- Dialog - 对话框
- Floaty - 悬浮窗
- Canvas - 画布
- UI - 用户界面
- Web - 万维网
- HTTP
- Base64
- Crypto - 密文
- Internationalization - 国际化
- Standardization - 标准化
- E4X

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- WebSocket
- EventEmitter - 事件发射器
- ImageWrapper - 包装图像类
- App - 应用枚举类
- Color - 颜色类
- Version - 版本工具类
- Polyfill - 代码填泥
- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

- Exceptions - 异常
- Intent - 意图
- Runtime - 运行时
- Context - 上下文
- Activity - 活动

- Scripting Java - 脚本化 Java
- Android API Level - 安卓 API 级别
- Color Table - 颜色列表

- Glossaries - 术语
- HttpHeader - HTTP 标头
- HttpRequestMethods - HTTP 请求方法
- MimeType - MIME 类型
- NotificationChannel - 通知渠道

- Data Types - 数据类型
- Omnipotent Types - 全能类型
- Storage - 存储类
- AndroidBundle
- AndroidRect
- CryptoCipherOptions
- CryptoKey
- CryptoKeyPair
- ConsoleBuildOptions
- HttpRequestBuilderOptions
- HttpRequestHeaders
- HttpResponseBody
- HttpResponseHeaders
- HttpResponse
- InjectableWebClient
- InjectableWebView
- NoticeOptions
- NoticeChannelOptions
- NoticePresetConfiguration
- NoticeBuilder
- Okhttp3HttpUrl
- OcrOptions
- Okhttp3Request
- OpencvPoint
- OpencvRect
- OpencvSize

- GitHub - 应用项目地址
- GitHub - 文档项目地址

# 应用枚举类 (App)#

为便于与其他应用交互, AutoJs6 内置了部分常见应用的信息, 如下表:

枚举实例名 | 中文名 | 英文名 | 包名 | 别名
--- | --- | --- | --- | ---
ACCUWEATHER | AccuWeather | ~ | com.accuweather.android | accuweather
ADM | ADM | ~ | com.dv.adm | adm
ALIPAY | 支付宝 | Alipay | com.eg.android.AlipayGphone | alipay
AMAP | 高德地图 | Amap | com.autonavi.minimap | amap
APPOPS | App Ops | ~ | rikka.appops | appops
AQUAMAIL | Aqua Mail | ~ | org.kman.AquaMail | aquamail
AUTOJS | Auto.js | ~ | org.autojs.autojs | autojs
AUTOJS6 | AutoJs6 | ~ | org.autojs.autojs6 | autojs6
AUTOJSPRO | AutoJsPro | ~ | org.autojs.autojspro | autojspro
BAIDUMAP | 百度地图 | BaiduMap | com.baidu.BaiduMap | baidumap
BILIBILI | 哔哩哔哩 | bilibili | tv.danmaku.bili | bilibili
BREVENT | 黑阈 | Brevent | mie.piebridge.brevent | brevent
CALENDAR | 日历 | Calendar | com.google.android.calendar | calendar
CHROME | Chrome | ~ | com.android.chrome | chrome
COOLAPK | 酷安 | CoolApk | com.coolapk.market | coolapk
DIANPING | 大众点评 | Dianping | com.dianping.v1 | dianping
DIGICAL | DigiCal | ~ | com.digibites.calendar | digical
DRIVE | 云端硬盘 | Drive | com.google.android.apps.docs | drive
ES | ES文件浏览器 | ES File Explorer | com.estrongs.android.pop | es
EUDIC | 欧路词典 | Eudic | com.qianyan.eudic | eudic
EXCEL | Excel | ~ | com.microsoft.office.excel | excel
FIREFOX | Firefox | ~ | org.mozilla.firefox | firefox
FX | FX | ~ | nextapp.fx | fx
GEOMETRICWEATHER | 几何天气 | Geometric Weather | wangdaye.com.geometricweather | geometricweather
HTTPCANARY | HttpCanary | ~ | com.guoshi.httpcanary.premium | httpcanary
IDLEFISH | 闲鱼 | ~ | com.taobao.idlefish | idlefish
IDMPLUS | IDM+ | ~ | idm.internet.download.manager.plus | idm+
JD | 京东 | ~ | com.jingdong.app.mall | jd
KEEP | Keep | ~ | com.gotokeep.keep | keep
KEEPNOTES | Keep 记事 | Keep Notes | com.google.android.keep | keepnotes
MAGISK | Magisk | ~ | com.topjohnwu.magisk | magisk
MEITUAN | 美团 | Meituan | com.sankuai.meituan | meituan
MT | MT管理器 | MT Manager | bin.mt.plus | mt
MXPRO | MX 播放器专业版 | MX Player Pro | com.mxtech.videoplayer.pro | mxpro
ONEDRIVE | OneDrive | ~ | com.microsoft.skydrive | onedrive
PACKETCAPTURE | Packet Capture | ~ | app.greyshirts.sslcapture | packetcapture
PARALLELSPACE | 平行空间(原双开大师) | Parallel Space | com.lbe.parallel.intl | parallelspace
POWERPOINT | PowerPoint | ~ | com.microsoft.office.powerpoint | powerpoint
PULSARPLUS | Pulsar+ | ~ | com.rhmsoft.pulsar.pro | pulsarplus
PUREWEATHER | Pure天气 | ~ | hanjie.app.pureweather | pureweather
QQ | QQ | ~ | com.tencent.mobileqq | qq
QQMUSIC | QQ音乐 | QQMusic | com.tencent.qqmusic | qqmusic
SDMAID | SD Maid | ~ | eu.thedarken.sdm | sdmaid
SHIZUKU | Shizuku | ~ | moe.shizuku.privileged.api | shizuku
STOPAPP | 小黑屋 | ~ | web1n.stopapp | stopapp
TAOBAO | 淘宝 | ~ | com.taobao.taobao | taobao
TRAINNOTE | 训记 | ~ | com.trainnote.rn | trainnote
TWITTER | Twitter | ~ | com.twitter.android | twitter
UNIONPAY | 云闪付 | ~ | com.unionpay | unionpay
VIA | Via | ~ | mark.via.gp | via
VYSOR | Vysor | ~ | com.koushikdutta.vysor | vysor
WECHAT | 微信 | WeChat | com.tencent.mm | wechat
WORD | Word | ~ | com.microsoft.office.word | word
ZHIHU | 知乎 | ~ | com.zhihu.android | zhihu

通常 "别名" 字段取自 "枚举实例名" 字段的名称小写形式.
表列 "英文名" 中波浪符号表示与 "中文名" 对应字段名称相同.

> 注: 上述信息可能发生变更.
> 例如一些应用在某个时间点开始去除了 "英文名" 并统一使用 "中文名" 字段, 甚至部分应用会在每个版本均变更其应用名.
> 如果用户编写的脚本对应用名十分敏感, 建议使用 App#getAppName 或 app.getAppName 等方式获取设备中已安装应用的真实应用名.

App

## [@] App#

`6.2.0` `Global` `Enum`

App 为枚举类, 因此可使用 Java 通用的枚举类方法:

    /* 打印所有枚举实例名. */
    console.log(App.values().map(o => o.name()));

    /* 获取一个枚举实例. */
    const tt = App.FIREFOX;

    /* 调用实例方法. */
    console.log(tt.getAppName());
    console.log(tt.getPackageName());
    console.log(tt.getAlias());

## [m#] getAppName#

获取枚举实例的应用名.

### getAppName()#

- returns { string }

优先获取设备中已安装应用的应用名, 若应用未安装, 则获取 App 枚举实例中预置的应用名.

    // "Firefox"
    console.log(App.FIREFOX.getAppName());

## [m#] getAppNameZh#

获取枚举实例中预置的中文应用名.

### getAppNameZh()#

- returns { string }

    // "支付宝"
    console.log(App.ALIPAY.getAppNameZh());

## [m#] getAppNameEn#

获取枚举实例中预置的英文应用名.

### getAppNameEn()#

- returns { string }

    // "Alipay"
    console.log(App.ALIPAY.getAppNameEn());

## [m#] getPackageName#

获取枚举实例中预置的应用包名.

### getPackageName()#

- returns { string }

    // "com.eg.android.AlipayGphone"
    console.log(App.ALIPAY.getPackageName());

## [m#] getAlias#

获取枚举实例中预置的应用别名.

### getAlias()#

- returns { string }

    // "alipay"
    console.log(App.ALIPAY.getAlias());

## [m#] isInstalled#

检查枚举实例是否在设备安装.

### isInstalled()#

- returns { boolean }

    /* e.g. true */
    console.log(App.ALIPAY.isInstalled());

## [m#] ensureInstalled#

确保枚举实例在设备安装, 否则抛出异常.

### ensureInstalled()#

- returns { void }

    App.FIREFOX.ensureInstalled();

## [m#] uninstall#

卸载设备中存在的枚举实例应用.

### uninstall()#

- returns { void }

    App.FIREFOX.uninstall();

## [m#] launch#

启动设备中的枚举实例应用.

### launch()#

- returns { boolean }

若应用未安装或启动过程中出错, 将返回 false (而非抛出异常).

    /* e.g. true */
    console.log(App.FIREFOX.launch());

## [m#] openSettings#

跳转至枚举实例应用的应用详情页面.

### openSettings()#

- returns { boolean }

若应用未安装或跳转页面过程中出错, 将返回 false (而非抛出异常).

    /* e.g. true */
    console.log(App.FIREFOX.openSettings());

## [m#] toString#

获取枚举实例自定义的实例信息字符串.

### toString()#

- returns { string }

    /* e.g. {appName: "Firefox", packageName: "org.mozilla.firefox", alias: "firefox"} */
    console.log(App.FIREFOX.toString());
    console.log(App.FIREFOX); /* 同上. */

## [m] getAppByAlias#

通过应用别名获取对应的 App 实例.

### getAppByAlias(alias)#

- alias { string } - 应用别名
- returns { App | null }

应用别名对应的枚举实例不存在时将返回 null:

    let tt = App.getAppByAlias('twitter');
    if (tt !== null) {
        console.log(tt.getPackageName());
    }