Version: 1.6
语言 : 中文
微信小游戏转换SDK
微信资源缓存

部署微信小游戏

在完成小游戏配置与打包后(详见快速上手),您需要根据目标平台完成相应的上传与部署流程。本章节将针对 微信小游戏 平台,详细介绍如何将团结小游戏上传至微信开发者工具并测试的完整步骤。

1. 安装微信开发者工具

2. 在微信开发者工具中打开工程

  • 打开微信开发者工具,选 Mini Game(小游戏) 工程类型,点 import(导入) 按钮,选择先前中生成的 wechat/minigame 文件夹。

3. 在微信开发者工具中测试

微信开发者工具打开小游戏工程后,游戏将自动开始运行。

打开 Simulator(模拟器)Debugger(调试器),以查看游戏画面和调试信息。点击右侧 Compile(编译) 按钮,可以重新启动小游戏。

  1. 微信开发者工具中运行时,如果出现 “插件未授权使用 添加插件” 的错误提示,请点击“添加插件”按钮, 并且确认是否使用了测试游戏AppID。

  2. CDN 如果未开启 gz/br 压缩,在微信开发者工具的 log 中将有如下提示:

    UOS CDN gzip/br 压缩可通过 accept-encoding 控制,微信小游戏已自动添加 “gzip,deflate,br” ,因此无需额外操作。

  3. 如果配置了 TextureManager 并出现如下错误:

    请核对 game.js 中的 DATA_CDN 是否正确

  4. 如果出现以下问题,可能原因如下:
    • url 不对,需要仔细核对;
    • 没有创建新的发布版本;
    • 资源上传到 UOS CDN 会有一定的延迟,需要等待一段时间重试。

4. 在手机上测试

开发版本: 微信开发者工具上点击 Preview(预览) 生成二维码,扫码后可在手机(同一微信账号)上测试;若他人参与测试,需要申请正式的小游戏AppID,并在微信后台添加测试人员的微信账号。

体验版本: 使用正式的小游戏AppID打包的小游戏,可点击右侧 Upload(上传) 按钮,填写版本号和版本描述,上传体验版本。然后在 微信小游戏后台管理/版本管理/开发版本 中找到上传的版本,将其设置为体验版。该版本后续可用于提审发布。

如果遇到资源下载失败,404的错误。请点开手机右上角三个小点,找到并打开 开发调试->打开调试。或按照步骤20,在微信小游戏后台添加白名单。

5. 添加域名白名单

扫码登录微信小程序网页后,前往 开发管理-> 开发设置 -> 服务器域名 , 在 request合法域名downloadFile合法域名 中填写使用的域名。 如果游戏中使用到了其他类型的网络链接,如 websocket ,需要在 socket合法域名 内填写。

AutoStreaming 使用到的域名: 请填写以下域名:

https://a.unity.cn;
https://a.unity3dcloud.cn;
https://asset-streaming-content.unity.cn;

开启 http/2 或 http/3 后需添加以下域名: https://a2.unity3dcloud.cn; https://a3.unity3dcloud.cn;

 

如果项目工程中引用了 Analytics Package,小游戏运行时可能出现 cdp.cloud.unity.com, cdp.cloud.unity.cncdp.tuanjie.cn 等域名的请求。 请前往 Windows -> General -> Services 关闭, 并且在 Package Manager 中移除 Analytics 。

微信小游戏转换SDK
微信资源缓存