一、基本流程

近日小游戏上oppo,在此对于cocoscreator发布oppo小游戏流程作一个记录分享，用的creator版本是2.4.3。
基本流程：
1、creator构建发布打包rpk包。
creator发布oppo流程:https://docs.cocos.com/creator/manual/zh/publish/publish-oppo-instant-games.html.
2、oppo真机或远程真机调试。
OPPO 小游戏开发者文档:https://cdofs.oppomobile.com/cdo-activity/static/201810/26/quickgame/documentation/#/games/quickgame.

1.creator构建发布

最终目的还是为了出个rpk包，为了能在cocos构建发布的时候直接打包rpk包，在此之前还需要进行一些环境配置：
安装node环境 ，建议安装 8.x 稳定版本；
1.先在cmd到命令提示符窗口输入：node -v 查看node.js版本，如果没有安装==>node 旧版本地址：https://nodejs.org/zh-cn/download/releases/.
当然有可能安装失败，遇到2503、2502问题时：==> win10下安装node等msi安装包错误提示2503、2502解决方法.
解压 quickgame-toolkit，切换到解压目录下，并且安装依赖；

    # 进入解压目录
    cd quickgame-toolkit
    # 安装项目的依赖
    npm install

将 quickgame-toolkit 下的"/lib/bin"目录加入系统变量中（例如：/path/quickgame-toolkit/lib/bin，其中"/path/quickgame-toolkit"是解压安装的目录）

   # Mac 环境变量配置
   ①.在用户根目录打开终端
   ②.如果本地 terminal 用的是 zsh，直接在用户根目录下 vi .zshrc 进行编辑，如果你没有使用 zsh，请网上查找相关资料如何配置 Mac 环境变量（以下操作都是一样的，注意分号分割）
   ③.export QG_PATH=/Users/{你的实际路径}/quickgame-toolkit/lib/bin;export PATH=$PATH:$QG_PATH

   # Windows 环境变量配置
   ①.在桌面上右键单击计算机图标，从上下文菜单中选择属性，单击高级系统设置链接
   ②.单击环境变量。在系统变量部分中，找到并选择 PATH 环境变量。单击编辑。如果 PATH 环境变量不存在，请单击新建
   ③.在编辑系统变量（或新建系统变量）窗口中，指定 PATH 环境变量的值。单击确定。通过单击确定关闭所有剩余窗口

运行 quickgame -V 能够正确显示版本号表示安装成功。
注：若提示 quickgame 不是内部或外部命令，可重新打开命令提示符窗口或者重启计算机后再运行 quickgame -V。

3.增加release签名

发布前，需要使用正式的签名和文件来签名。
1.通过构建发布面板 certificate.pem 路径后的新建按钮生成即可。
2.在工程的 quickgame 的 sign 目录下创建 release 目录，将私钥文件 private.pem 和证书文件 certificate.pem 拷贝进去。

构建发布面板的相关参数设置完成后，点击构建。构建完成后点击发布路径后面的打开按钮来打开构建发布包，可以看到在默认发布路径 build 目录下生成了 quickgame 目录，该目录就是导出的 OPPO 小游戏工程目录和 rpk，rpk 包在 build/quickgame/dist 目录下。

2.oppo真机调试

1.安装 runtime.apk 包到 OPPO 手机上，安装完后桌面会有快应用图标。
2.OPPO 小游戏调试器为 V3.2.0 及以上的需要将准备好的 rpk 拷贝到手机 sdcard 的Android/data/com.nearme.instant.platform/files/games中, 无 games 目录则需新建。
3.点击快应用图标，进入后点击对应的 OPPO 小游戏 tab 下的游戏即可看到效果，如果没有出现刷新一下。

注意：相同游戏 rpk 更新时，需要去“快应用 -> 后右上角的三个点->清除数据”进行清除数据操作

3.Chrome 真机调试

使用手机数据连接线把 OPPO 手机与电脑相连。把打包后生成的 rpk 包放置到手机根目录 /games 下，必须放到根目录下的 games 文件夹下，如果没有该文件夹，需要开发者手动创建。放好后，打开调试包，即可看到 rpk 对应的小游戏。点击将小游戏运行起来。在电脑 PC 的 Chrome 浏览器器下，输入以下地址，就可以在电脑端打开调试了。(注意调试手机需要与电脑在同一网段) 使用 Chrome 浏览器打开地址:chrome-devtools://devtools/bundled/inspector.html?v8only=true&ws={IP}:{PORT}/00010002-0003-4004-8005-000600070008，其中 {IP} 为手机本地 IP，{PORT} 为端口号，端口号有 12345 和 12346，如果 12345 连接不上，请使用 12346。

{IP} 可在设置–WLAN–点击具体 Wi-Fi 连接查看。

二、oppo SDK接入

先来个示例，里面有示例源码。oppo小游戏示例说明文档：https://cdofs.oppomobile.com/cdo-activity/static/201810/26/quickgame/documentation/#/games/little-game-demo

sdk对接在下一篇文章~~~~~~

还是再记录下，基本上小游戏对接的接口有：

获取系统信息：qg.getSystemInfoSync()；
数据上报：qg.reportMonitor(name, value)；
桌面图标：qg.installShortcut(object)；测试时貌似并没有弹窗询问是否创建，而是直接创建桌面图标；
小游戏跳转：qg.navigateToMiniGame(object)；
消息提示框：qg.showToast(object)；
排行榜
振动
激励视频广告
Banner广告
原生广告：原生广告是获取广告数据，根据实际场景自由选择绘制和展示方式的广告，更加灵活。需要注意的是，每个原生广告组件对象只有一次有效曝光，一次有效点击。同一个 adUnitId，如果已经创建，并且未 destroy，会复用之前的对象。
下载：qg.downloadFile(object)；可以下载远程文件资源到本地，客户端直接发起一个 HTTP GET 请求，返回文件的本地文件路径。比如：从服务器下载小游戏跳转图片或json配置文件到本地，然后再通过cocos的资源管理模块加载到项目中，cocos资源管理模块cc.assetManager.loadRemote访问远程链接再浏览器中会出现跨域问题，但是可以把本地文件加载进项目中。跨域问题，json文件解析等将会记录在其它文章中。

游戏资源管理问题：AssetBundle配置和加载：https://docs.cocos.com/creator/manual/zh/scripting/asset-bundle.html

原文链接：https://blog.csdn.net/qq_42952831/article/details/109784564