主题
Skip to content 
打包前须知
1. oppo官方推荐引擎版本
2. 目前unity小游戏转化不支持分包
3. 请务必要使用 OPPO 手机进行测试！！！
4. OPPO渠道api版本适配
- 小游戏发布时请填写平台推荐的最低版本号 1060，调用高版本才支持的 API 需结合使用获取系统信息的 API 判断平台版本号大于对应版本后再使用
5. 开发环境安装
安装了 node 环境，建议安装 14.x.x 稳定版本(10.x.x 以上版本可能出现不兼容问题)（打包文档会提供安装文件）
6. 游戏审核提示
若用户数据只存储在本地未进行云备份，需在小游戏主界面提醒用户, 示例如下：
打包详细流程
1. 安装node 环境
建议安装14.x.x版本（其他版本可能存在打包问题，测试demo打包使用版本node-v14.21.3-x64）node下载地址；安装成功后，配置node.exe所在目录到系统环境环变量；控制台输入 node -v ，输出node版本号，确认 node安装成功；
2. 安装OPPO打包工具
命令行执行 npm install -g @oppo-minigame/ cli ；等待安装完成，运行 quickgame -V 能够正确显示版本号表示安装成功；若提示 quickgame 不是内部或外部命令，可重新打开命令提示符窗口或者重启计算机后再运行 quickgame -V；
3. 安装开发者工具
本地开发者工具，下载地址 ，选择最新版本即可。
4. 安装调试器到Oppo手机
oppo小游戏必须oppo真机运行，需要在oppo手机安装调试器，下载地址 ，选择国内最新版本即可；在电脑上下载后，链接debug模式已开启的OPPO手机设备，使用安装命令 adb install -f -t 路径/runtime_v版本号.apk（注意替换路径和版本号，若提示找不到adb命令安装 ADB）；可以copy到指定目录，在手机上点击安装；安装成功后，手机桌面会出现如下快应用图标；后续打包产物rpk使用该软件打开运行（具体操作见后续步骤）。
Untiy相关环境及配置
1. Unity版本：Oppo官方推荐Unity版本
2. 使用最新的框架版本
1.2.0框架整合了app和xyx；一律使用app即可；
3. 选择运行平台为WebGL，切换默认纹理格式为ASTC
下载并导入
更新ZMYSDK包管理器到最新
切换oppo小游戏，并导入小游戏插件
导入配置
WARNING
💡 需要切 WebGL 平台
导入游戏配置
Debug 模式的开启或关闭
发最后一个正式包时，一定要取消 DebugMode
3. 开始打包
资源上传
如果没有CDN，可以找我方申请CDN后，将游戏资源放在CDN上
渠道配置
- 打开渠道打包界面
- 基本设置
游戏包名：游戏唯一标识，打包后的文件以此命名，一般格式为 com.company.product，默认写为 com.[PlayerSettings.companyName].[PlayerSettings.productName]
游戏名称：游戏对外展示名称
游戏方向：进入游戏时的设备方向，包含 Portrait（竖屏）、Landscape（横屏）、landscapeLeft (横左屏)、landscapeRight (横右屏)
游戏版本号：正整数，一般从 1 开始递增
游戏版本名称：与版本号对应，用于展示版本信息
最小平台版本号：一般填写 1103，平台版本支持的 API 可查询 OPPO小游戏官方文档
游戏图标：游戏在平台、桌面展示的图标，正方形，默认 108x108 尺寸
自定义秘钥库：不勾选仅供调试使用，无法正式发布；勾选后将对包体进行正式签名，可以通过 OPPO小游戏开发者工具 或者 OpenSSL 生成签名
证书文件路径：生成的 certificate.pem 文件绝对路径
私钥文件路径：生成的 private.pem 文件绝对路径
使用远程资源：是否将 StreamingAssets 中的资源放置到服务器，勾选后将不再把此目录中的资源进行打包，需要手动填写服务器地址，并将资源上传上去
服务器地址：例如 https://minio.wedobest.com.cn/app-3/Release/xyxdemo/XYX/oppo/base/1.11/StreamingAssets
导出路径：导出的 WebGL 和小游戏工程存储目录
- 缓存设置
资源缓存系统相关配置，建议前往了解 缓存系统 后再进行配置
启用缓存：是否启用缓存，建议开启
缓存路径标识：不填写代表所有路径都进行缓存判断。填写时多个时使用英文分号分隔，例如 StreamingAssets;bundles
不缓存的文件类型：不填写代表所有文件都进行缓存判断。填写多个时使用英文分号分隔，例如 .json;.hash
哈希长度：资源 hash 占多少长度，默认 32 位
额外清理大小：清理缓存时默认额外清理的大小，单位 MB，默认 30MB
保留旧版本：资源更新后是否保留旧版本资源，默认删除不保留
清理忽略文件：自动清理时忽略的文件，支持纯 hash 或名称，名称尽量不要使用特殊字符。不填写代表所有缓存都有可能被清理。填写多个时使用英文分号分隔，例如 8d265a9dfd6cb7669cdb8b726f0afb1e;asset1
开启日志：是否将缓存信息输出到控制台，便于调试
- 资源检查
Shader 检测器相关配置，建议前往了解 Shader 兼容性检测 后再进行配置
检查Shader兼容性：勾选后将在执行打包时，对 Shader 兼容性进行检查
启用Shader真机检测：勾选后将在执行打包时，额外构建 Shader 兼容性检查场景，在启动游戏后进入此场景进行真机检测（仅供自测，正式打包请勿使用）。
打包
点击 打包 即可一键将 WebGL 项目转化为 OPPO 小游戏。
构建成功后点击 确定 将自动打开 导出路径
quickgame：小游戏导出目录
webgl：Unity WebGL 构建目录
导出完成，前往 运行小游戏
4. 运行调试小游戏
工程结构
导出后quickgame的标准小游戏工程结构如下
Build：Unity WebGL 导出目录
dist：存放打包好的小游戏 rpk
sign：存放签名文件
StreamingAssets：对应 Unity 中的同名目录，若非必需，可删除此目录，减少包体大小
logo.png：游戏图标
main.js：游戏入口文件
manifest.json：通过 Unity SDK 或 命令行 导出小游戏时生成的游戏配置文件
ral.js、ral_2021.js、web-adapter.js：小游戏适配文件
原则上不建议对导出工程进行修改，若确实需要修改，则在修改后执行 quickgame pack 重新打包
真机调试
OPPO 小游戏支持多种方式进行调试，可根据自身需求进行选择
OPPO 小游戏开发者工具「强烈推荐」
通过统一的工具链对小游戏进行编译、打包、安装、真机调试等，建议使用最新版本，具体使用指南参考 官方文档
云真机调试「一般推荐」
具体使用指南参考 官方文档
本地真机调试「一般推荐」
本地调试需要自行搭建调试环境，具体步骤如下
安装调试器
在进行真机调试前需要安装小游戏调试器，推荐使用最新版本，点此 前往安装。安装成功后，手机桌面会出现如下快应用图标
安装小游戏
打好的小游戏 RPK 包存放在 dist 目录中，假设名为 com.oppo.littleGameDemo，可以通过以下 2 种方式安装
通过 ADB 安装 「推荐」：确保已安装 Android Debug Bridge 且手机已通过 USB 连接至电脑，在 dist 目录中打开控制台执行 adb push com.oppo.littleGameDemo /sdcard/games/com.oppo.littleGameDemo，命令执行结束后即安装成功
手动安装 「不推荐」： 确保手机以通过 USB 文件传输方式连接至电脑，通过文件浏览器打开 /sdcard/games 目录（若没有此目录需要先创建），将 com.oppo.littleGameDemo 拷贝至目录下即可完成安装
若安装成功，打开之前安装的调试器 App 即可看到小游戏，若安装前已打开调试器则下拉刷新列表
调试小游戏
调试工作将在 Chrome 浏览器环境下进行，具体使用指南参考 官方文档
业务层功能接入
参考左侧 接口说明相关部分
