Version: v4

启动器更新上报接入指南

部分游戏通过 TapTap 启动后，由游戏自带的启动器继续完成版本更新。但启动器更新完成后，用户回到 TapTap 仍会看到「更新游戏」按钮，导致同一次更新被提示两遍。本文档说明如何通过 .taptap/meta.json 让 TapTap 与启动器同步版本状态，消除重复提示。

接入分两步：在游戏包体中放入 .taptap/meta.json；启动器开始更新时把该文件中的版本号写为目标版本。除此之外，发布前需要做一次包体版本号检查，避免历史测试包体造成误判。

`.taptap/meta.json` 文件

游戏包体中必须包含 .taptap/meta.json 文件，放置在 TapTap 开发者中心配置的启动项同目录下。上传包体时，TapTap 后台会自动提取该文件中的版本号，无需运营手动填写。

请勿变更此路径

TapTap 客户端依赖固定路径 .taptap/meta.json（相对于开发者中心配置的启动项同目录）读取版本信息。若路径被移动或重命名，TapTap 将无法正确识别游戏版本，可能导致重复更新提示。

文件格式如下：

{
  "version": "v1.3.0",
  "app_id": 12345
}

字段说明：

字段	说明
`version`	游戏版本号，格式 `vX.X.X`，详见下文「版本号规范」。启动器更新游戏时也需要将此字段改为目标版本号。
`app_id`	游戏在 TapTap 的数字 ID，可在 TapTap 游戏页 URL 中查看，例如 `taptap.cn/app/12345`。上传时 TapTap 会校验此字段，避免包体传错游戏。

推荐在 CI/CD 构建流程中自动生成此文件，确保版本号与构建版本一致。手动维护也可以，但每次发版都需要同步更新 version 字段。

.taptap/meta.json 中的版本号必须与 TapTap 后台上传的版本号使用同一套格式，否则 TapTap 无法正确比较版本。

版本号格式

格式为 vX.X.X，示例：v1.0.0、v1.2.3。不符合格式的版本号将无法被 TapTap 正确识别。

启动器检测到新版本并开始更新（不是更新完成）时，将 .taptap/meta.json 的 version 字段修改为目标版本号——即将更新到的版本，而不是当前已安装版本。例如目标版本为 v1.3.0：

{
  "version": "v1.3.0",
  "app_id": 12345
}

TapTap 读取到新版本号后，对该版本及以下版本不再显示「更新游戏」按钮；后续线上出现更高版本时该判断会自动失效。多次写入更高版本号时直接覆盖旧值，无副作用。

更新失败时不需要回滚 version 字段。启动器自身可以重试或修复，TapTap 不会因为此次失败而重新提示更新。

tip

只需在开始更新时修改版本号，不需要在更新完成或失败时做额外处理。

高风险提示

首次接入更新上报后，请务必检查 TapTap 开发者中心里已上传包体的版本号。不要保留高于当前正式发布版本的包体版本号。