IOS/ 安卓开发工具按键精灵Sys.GetAppList 函数使用指南：轻松获取设备已安装 APP 列表

ii_best2025-10-19 17:17

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

一、函数基础信息

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

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

二、返回数据解析

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

字段名	字段类型	字段说明
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

备注说明：

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