近日,TikTok Minis 开发者圈内流传关于"H5 小游戏 9 月 4 日退役、9 月 30 日清理数据”的消息。经核实,该信息部分准确但关键时间节点已更新。TikTok for Developers 官网于 9 月 4 日修正了迁移时间表:在线 H5 小游戏退役时间延后至2026 年 9 月 9 日,但旧 H5 数据清理截止日仍为9 月 30 日。
图 1:TikTok Minis 官方开发者文档展示的产品内入口。来源:TikTok for Developers
明确三个关键时间节点
根据 TikTok 官方最新页面说明,迁移工作需严格遵循以下时间线:
- 8 月 28 日:平台正式停止接受新的 HTML/H5 小游戏提交,不再提供支持。后续发布或维护的小游戏必须基于原生运行时(Native Runtime)开发。
- 9 月 9 日:在线 H5 小游戏正式退役。若需继续运营,开发者必须上线原生版本,并提前完成用户通知工作。
- 9 月 30 日:平台将彻底清理旧 H5 数据。在此之前,开发者务必完成代码、素材、配置及业务数据的本地备份。
图 2:TikTok 官网当前迁移时间线中文整理,退役日已更新为 9 月 9 日。来源:TikTok for Developers
尽管退役日期延后了 5 天,但数据清理窗口并未顺延。对于尚未启动迁移的团队,这 5 天是最后的补救机会。
技术重构:单纯压缩 ZIP 无法完成迁移
H5 版本运行于 WebView 环境,而原生小游戏需运行在 TikTok 的 Native Runtime 中。官方推荐的技术路径包括使用 Unity、Cocos、Laya 等引擎,并通过对应插件导出平台认可的包体。
需要注意的是,标准网站 URL、Web Build 目录或 HTML ZIP 包均不能直接作为原生包上传。仅修改入口文件名、重新压缩或为旧项目添加外壳,均不符合迁移要求。原生版本虽仍在 TikTok App 内运行,无需单独上架应用商店,但其构建流程、运行环境及平台能力接入层均需重构。
核心风险:存档迁移与用户权益保障
客户端本地数据(如玩家进度、设置、本地文件)不会自动从 H5 迁移至原生环境,必须由游戏方设计专门的迁移、恢复或初始化方案。
服务端层面,仅确保“账号可登录”远远不够。存档、余额、道具、订单及已购权益等关键数据,需建立稳定的用户映射机制进行逐项核对。此外,广告奖励、支付履约、分享回调及回访入口等功能也需在真机环境下重新验证。DevTool 测试通过并不代表生产环境绝对安全。
建议开发者立即执行以下四项操作:
- 冻结旧 H5 版本,完整备份代码、素材、配置、接口信息及业务数据;
- 利用受支持的引擎重新导出原生包体,放弃对网页包进行“改装”的尝试;
- 在真机设备上回归测试登录、广告、支付、分享、存档读取及历史权益功能;
- 预留充足的迁移与审核时间,正式上线前务必进行小流量灰度验证。
适用范围界定
本次调整仅针对TikTok Minis 平台上的 HTML/H5 小游戏。普通 TikTok 视频业务、TikTok Shop、独立站 H5 页面以及短剧业务,均不在此迁移规则的适用范围内。
图 3:TikTok Minis 官方小游戏列表示意。来源:TikTok for Developers
资质与上架解决方案
除技术迁移外,部分团队在美国主体注册、行业资质获取及账号准备等环节面临困难。针对此类情况,目前可提供以下三种合作支持:
- 代上架服务:使用现有合规资质与账号,协助完成产品上架,省去主体注册环节;
- 主体注册协助:协助注册美国法人企业,由开发团队自行掌握账号运营节奏并上架美区;
- 成品账号对接:针对急需进度的项目,可对接已完成美国企业注册及行业资质流程的 TikTok Minis 成品开发者账号,覆盖小游戏及短剧方向。
涉及账号主体变更或项目承接时,须严格核对 TikTok 平台协议、权属关系及变更条件,最终结果以上架审核为准。任何服务均不承诺“包过”、保号或保证收益。
9 月 9 日是 H5 服务停止的终点,9 月 30 日是数据保留的边界。开发者应即刻推进备份、重建与权益对账工作,切勿等待进一步通知。
官方参考资料
TikTok:Migrate from HTML to Native Runtime
TikTok:Build Mini Games With Unity
TikTok:Acceptance Testing Guidelines

