欢迎开始使用 MiniGameToolchain

这套文档将帮助你从零开始，在 5 分钟内完成 MiniGameToolchain 的安装、配置，并构建出第一个可运行的微信小游戏项目。

5 分钟上手

如果你是第一次使用 MiniGameToolchain，推荐按照以下顺序阅读，快速建立对整个工具链的认知：

1. 安装 Starter Kit

   从 Starter Kit 页面 下载免费版 Unity 插件，通过 Package Manager 或手动导入到你的 Unity 项目中。

2. 配置微信小游戏环境

   确保你的 Unity 项目已切换为 WebGL 平台，并安装团结引擎（Unity China）的微信小游戏插件。Starter Kit 会自动检测环境依赖。

3. 使用项目模板

   在菜单栏选择 MiniGameToolchain → New Project from Template，从内置的排行榜、广告、IAP 模板中选择一个作为起点。

4. 一键构建

   点击 Build → WeChat MiniGame，Starter Kit 会自动完成首包分析、分包配置、资源压缩和构建输出。

5. 预览与调试

   使用微信开发者工具打开构建产物，扫码预览。Starter Kit 的实时日志面板会同步显示运行时的性能数据。

安装与激活

通过 Unity Package Manager 安装

// 在 Package Manager 中添加以下 Git URL:
https://github.com/minigame-builder/starter-kit.git

手动导入

下载 .unitypackage 文件后，双击或在 Unity 菜单中选择 Assets → Import Package → Custom Package 完成导入。

激活授权

打开 MiniGameToolchain → License 面板，输入你的授权码或登录 MiniGameToolchain 账号。免费版无需激活即可使用核心模板功能。

提示： 如果你是团队用户，推荐使用 Toolchain Pro 的浮动授权管理，支持多设备统一激活和团队权限分配。

首个项目

选择一个模板

Starter Kit 内置了多个经过微信小游戏审核验证的项目模板：

• 空白模板 — 最小化项目结构，适合自定义开发
• 排行榜模板 — 包含好友排行榜、世界排行榜、UI 框架
• 广告接入模板 — Banner、激励视频、插屏广告集成示例
• IAP 内购模板 — 商品配置、支付流程、订单校验完整示例

项目结构概览

MyMiniGame/
├── Assets/
│   ├── MiniGameBuilder/          # 核心插件目录
│   │   ├── Templates/            # 项目模板
│   │   ├── Editor/               # 编辑器工具
│   │   └── Runtime/              # 运行时脚本
│   ├── Scripts/                  # 游戏逻辑
│   ├── Resources/                # 首包资源
│   └── StreamingAssets/          # 分包资源
├── ProjectSettings/              # 微信小游戏构建设置
└── Build/                        # 构建输出目录

下一步

完成首个项目构建后，你可以根据需求深入以下方向：

• 使用 Build Optimizer 进行首包压缩和构建自动化
• 使用 Performance Suite 进行内存分析和运行时性能优化
• 阅读 最佳实践 章节，了解微信小游戏审核和性能优化的行业经验