LayaAir已支持OPPO小游戏适配与IDE内一键发布！

LayaAir 2.1.0版本中，已完成对OPPO小游戏的适配与发布功能。今天，我们开启了该功能的开关。已下载使用LayaAirIDE2.1.0版本的开发者，重启IDE进入即可看到功能。老版本IDE的开发者升级2.1.0beta版本即可使用OPPO小游戏的功能。

OPPO小游戏背景

OPPO是快应用联盟中的重要成员。据了解，快应用过去一年覆盖10亿设备、月活2亿、打开快应用20亿次、留存1亿个桌面图标。其中有35%的流量来自桌面留存的图标。

基于快应用联盟强大的设备基础，快游戏具有先天的设备覆盖及获客优势，一旦接入快游戏平台，它可以在联盟厂商手机品牌中得到推广。OPPO小游戏引入Layabox等引擎方对其适配，并在引擎IDE中一键发布，这对于广大的游戏厂商而言，无疑带来了更快的游戏发布效率，并且可以将开发者的接入成本最小化。

如今OPPO小游戏开放了各个重要的流量入口，例如：OPPO浏览器、软件商店、游戏中心、桌面搜索、负一屏锁屏、语音助手、OPPO+、阅读等。巨大流量入口让小游戏研发厂商又再增一个新的重量级发布渠道。

OPPO小游戏发布与调试环境准备

1、OPPO品牌的手机。

2、下载安装OPPO真机测试APP "快应用"。

OPPO 小游戏调试器地址：http://cdofs.oppomobile.com/cdo-activity/static/quickgame/tools/f04dec4cd2d9c8613483672ef4d8d045.zip

或者前往OPPO官网文档：https://cdofs.oppomobile.com/cdo-activity/static/201810/26/quickgame/documentation/games/use.html

3、PC电脑的chrome浏览器与手机数据连接线。

4、安装nodejs 环境，建议安装 8.x 稳定版本 [node官网：https://nodejs.org/en/]

就是下载安装，比较简单，也不细介绍。能在命令行里调起npm命令就算是成功了。

5、LayaAirIDE集中开发环境，LayaAir 2.1.0 beta 或以上版本 [ 官网下载: https://ldc2.layabox.com/layadownload/?type=layaairide ]

6、安装ADB Shell

OPPO发布需要通过ADB Shell把rpk包推到games目录上去，所以这个必须要装。

[ ADB官网下载:  http://adbshell.com/downloads ]

提示一下，下载 ADB Kits，下载后的压缩包，建议解压放到一个路径简单一些的目录（如: D:\adb）。要记得添加环境变量（不知如何添加环境变量的可自行百度）。

OPPO小游戏发布前准备工作检查

1、发布前的准备工作检查。

为了让发布OPPO顺利一些，有一些检查工作我们要做。

第一、PC里，node环境、ADB Shell、Chrome这些，都必须要安装好。

第二、在OPPO的手机里，进入设置-> 其它设置-> 开发者选项 ，开发者选项与USB调试必须开启，如图1所示。

(图1)

另外要确保安装好OPPO小游戏调试环境“快应用”，如图2所示。

(图2)

第三、将PC电脑与手机用USB数据线相连，电脑里，可以出现类似图3一样的界面。比如，点击图3左上角的OPPO R9m，就可以进入手机存储。

(图3)

手机里要注意的是，屏幕保持点亮打开，在PC的IDE发布OPPO小游戏时，如果手机出现授权信息请求的时候，一定要点确定允许。如图4所示。

（图4）

发布OPPO小游戏包(xx.rpk)

打开发布功能，在发布平台选择好OPPO小游戏之后，如图5所示，我们就可以在当前的界面里配置发布的相关参数，然后完成一键发布。

（图5）

常规的发布就不介绍了。关于OPPO小游戏专属的发布配置如图6所示。我们将逐一进行介绍。

（图6）

1、游戏名称

一般都填写中文汉字，英文也可以。用于应用商店、桌面图标、弹窗等游戏入口处。一个好的名字是游戏能不能吸量的重要元素。OPPO是10个汉字以内就可以。我们的建议是都不要超过6个汉字，游戏名太长没什么好处。

2、游戏包名

游戏包名的格式是com.company.module第一位com不要变，第二位是公司名，第三位是项目名。都要写英文，例如：com.layabox.demoGame。

3、游戏图标

游戏图标也是重要的游戏入口标识，和游戏名称一样，是非常重要的吸量元素，如果游戏图标设计的好，游戏名称起的好。同样的位置会获得比其它游戏更多的点击率。游戏图标需要提供192 * 192的正方形尺寸。

4、游戏版本名称

游戏版本名称是真实的版本，一般是用于功能性版本的区别。比如我有个大版本改动。原来是1.0，可以变成2.0，如果只是改改Bug，那1.0完全可以改成1.1。以此类推，我们建议采用浮点数命名。比如“0.1”、“1.3”、“5.0”……

5、游戏版本

游戏版本与版本名称用处不同，这里是渠道平台用于区别版本更新。每次提审都要至少递归+1，自己测试无所谓。但是提审这里的值必须要比上次提审的值至少要+1，+N也是可以的，绝对不能等于或者小于上个版本值，建议是提审版本号递归+1。这里需要注意的是，游戏版本必须为正整数。

6、最小平台号

最小平台号，目前只能设置为1040，未来有变更或者有了其它更新方式，请及时关注本文档。

7、屏幕方向

这里和微信小游戏的横竖屏设置一样，大家要注意和游戏实际以及引擎的横竖屏设置保持统一。

8、打包完成后启动手机调试

这个选项是用于启动真机调试用的。

OPPO需要真机调试的时候，发布时必须勾选，并且要保障PC环境中已安装了ADB Shell [ ADB官网下载:  http://adbshell.com/downloads ]，同时还要确保手机与PC是联通的，并且打开了USB调试权限。

9、是否使用正式版签名

如果只是测试版本调试，这里可以不用勾选。正式上线发布前（提版本到平台）必须勾选。

如果勾选了，就会启用正式版签名。关于release签名:

①对于公司,一般一个公司只用一个签名，如果公司已经有签名了，推荐使用公司的签名。如果没有的话，IDE中的发布集成了这个功能，方便开发者生成签名。

②对于个人开发者，可以多个项目使用一个正式签名。只需要生成一次即可。

如果已经有release签名了，将签名文件放到项目根目录sign / release 文件夹下，如图7所示。

(图7）

放到根目录下，是为了下次发版本的时候，复制到release的目录下。如果直接到releas目录内的sign目录内，下次发布会把之前的内容全部清除掉。如果没有sign/release，那就自己建一个！

10、生成release签名

这个功能是为了生成正式版签名，不勾选上一个功能或者已经有release签名的时候，不用配置这里。勾选后，配置参数如下(注意生成release签名需要OpenSSL环境)：

(图8)

签名内容建议写英文，帮大家翻译一下及示例如下：

//国家简称，例如中国CN
Country Name (2 letter code) [AU]:
CN 

//省或直辖市名字，例如北京市BeiJing
State or Province Name (full name) [Some-State]:
BeiJing 

//区或市县的名称，例如海淀区HaiDian
Locality Name (eg, city) []:
HaiDian 

//公司或组织名,例如Layabox
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Layabox 

//单位或者是部门名称，例如游戏部门Game
Organizational Unit Name (eg, p) []:
Game 

//Email地址,例如：游戏对接合作 bd@layabox.com
Email Address []:
bd@layabox.com 

填写完以上的配置信息，点击发布，即可完成发布。需要提醒的是，首次发布需要下载rpk环境，要稍等一会。别着急。

真机调试与Chrome输出

OPPO的调试必须基于真机调试，PC的chrome只能输出信息，看不到画面。

如果准备工作没问题的话，正常情况下，LayaAirIDE里成功发布OPPO小游戏之后，是rpk的包会自动出现在快游戏的OPPO小游戏列表中的（IDE通过调用ADB Shell推到指定的目录中），如图9所示。

（图9）

图5中的OPPO测试就是我们在发布的时候填写的游戏名称。如果我们看到自己对应的游戏名称，说明是正常发布成功了。点击秒开，就可以打开我们发布的游戏。

如果想看调试信息。这时就需要打开chrome浏览器。然后在输入栏里输入：

chrome-devtools://devtools/bundled/inspector.html?v8only=true&ws=10.10.82.111:12345/00010002-0003-4004-8005-000600070008

上面示例的IP地址10.10.82.111替换成自己手机上的IP就行。IP地址不知道怎么查的，自行百度。这里重点提示的是，PC电脑必须要和手机处于同一个网段的局域网环境下。

如果没问题，PC中chrome的调试效果如图10所示。

（图10）

发布后调试列表中未见游戏的处理经验

在正常情况下，通过LayaAirIDE是一键发布到手机里的，如果发布的时候没能将rpk自动发到快游戏目录内，那就没办法直接看到刚发布的小游戏（看上面的图9)。这时需要检查adb shell是不是安装好了，上面图1的授权是不是开启了，大多数是adb shell的问题或者与授权有关。

我们可以在PC的命令行下，输入adb shell查看，如图11所示。则是未获得USB调试模式授权。

（图11）

这时，我们要检查相关的设置。设置好之后，再次输入adb shell，应该如图12所示。这时候说明adb shell与授权没问题了。

（图12）

这些搞定后，我们再重新发布，应该就没问题了。

如果还有问题，一方面把问题反馈给Layabox官方团队，Layabox会与OPPO团队共同处理。另一方面，我们可以采用手工模式，把rpk包，复制到手机存储的games目录下，如果没有games目录则自己手工创建一下。

rpk包位于项目的release/oppogame/quickgame/dist 目录下，如图13所示。

（图13）

将发布生成的rpk文件，复制到手机存储的games目录下，如图14所示。

（图14）

这种方式，肯定能被OPPO小游戏的调试环境识别的。至此，我们应该可以顺利的发布和调试OPPO小游戏了。未来，LayaAir引擎还会适配和支持更多游戏平台的发布。请开发者关注Layabox公众号获得一手消息。

推荐阅读：

LayaAir引擎放弃Canvas API，打造次世代3D引擎与云游戏引擎，提供AI赋能！

MOBA、SLG、ARPG类型3D HTML5游戏案例精品推荐

LayaAir 2.0 正式版发布了，重要特性全面介绍