Unity 发布微信小游戏教程

适用版本：Unity 2022.3 LTS / 团结引擎 1.5.0 及以上。
示例使用 微信小游戏 Exporter 2.0 与 微信开发者工具 1.06+。如使用更高版本，请查阅官方文档更新。

前言

微信日活超 10 亿，小游戏生态完善，广告与内购成熟。Unity 官方提供 WeChat MiniGame Exporter，可把 WebGL 项目快速转换为微信小游戏包体。流程为：配置环境 → SDK 导入 → Build WebGL → 转换小游戏 → 开发者工具调试 → 上传审核 → 发布。

环境准备

工具	版本	用途
Unity / 团结引擎	2022.3 LTS+	项目开发
WeChat MiniGame Exporter	2.0+	构建转换
微信开发者工具	≥ 1.06	预览 & 上传
Node.js (可选)	≥ 16	定制脚本
微信开放平台账号	个人/企业	AppID & 审核

安装 Unity 时勾选 WebGL Build Support 模块。

注册与获取 AppID

访问微信公众平台 · 小游戏
选择注册 → 小游戏 → 填写主体信息
进入后台 设置 → 开发设置，复制 AppID
完成 小程序信息 与类目填写，准备提审

集成微信小游戏 SDK

1. 安装 Exporter

在 GitHub Release 下载 com.tencent.wechat.minigame.tgz
Package Manager → Add package from tarball… 导入

2. 初始化脚本 (可选)

using WeChatWASM;          // Exporter 自动生成
using UnityEngine;

public class WXEntry : MonoBehaviour
{
    void Start()
    {
        WX.InitSDK();      // 初始化 WASM SDK
    }
}

注意：在 Player Settings → Scripting Define Symbols 中添加 UNITY_WX，便于条件编译。

Unity 构建设置

Build Settings
- Platform: WebGL
- Switch Platform

Player Settings → WebGL

选项	建议值
Compression Format	Brotli
Data Caching	Enabled
Memory Size	64–128 MB

WeChat Build Panel
- Project Name: 与后台一致
- AppID: 后台获取
- Orientation: Portrait / Landscape
- 勾选 Enable WASM 及 Remote Server（调试 H5 资源）
一键构建
点击 Build → Build WeChat Game，输出到 Build/wxgame/。

CLI 示例：

/Applications/Unity/Hub/Editor/2022.3.15f1/Unity \
  -batchmode -quit \
  -projectPath $(pwd) \
  -executeMethod WeChat.BuildWeChat \
  -logFile build_wx.log

微信开发者工具调试

打开开发者工具 → 选择 小游戏
导入 Build/wxgame/ 目录
工具自动识别 game.json
点击预览，手机扫码调试
调试面板：
- Console：JS/WASM 日志
- 性能：FPS & 内存
- 网络：资源请求

上传审核与发布

步骤	描述
上传	开发者工具 → 上传 → 填写版本号 & 描述
提审	在后台提交审核，约 1–3 个工作日
发布	审核通过后点击提交发布
灰度	可设置 5%~100% 灰度比例

微信要求包体 ≤ 20 MB；资源超出需使用 分包加载、远程资源 或 AssetBundle CDN。

常见问题与优化

问题	解决方案
首次加载白屏	启用分包 + Loading 场景
内存不足 (OOM)	降低纹理分辨率，开启增量 GC
触摸延迟	升级 `Input System`，开启 `Enhanced Touch`
FPS 不稳定	降低物理步长，合并 Draw Call，关闭阴影

性能调优小贴士

使用 URP Mobile 或 Built-in + Static Batching
开启 Multithread Rendering (实验性)
UI 大图合并 SpriteAtlas，减少材质切换
利用 WX.onMemoryWarning 监控高内存

结语

通过本文流程，你已学会将 Unity 项目快速发布至微信小游戏平台。接下来可集成 微信广告变现、云托管后端 与 开放数据域，进一步提升用户体验与收益。祝你的小游戏大卖！

附件 · 脚本 & 配置

ci/build_wx.sh — CLI 构建脚本
Assets/Scripts/WXEntry.cs — SDK 初始化
wx-settings.json — Exporter 配置模板

需完整示例工程？留言即可获取 GitHub 地址。

Last modified on 2025-06-09

目录

前言