跳到主要内容
版本：v4

更新常见问题

阅读前建议先了解 TapTap PC 游戏更新机制。多数问题在理解更新机制后即可定位。

更新提示​

游戏已更新完成，TapTap 为何仍提示「更新游戏」？​

放置了 .taptap/meta.json 的游戏，TapTap 通过对比 .taptap/meta.json 版本号与线上包版本号判断是否需要更新。仍在提示，说明 TapTap 读到的 .taptap/meta.json 版本号仍低于线上包版本号。常见原因：

  • 游戏热更新后未上报版本号：热更新改动了文件，但未将 .taptap/meta.json 写为目标版本，其版本号仍为旧值。这是最常见的原因。
  • 开发者中心残留高版本包体：开发者中心仍挂有版本号高于线上正式版的包体，抬高了线上包版本号，导致 .taptap/meta.json 版本号低于线上包版本号。
  • .taptap/meta.json 路径或格式有误：路径被改名 / 移动，或版本号不符合 vX.X.X 格式，TapTap 读不到有效版本号，按「需要更新」处理。

排查与接入步骤见 游戏自更新版本上报。

仅由 TapTap 分发更新的游戏会出现重复提示吗？​

一般不会。TapTap 分发更新安装的就是当前线上包，安装完成后本地即为线上包，二者天然一致。重复提示几乎只出现在游戏自更新的场景。

.taptap/meta.json 版本号如何与线上包版本号比较？​

按 vX.X.X 从左到右逐段比较数字大小，例如 v1.2.3 < v1.2.4 < v1.3.0 < v2.0.0。.taptap/meta.json 版本号不低于线上包版本号时不提示，低于时提示并更新。格式要求见 版本号规范。

更新包大小​

增量补丁大小为何仍接近完整包？​

通常是因为 TapTap 无法复用旧文件。请检查：

  • 旧版本文件是否在运行期被改写（被改写后无法作为差异基准）。
  • 资源的路径或文件名是否变更（路径变更会被视为新文件，触发全量下载）。

详见 文件规则。

同一版本，自测时更新量大、正式上线后变小，是否正常？​

正常。提审通过前采用增量更新（块级），通过后自动升级为差量更新（二进制 diff），差量更新量更小。详见 增量更新与差量更新。

文件与数据​

运行期生成的日志 / 缓存 / 存档会被删除吗？​

取决于其所在目录在新版本中是否仍存在：

  • 目录仍在新版本包体中 → 目录内运行期文件不会被删除或修改。
  • 目录在新版本中被整体移除 → TapTap 递归删除整个目录，目录内运行期文件一并清理。

建议将日志、缓存、用户存档放置于包体之外的专用目录，从根本上避免版本切换时的误删。详见 目录规则 与 开发者最佳实践。

接入与发布​

首次接入自更新版本上报需注意什么？​

发布前务必检查开发者中心已上传包体的版本号，不要保留高于当前正式发布版本的包体——否则线上包版本号被抬高，会触发误判提示。详见 首次接入后清理高版本包体。

支持哪些安装包格式？大型游戏（>50GB）能否使用？​

支持 zip（推荐）与 7z 两种格式；大型游戏完全支持，包体越大，分发优势越明显。更多能力见 游戏分发系统。