跟踪项配置编写
JSON 内容示意
{
"base_version": 1,
"uuid": "f27f71e1-d7a1-4fd1-bbcc-9744380611a1",
"info": {
"app_name": "UpgradeAll",
"config_version": 1,
"url": "https://github.com/xz-dev/UpgradeAll"
},
"app_config": {
"hub_info": {
"hub_uuid": "fd9b2602-62c5-4d55-bd1e-0d6537714ca0"
},
"target_checker": {
"api": "app_package",
"extra_string": "net.xzos.upgradeall"
}
}
}
节点解释
base_version
当前最新版本号:1
该值标记该配置文件遵守的跟踪项配置格式标准
过时的版本号(过低的值)可能导致软件无法读取解析当前配置文件
uuid
该字符串作为跟踪项配置的唯一识别码(UUID v4)
若用户从云端仓库拉取了你的配置文件,该 UUID 将一并被软件记录,并且后续检查云端配置更新都将以该值为标准
注意:UUID 与配置文件(包括软件源)一一对应,且作为唯一识别码(你可以理解为身份证号码)
info
该节点包括软件源的大部分不强制规定书写格式的描述性文本
app_name
你认为跟踪项应该叫做的名字(尽量使用大家都了解含义的词语,请不要一味套用相关的项目名称,因为那可能长且无明确意义)
config_version
跟踪项配置的版本号,用来告诉 UpgrdeAll 软件是否应该使用云端配置更新本地配置
一般来说,每次你修改并上传云端,你都应该将该值加一
url
跟踪项的软件项目地址
- 在每次 UpgradeAll 检查更新时,软件将会将该值作为变量传入软件源脚本运行环境,以便于软件源脚本获知它应该从哪个网址获取更新信息
- 同时,该地址也会展示在用户界面,以便用户可以访问该网址以查看被跟踪的软件的相关信息
app_config
跟踪项核心配置相关
hub_info
跟踪项调用的软件源相关信息
hub_uuid
跟踪项调用的软件源的 UUID(UpgradeAll 软件使用 UUID 识别软件源)
软件源 UUID:
- GITHUB:fd9b2602-62c5-4d55-bd1e-0d6537714ca0
- COOLAPK:1c010cc9-cff8-4461-8993-a86cd190d377
- 手机乐园:1c010cc9-cff8-4461-8993-a86mm190d377
- F-droid:6a6d590b-1809-41bf-8ce3-7e3f6c8da945
- GITLAB:a84e2fbe-1478-4db5-80ae-75d00454c7eb
- Xposed Module Repository:e02a95a2-af76-426c-9702-c4c39a01f891
target_checker
用于获取跟踪项本地信息
api
UpgradeAll 将通过哪个 API 获取被跟踪的软件的本地信息
可能的值:
- app_package(软件包名)
- magisk_module(Magisk 模块文件夹名)
- shell(自定义 Shell 命令)
- shell_root(具有 Root 权限的自定义 Shell 命令)
extra_string
软件获取被跟踪的软件的本地信息时需要的附加信息 例如:
- 软件包名
- Magisk 模块文件夹名
- Shell 命令