Cocos & Laya 快游戏联盟包体导出说明

一、联盟包体简介

联盟包体是使用统一包名（使用.minigame作为联盟包名后缀，若之前已在联盟成员平台登记过包名，可继续沿用原有包名，manifest.json 的allianceVersion联盟版本号字段作为识别的标识，默认 1300）的快游戏包，当前 vivo / OPPO / 小米 / 荣耀 等平台均已支持该联盟包名后缀。已完成适配的厂商，可以直接在快游戏联盟平台上传。

目前支持导出联盟包的引擎包括：Cocos、Laya、Unity。

若有未支持该包名的厂商，可联系商务申请加入白名单。

二、Cocos & Laya 导出联盟包体方法

由于当前 Cocos & Laya 官方尚未提供联盟渠道导出选项，开发者可先使用 vivo 渠道导出快游戏包体，并通过填⼊相应取值的配置项打出联盟快游戏包体。

2.1 前提条件

请确保已安装以下脚手架工具：


npm install -g @quick-game/cli          # 安装联盟脚手架
qg -v                                    # 查看联盟 CLI 版本

npm install -g @vivo-minigame/cli       # 安装 vivo 快游戏脚手架
mg -v                                    # 查看 vivo CLI 版本

2.2 导出流程

引擎中选择导出 vivo 快游戏渠道（Laya 与 Cocos 类似）
安装并使用最新 vivo 脚手架（@vivo-minigame/cli）
设置导出的 minPlatformVersion 至 13000 及以上（此字段填写 13000 及以上，⽅可使⽤ cocos 及 laya 的引擎 ide 直接打出联盟快游戏 rpk 包）
- 可通过引擎面板设置
- 或导出后手动修改 manifest.json
```
{
  "minPlatformVersion": 1300
}
```
点击构建按钮，可直接生成联盟包体
若想要其他方式生成联盟包体
命令行生成联盟包体

## 联盟脚手架打包
qg build      # 构建 Debug 包体
qg release    # 构建 Release 包体

## vivo脚手架打包,minPlatformVersion配置13000 及以上可直接打包出联盟包体
mg build      # 构建 Debug 包体
mg release    # 构建 Release 包体
## 或者命令行带参数打包控制是否生成联盟包体--alliance
mg build --alliance=true

使⽤联盟 IDE 打开构建出的快游戏⼯程，也可直接导出 .minigame 联盟包体

2.3 验证是否为联盟包体

若构建后存在 build 目录，可通过以下方法判断是否为联盟包体：

✔️ 存在 vivo_alliance_adapter.js 文件
✔️ main.js 文件开头包含 require('vivo_alliance_adapter.js');
✔️ manifest.json 中包含 allianceVersion 字段

若无 build 目录，可手动解压 .rpk 包体验证：

进入 dist 目录
使用 zip 工具解压 .rpk
解压内容与 build 目录验证方式一致

三、接入平台接口功能（账号 / 支付 / 广告）

导出的联盟包体可直接使用联盟平台提供的统一标准的 API 接口。

无需区分平台（vivo / OPPO / 小米 / 荣耀）
推荐使用 统一 SDK 快速接入账号、支付、广告能力
可参考相关文档：
- SDK 平台能力适配说明

四、常见问题

Q: vivo 包体和联盟包体的区别？

A: vivo 包体经过配置后（如 minPlatformVersion >=13000），vivo 脚手架可以直接打包出联盟包体，即可作为联盟包体上传。

Q: 为什么使用 vivo 渠道导出？

A: 当前 Cocos / Laya 引擎暂未提供专属的“联盟”导出渠道，vivo 渠道已完成联盟适配，因此作为过渡方案。