游戏版本更新规则

本文档介绍 TapTap PC 在执行游戏版本升级时对游戏包体中文件的新增、删除与修改策略。
请开发者遵循下列规则，确保增量/差量补丁能够正确生成并高效分发。

规则速览

旧版本文件状态	新版本文件状态	TapTap 行为	说明
❌ 不存在	✅ 存在	下载新文件
✅ 存在	❌ 不存在	删除文件	不校验旧版本文件内容（即使在运行期被修改，也会删除）
✅ 存在	✅ 存在且内容相同	忽略	不校验旧版本文件内容（即使在运行期被修改，也会忽略）
✅ 存在	✅ 存在且内容不同	仅下载差异块	不校验旧版本文件内容；请确保 旧版本文件在运行期未被改写
❌ 不存在	❌ 不存在	保留文件	运行时生成的文件不会被删除/修改

示例：三种文件变化

旧版本 /
├─ game.exe
├─ data/level1.bin
└─ data/texture.png

新版本 /
├─ game.exe        (内容修改)
├─ data/level1.bin (未改动)
└─ data/level2.bin (新增)

处理结果：

1. game.exe → 仅下载差异块
2. data/level2.bin → 下载完整新文件
3. data/level1.bin → 保留

开发者最佳实践

存档与用户数据处理

• 将 游戏存档 放置于专用目录（例如 Saves/），并在打包时排除该目录。
• 将 玩家个性化配置（键位、画质、语言等）放置于专用目录（例如 UserSettings/），并排除在包体之外。

包内容建议

• 只读原则：包体内文件运行期保持只读，禁止动态改写。
• 路径稳定：相同资源在不同版本中保持一致的相对路径与文件名。
• 移除冗余资源：删除不再使用的旧资源文件，减小补丁体积。

增量/差量更新注意事项

• 当文件在新旧版本中同时存在时，TapTap 自动检测差异，仅下载变动数据块。
• 为获得最佳差量效果，请遵循以下规范：
  1. 相同文件保持路径与文件名不变。
  2. 不在目录结构中携带版本号信息。
  3. 旧版本文件在运行期不得被改写。
  4. 通过版本控制系统精确管理资源变动，避免临时文件进入包体。

遵循以上最佳实践，可显著提升差量补丁生成效率并最小化用户的下载体积与更新时长。

常见问题 FAQ

Q1: 为什么增量补丁大小仍然接近完整包？
请检查旧版本文件是否在运行期被改写，或资源路径/文件名是否发生变动。

Q2: 运行期动态生成的日志/缓存会被删除吗？
不会。TapTap 仅对包体中已知文件执行增量校验，运行期生成的文件不会被删除或修改。