You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何解决Facebook Instant Games上传.zip文件的SDK引用报错问题

Facebook Instant Games 上传报错解决方案

报错提示:Game must reference to one of our supported SDKs via CDN.

你可以按以下顺序逐一排查问题:

  • SDK 引用规则校验
    你添加的SDK脚本必须放在index.html的<head>标签最顶部、所有其他业务脚本之前,且不能添加async、defer属性,禁止本地缓存SDK文件到压缩包内,必须直接引用CDN地址,正确写法如下:
    <script src="https://connect.facebook.com/en_US/fbinstant.7.0.js"></script>
    
  • 压缩包根目录结构校验
    你打包的.zip文件解压后,index.html和fbapp-config.json必须直接放在根目录,不能嵌套在dist、build等子文件夹中,Facebook校验逻辑仅会扫描根目录下的入口文件。
  • 配置文件语法校验
    检查fbapp-config.json是否存在语法错误(比如多余逗号、拼写错误),你当前的配置字段本身符合要求,可额外确认orientation、platform_version等枚举值的大小写完全匹配官方要求。
  • CLI 上传参数校验
    若使用CLI上传,确认CLI版本为最新正式版,且上传指令指定的打包路径对应根目录,而非项目父级目录。
  • 本地预校验
    本地解压待上传的zip包,直接打开根目录的index.html,在浏览器控制台输入FBInstant,若返回undefined说明SDK未正确加载,先修复本地加载问题再尝试上传。

内容的提问来源于stack exchange,提问作者user17219380

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.29 10:09:01