欢迎开始使用 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，从空白模板、登录示例或 UGUI 适配模板中选择起点。

4. 构建输出

   使用团结引擎的微信小游戏转换工具（Build → WeChat MiniGame）完成构建；Build Optimizer 可用于首包分析与 Settings 检查。

5. 预览与调试

   使用微信开发者工具打开构建产物，扫码预览。需要性能监控时可集成 Performance Suite。

安装与激活

通过 Unity Package Manager 安装

// 在 Package Manager 中添加以下 Git URL:
https://github.com/HiyodoGame/TuanjieMiniGameToolchain-Free.git

手动导入

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

激活授权

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

提示： 如果你是团队用户，后续 Builder Pro 将提供团队授权管理功能，支持多设备统一激活与权限分配。当前版本以个人本地使用为主。

首个项目

选择一个模板

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

• 空白模板 — 最小化项目结构，适合自定义开发
• 登录示例模板 — 微信登录、用户信息获取与授权流程示例
• UGUI 适配模板 — 针对微信小游戏的屏幕比例与安全区适配示例
• 商业模块 — 排行榜、广告、IAP、热更新等模块持续完善中

项目结构概览

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

下一步

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

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