白鹭引擎支持OPPO小游戏 开发者可一键接入

白鹭引擎已经完成了和OPPO小游戏的适配，从白鹭引擎5.2.19版本开始，开发者们可以依靠白鹭引擎来快速打包、发布符合标准的OPPO小游戏。5.2.19版本已于今日更新完毕，同时Egret Launcher1.0.64也已经更新完毕，欢迎各位开发者下载更新。新版本除了增加支持OPPO小游戏之外，还修正了微信小游戏的图片可能存在内存泄露的问题以及 URLLoader 在某些平台上无法加载资源的问题。

OPPO多维度助力小游戏开发者实现全面商业化

OPPO小游戏开放了全系统流量支持，用户将可以在OPPO浏览器、负一屏、桌面搜索、软件商店、游戏中心等系统流量入口体验小游戏，形成巨大流量入口。OPPO小游戏在技术标准上以提供HTML5标准为主，以此降低游戏开发者的开发及游戏迁移成本，后续将会提供分包能力，助力开发者制作更丰富的内容。为鼓励更多的优质开发者加入OPPO小游戏，平台还推出了非常优厚的分成政策。

OPPO通过大数据分析，挖掘用户的兴趣偏好并进行定制化推荐，多场景刺激用户点击小游戏，从而将巨大的商机也拉近到开发者面前，帮助所有的开发者实现小游戏的全面商业化。

以下为白鹭引擎对接OPPO小游戏的详细教程：

一、开发环境准备

1、Egret Launcher 1.0.63 以上版本；

2、白鹭引擎 5.2.19 以上版本；

3、在电脑中安装 npm：https://www.npmjs.com/；

4、在电脑中安装 adb 工具：http://adbshell.com/downloads；

5、在 OPPO 手机上安装快应用调试器，以及更多小游戏 API 文档，请访问小游戏支持网站：https://cdofs.oppomobile.com/cdo-activity/static/201810/26/quickgame/documentation/games/use.html。

二、创建小游戏和可视化编译打包小游戏

1、使用最新的 Egret Launcher 创建一个 Egret 游戏项目，引擎使用 5.2.19 以上版本。创建完成后，会在 Egret Launcher 的列表里看到该项目。点击发布设置：

2、选择 OPPO小游戏 标签，点击确定，创建项目：

3、创建成功后，点击发布标签，可以可视化的发布小游戏包：

4、编译游戏代码到小游戏：相当于执行命令 egret build --target oppogame，把游戏的代码编译到小游戏的项目里；

5、发布：相当于执行命令 quickgame pack，把小游戏工程，编译成 rpk 包；

6、调试：使用 USB 连接手机和电脑后，点击调试，会把rpk上传到手机中，然后启动一个 Chrome 窗口，可以调试手机中运行的小游戏；

7、分包加载机制，请访问小游戏支持网站：https://cdofs.oppomobile.com/cdo-activity/static/201810/26/quickgame/documentation/subpackage/subpackage.html。

三、使用命令行把白鹭游戏编译到小游戏项目

方法1：开发者可以使用命令行来编译和发布到OPPO小游戏项目中：

1、dubug 模式： egret build --target oppogame；

2、release 模式： egret publish --target oppogame。

方法2：配置 egretProperties.json

"engineVersion": "5.2.19","compilerVersion": "5.2.19","template": {},"target": {"current": "oppogame"},

如上所示，将 egretProperties.json 配置文件中的 current 属性设置为 oppogame 时，可以直接使用egret build 或者 egret publish 命令编译和发布OPPO小游戏。

四、使用命令行打包发布 OPPO 小游戏

1、进入小游戏项目，在命令行里执行编译命令 quickgame pack，成功后会生成一个dist文件夹，里面的 com.application.demo.rpk 文件就是打包好的小游戏项目，可以在手机上运行调试。

2、如果执行命令 quickgame pack release，则会生成正式发布的小游戏项目。注意，发布正式项目，需要在 sign/release/private.pem 路径下自己准备签名文件。

3、项目代码目录的结构如下：

4、目录结构说明

egret.oppogame.js： 白鹭引擎与小游戏的适配层；

js 文件夹：游戏项目的代码；

main.js：项目入口文件；

manifest.js：用来引用所有的 js 代码；

manifest.json：小游戏的相关参数设置；

resource 文件夹：游戏资源文件；

sign 文件夹：签名文件存放的位置。

5、manifest.json 配置说明

"package": "com.application.demo", "name": "oppogame", "versionName": "1.0.0", "versionCode": "1", "minPlatformVersion": "1040", "icon": "/icon/logo.png", "orientation": "portrait"}

6、参数说明

Package：应用包名；

Name：应用名称，6 个汉字以内，与应用商店保存的名称一致，用于在桌面图标、弹窗等处显示应用名称；

versionName：应用版本名称；

versionCode：应用版本号，从1自增，推荐每次重新上传包时versionCode+1；

MinPlatformVersion：支持的最小平台版本号；

icon：应用图标的路径；

orientation：支持的屏幕方向。portrait 为竖屏，landscape 为横屏。该参数会自动从白鹭游戏项目的 index.html 里获取。

五、真机调试调试

注意：一定要使用 OPPO 手机才可以调试

1.在 OPPO 手机上安装 OPPO 小游戏调试器；

2.使用 USB 线连接手机和电脑，把编译好的rpk包上传到手机；

3.打开小游戏调试器，点击 OPPO小游戏标签，在列表中选择刚才上传的 rpk 名称，游戏会运行起来。

白鹭引擎为所有开发者提供OPPO小游戏上架技术支持

作为内容合作方之一，白鹭科技也会持续的为OPPO小游戏平台提供和推荐精品小游戏。白鹭科技凭借十年自研经验、千万级用户规模运营和专业宣发能力，还将为OPPO小游戏引入大量优质作品，如果你有好作品，可与我们联系，将作品发送至：bd@egret.com.