在按键精灵自动化脚本开发中，获取设备已安装 APP 列表是常见需求，Sys.GetAppList 函数便是实现这一功能的核心工具。本文将从函数基础信息、返回数据解析、代码实践及注意事项四个维度，为你详细讲解该函数的使用方法。

一、函数基础信息

Sys.GetAppList 函数的核心作用是获取设备上已安装的 APP 列表，无需传入任何参数即可调用，且在特定版本的按键精灵中才能正常运行。

• 支持版本：安卓版需为 v4.1.3 及以上，iOS 新版引擎需为 v2.2.1 及以上。
• 函数语法：采用result = Sys.GetAppList()的固定格式，其中result用于接收函数返回的 APP 列表数据。
• 参数说明：该函数无输入参数，调用时直接书写函数名并加括号即可。

二、返回数据解析

函数返回值为 table 类型（键值表），其长度与设备上已安装 APP 的数量一致，每个 APP 对应的 table 包含四个关键字段，各字段含义和类型明确，便于后续数据处理。

代码例子：

dim ret = sys.GetAppList()
For i = 1 To Len(ret)
    TracePrint "应用名称：" & ret[i]["displayName"] &_
    ",应用包名：" & ret[i]["bundleId"] &_
    ",应用版本：" & ret[i]["version"] &_
    ",应用类型：" & ret[i]["appType"]
Next

备注说明：
安卓版如遇到无法获取列表问题，请确认是否已开启按键或小精灵获取应用列表权限