今日,白鹭引擎已完成与vivo小游戏平台的适配,也意味着自白鹭引擎5.2.22版本开始,开发者可在白鹭引擎上快速打包、发布符合标准的“vivo小游戏”。
白鹭引擎全面适配 “vivo小游戏平台”
在此次白鹭与vivo小游戏平台合作中,为了帮助开发者更快速、便捷的对接vivo小游戏平台,白鹭为其提供了2项核心服务:
1、引擎接口与vivo小游戏平台的API接口适配;
2、在 Egret Launcer 里集成vivo小游戏的可视化编译环境。
这2项服务内容包含了开发者所需要的vivo小游戏的标准接口,还包含了白鹭独家专利技术以优化游戏性能和兼容性。
现在,白鹭引擎已经完成了与vivo小游戏的适配白鹭游戏引擎怎么样,为所有白鹭引擎的开发者提供了抢先进驻平台的机会,随时享受硬件手机流量带来的红利。
以下为白鹭引擎对接vivo小游戏的详细教程:
一、开发环境准备
1、Egret Launcher 1.0.65 以上版本;
2、白鹭引擎 5.2.22 以上版本;
3、在电脑中安装 npm:;
4、在电脑中安装 adb 工具:;
5、最新版本的 vivo 小游戏引擎(平台版本1041+):#/download/engine;
6、更多 vivo 小游戏 API 文档,请访问小游戏支持网站:#/lesson/base/start。
二、创建小游戏和可视化编译打包小游戏
使用最新的 Egret Launcher 创建一个 Egret 游戏项目,引擎使用 5.2.22 以上版本。创建完成后,会在 Egret Launcher 的列表里看到该项目。点击发布设置:
选择 vivo小游戏 标签,点击确定,创建项目:
创建成功后氛围,点击发布标签,可以可视化的发布小游戏包:
编译游戏代码到小游戏:相当于执行命令 egret build --target vivogame,把游戏的代码编译到小游戏的项目里。
发布:相当于执行命令 npm run build,把小游戏工程,编译成 rpk 包。
调试:使用 USB 连接手机和电脑后,点击调试,会把 rpk 上传到手机中,然后启动一个 Chrome 窗口,可以调试手机中运行的小游戏。
三、使用命令行把白鹭游戏编译到小游戏项目
方法1:开发者可以使用命令行来编译和发布到 vivo 小游戏项目中:
1、dubug 模式:egret build --target vivogame;
2、release 模式:egret publish --target vivogame。
方法2:配置 egretProperties.json
"engineVersion": "5.2.22",
"compilerVersion": "5.2.22",
"template": {},
"target": {
"current": "vivogame"
},
如上所示,将 egretProperties.json 配置文件中的 current 属性设置为 vivogame 时,可以直接使用egret build 或者 egret publish 命令编译和发布 vivo 小游戏。
四、使用命令行打包发布 vivo 小游戏
进入小游戏项目,在命令行里执行编译命令 npm run build,成功后会生成一个dist文件夹,里面的 com.application.demo.rpk 文件就是打包好的小游戏项目,可以在手机上运行调试。
如果执行命令 npm run release,则会生成正式发布的小游戏项目。注意白鹭游戏引擎怎么样,发布正式项目,需要在 sign/release/private.pem 路径下自己准备签名文件。
项目代码目录的结构如下:
目录结构说明:
1、egret.vivogame.js:白鹭引擎与小游戏的适配层;
2、js文件夹:游戏项目的代码;
3、game.js:项目入口文件;
4、manifest.js:用来引用所有的 js 代码;
5、manifest.json:小游戏的相关参数设置;
6、resource 文件夹:游戏资源文件;
7、sign 文件夹:签名文件存放的位置。
manifest.json 配置说明:
{
"package": "com.application.demo",
"name": "vivogame",
"versionName": "1.0.0",
"versionCode": "1",
"minPlatformVersion": "1030",
"icon": "/icon/logo.png",
"orientation": "portrait"
}
参数说明:
1、package:应用包名;
2、name:应用名称,6 个汉字以内,与应用商店保存的名称一致,用于在桌面图标、弹窗等处显示应用名称;
3、versionName:应用版本名称;
4、versionCode:应用版本号,从1自增,推荐每次重新上传包时versionCode+1
minPlatformVersion:支持的最小平台版本号;
5、icon:应用图标的路径;
6、orientation:支持的屏幕方向。portrait 为竖屏,landscape 为横屏。该参数会自动从白鹭游戏项目的 index.html 里获取。
五、真机调试
注意:一定要使用 vivo 手机才可以调试
1.在 vivo 手机上安装快应用调试器:#/download/engine
2.打开快游戏调试器音乐,点击 扫码安装,扫描 EgretLauncher 发布 vivo 小游戏界面里的二维码。