PuppyIP 资源中心
跨境平台动态 10 分钟 发布于 2026-08-29 更新于 2026-09-27

TikTok Minis H5 公告退役日为 9 月 9 日:9 月 30 日前备份清单

截至 2026 年 9 月 27 日,TikTok Minis 官方迁移公告将在线 H5 小游戏的退役日列为 9 月 9 日,并计划 9 月 30 日清理旧 HTML 数据。受影响团队先核对项目状态,备份并试恢复数据;旧入口偶尔可访问不等于获得延期。

TikTok Minis HTML H5 native runtime 小游戏迁移 数据备份

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 官方迁移公告现列 2026 年 8 月 28 日起 H5 不再被接受或支持、9 月 9 日在线 H5 小游戏退役、9 月 30 日清理旧 HTML 数据;本站原有的 9 月 4 日说法已更正。
  • 平台不会自动把网页构建转换成原生包,改文件名、换 URL 或重新压缩都不算迁移。
  • 迁移不仅是客户端重建,还要重新验证登录、授权、广告、支付、分享、回访入口和服务端权益。
  • 本地存档不会自动出现在原生运行时,必须设计迁移、恢复或重新初始化路径。
  • 预览通过不等于生产验收;真实设备、审核包、支付履约和历史权益必须逐项核对。通用开发概览和发布指南仍保留 HTML 格式说明,不能据此推断现行 H5 发布资格;项目例外和实际导出状态须单独核实。

9 月 9 日后旧入口还能打开,为什么仍要先保全数据

团队在 9 月 9 日后发现旧 H5 入口偶尔还能打开,或 Developer Portal 仍显示项目,可能误把可见性当作继续支持。官方迁移公告列出的退役日是 9 月 9 日,旧 HTML 数据计划 9 月 30 日清理;不能从入口状态推断项目获得延期,也不能仅凭公告断言个别项目已经实际删除数据。

先列出受影响项目并做可验证备份:代码仓库、构建资产、配置、服务端 API、账号映射、存档、订单、余额和已购权益分别记录位置、负责人、导出时间和恢复测试。若 Portal 已无法导出,保留错误和项目 ID 联系平台支持,不覆盖原件或声称一定能恢复。

旧规则与新规则:这不是一次普通 SDK 升级

TikTok Minis 的通用开发概览仍描述 HTML 和 Native 两种运行时,发布指南也仍列 HTML5 包大小;专门迁移公告则写明 2026 年 8 月 28 日起不再接受或支持 H5、9 月 9 日在线 H5 小游戏退役、9 月 30 日清理旧 HTML 数据。旧格式说明不能单独证明当前可提交 H5;应按专门公告安排迁移,个别项目是否有书面例外须向平台核实。

原生小游戏仍运行在 TikTok App 内,不是要求团队另发独立 App;但产物必须通过 Unity、Cocos 或 Laya 等引擎及平台插件导出。标准网站、网页 URL、web build 目录或 HTML ZIP 不能直接上传为原生包,也没有自动转换流程。

迁移前先划清项目、数据和用户责任

适用对象是 TikTok Minis 上现有 HTML 小游戏的开发、发行、支付和运营团队。只使用 TikTok 普通视频、TikTok Shop 或独立网站 H5 的业务,不应把这份 Minis 运行时退役时间线套到自己身上。迁移公告未列出地区退役例外;发布指南另列企业认证、行业资格及美国、越南等地区的原生发布要求,那些要求不是 H5 延期证明。项目权限和实际导出状态应以 Developer Portal 与平台书面答复核实。

把数据分成三类:可从代码仓库重建的客户端资产;依赖 HTML 本地存储的进度和设置;由服务端账号、订单和权益系统保存的数据。第二类不会自动进入原生环境,第三类必须用稳定的用户映射逐项回读验证。无法证明权益映射正确时,停止上线而不是清空或覆盖旧记录。

退役后至 9 月 30 日的七步执行清单

第一,冻结 H5 项目版本并做多副本备份,抽样试恢复。第二,在 9 月 30 日清理前导出平台可取得的旧数据,与服务端存档、订单及权益清单对照;无法导出时保留错误并联系支持。第三,选择官方指南支持的 Unity、Cocos 或 Laya 路径。第四,用对应插件导出原生产物。第五,重新接入登录、授权、广告、内购、分享与回访能力。第六,在 DevTool、真实设备和平台测试环境验证身份、存档与支付。第七,预留审核和必要用户通知时间,只在实际通过生产验证后切换原生版本;9 月 9 日的公告退役节点已过,不能把旧 H5 包当作回滚方案。

每一步都要有验收记录:构建版本、Client Key、测试账号、设备与 TikTok 客户端版本、接口结果、订单和权益前后值。不要把模拟器、local debug 或 preview 的成功当作生产支付和历史权益已验证。

失败、停手与回滚条件

若原生包出现登录身份错配、旧存档缺失、余额或购买权益不一致、广告奖励重复、支付回调未履约,立即停止扩大流量并保留 H5 与原生两侧的只读证据。不能通过删除用户记录或重复发放来掩盖差异,应由账号、支付和游戏数据负责人共同对账。

回滚条件要在原生上线前定义;9 月 9 日公告退役节点已过,不能假设退回 H5 仍可继续运营。可回滚的是新原生版本、功能开关或流量比例;旧 HTML 数据备份必须独立保留。9 月 30 日前再次验证平台外备份可恢复;清理节点后须查看项目实际状态和官方后续通知,不能仅凭计划日期断言数据已删。

常见误区与网络边界

误区一是把 sunset 当成性能建议而非强制时间线;误区二是认为平台会自动迁移 IndexedDB 或本地文件;误区三是只验证首屏能打开,不测支付、广告和历史权益;误区四是把审核失败先归因于出口 IP。此次变化与固定出口、IP 归属或代理购买没有直接关系。

只有日志明确显示 DNS、TLS、连接超时或上传链路错误时,才参考代理连接排查清单单独验证传输层。包结构、引擎适配、权限、数据迁移和审核结果不会因更换 IP 自动修复;先保存错误码与构建信息,再按官方原生开发指南定位。

资料来源

常见问题

TikTok Minis 什么时候停止支持 HTML/H5 游戏?

截至 2026 年 9 月 27 日,官方迁移公告列出 8 月 28 日起不再接受或支持 H5、9 月 9 日在线 H5 小游戏退役、9 月 30 日清理旧 HTML 数据。受影响项目应在清理前备份并试恢复;实际项目状态另行核实。

把 H5 ZIP 重新打包可以变成原生小游戏吗?

不可以。官方明确说明标准网站、URL、web build 目录或 HTML ZIP 不能直接转换;必须用 Unity、Cocos 或 Laya 等支持路径重建并导出原生包。

迁移后用户的本地存档会自动保留吗?

不会自动保留。HTML 环境中的进度、设置和文件需要由游戏实现迁移、恢复或重新初始化,并与服务端账号和权益进行核对。

只要 DevTool 预览通过就能上线吗?

不能。还要完成真实设备、平台测试、审核和生产验证,尤其是登录、广告、支付、历史权益、分享及回访入口。

9 月 9 日后还能回滚到 H5 版本吗?

不应这样规划。官方公告将在线 H5 小游戏退役日列为 9 月 9 日;可设计的是原生版本和流量开关回滚,而不是依赖旧 H5 继续运营。

迁移或审核失败时换 IP 有用吗?

对包结构、运行时、权限、数据和审核问题无效。只有错误证据明确指向 DNS、TLS、超时或上传链路时,才需要单独排查网络。