在按键精灵自动化脚本开发中，获取设备已安装 APP 列表是常见需求，Sys.GetAppList 函数便是实现这一功能的核心工具。本文将从函数基础信息、返回数据解析、代码实践及注意事项四个维度，为你详细讲解该函数的使用方法。
一、函数基础信息
Sys.GetAppList 函数的核心作用是获取设备上已安装的 APP 列表，无需传入任何参数即可调用，且在特定版本的按键精灵中才能正常运行。
- 支持版本：安卓版需为 v4.1.3 及以上，iOS 新版引擎需为 v2.2.1 及以上。
- 函数语法：采用result = Sys.GetAppList()的固定格式，其中result用于接收函数返回的 APP 列表数据。
- 参数说明：该函数无输入参数，调用时直接书写函数名并加括号即可。
二、返回数据解析
函数返回值为 table 类型（键值表），其长度与设备上已安装 APP 的数量一致，每个 APP 对应的 table 包含四个关键字段，各字段含义和类型明确，便于后续数据处理。
| 返回名 | 返回类型 | 返回说明 |
|---|---|---|
| result | table | 返回含有数组的键值表的响应结果信息，如存在n个结果，则table长度为n |
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| displayName | string | 应用名称 |
| bundleId | string | 应用包名 |
| version | string | 应用版本号 |
| appType | int |
应用类型，0：系统应用，1：用户应用 支持返回该字段版本：安卓版v4.1.3或以上版本 |
脚本例子：
dim ret = sys.GetAppList()
For i = 1 To Len(ret)
TracePrint "应用名称：" & ret[i]["displayName"] &_
",应用包名：" & ret[i]["bundleId"] &_
",应用版本：" & ret[i]["version"] &_
",应用类型：" & ret[i]["appType"]
Next
备注说明
安卓版如遇到无法获取列表问题，请确认是否已开启按键或小精灵获取应用列表权限