# 环境准备

在开始转换前，请先准备好 Unity / 团结引擎、转换插件与命令行工具。完成本章后即可进入转换工具导出。

# 一、引擎与系统环境

引擎：Unity 2018~2022 或团结引擎，推荐 Unity 2022.3 或团结引擎，版本选择参考方案概述 · 引擎版本。
操作系统：与所选引擎一致即可（Windows / macOS）。
Node.js：用于运行命令行工具，版本不低于 v14.13.0。

# 二、获取转换插件

Unity 转换插件需使用美团小游戏提供的版本，请联系对接人员 / 运营同学获取，并按其说明导入到 Unity 工程中。

请始终使用最新版本的转换插件进行转换，旧版本可能缺少能力适配或修复。

导入成功后，Unity 编辑器顶部菜单栏会出现 「美团小游戏」 菜单，后续转换从此进入。

# 三、安装命令行工具（mgc-cli-external）

美团小游戏 CLI 工具（mgc-cli-external）用于真机调试与发布。确保本地已安装 Node.js 后，执行：

$ npm i -g mgc-cli-external@latest

Unity 小游戏的 WASM 代码分包同样依赖该工具，建议安装 0.0.72 及以上版本。

# 四、创建配置文件

在游戏项目的父目录或其他目录（注意不要在待打包游戏目录或其子目录）执行：

$ mgc config

成功后会在当前目录生成 mgc.config.js。Unity 游戏需将 type 指定为 UnityGame：

module.exports = {
  "type": "UnityGame",                          // 包类型：Unity 游戏需指定为 UnityGame
  "appId": "4503b3691d974573a747ed85f74f1a29",  // 游戏的 appId
  "appSecret": "752d7e4a3b8b4525",              // 游戏的 appSecret
  "entry": "./build/minigame"                   // 待打包的小游戏本地路径（转换导出的 minigame 目录）
}

appId / appSecret 在美团游戏开放平台 (opens new window)的「开发管理 — 开发设置」中获取，注册入驻流程参考接入指南。

# 五、下一步

环境就绪后，前往转换工具导出完成第一次转换。