2.7.12 发布到华为快游戏
Cocos Creator 3D 从 v1.0.2 版本开始正式支持将游戏发布到华为快游戏平台。我们来看一下如何使用 Cocos Creator 3D 发布到华为快游戏平台。
环境配置
下载 华为快应用加载器,并安装到 Android 设备上(建议 Android Phone 6.0 或以上版本)
PC 端全局安装 nodejs-8.1.4 或以上版本
发布流程
一、使用 Cocos Creator 3D 打开需要发布的项目工程,在 构建发布 面板的 发布平台 中选择 华为快游戏。
必填参数项:根据用户的需求及参数输入框的提示信息进行填写,包括:应用包名、应用名称、桌面图标、应用版本名称、应用版本号、支持的最小平台版本号。
选填参数项:包括 自定义 manifest 文件路径、小包模式、小包模式服务器路径 。
密钥库 以及两个签名文件(certificate.pem 路径 和 private.pem 路径),需要根据用户需求选择勾选 密钥库 或者填写两个路径。
相关参数配置具体的填写规则如下:
游戏名称
该项为必填项。是华为快游戏的名称。
游戏包名
该项为必填项,根据用户的需求进行填写。
桌面图标
该项为必填项。构建时 桌面图标 将会构建到华为快游戏的工程中。点击输入框右边的按钮即可选择图片。桌面图标建议使用 png 图片。
应用版本名称
该项为必填项,根据用户的需求进行填写。
应用版本号
该项为必填项,根据用户的需求进行填写。
支持的最小平台版本号
该项为必填项。根据华为的要求目前这个值必须大于或等于 1035。
自定义 manifest 文件路径
该项为选填项。为华为快游戏扩展功能。使用时需要选择 json 文件,文件中的数据类型要求为 json 格式。注意:当 json 数据的 key 值为
package
、appType
、name
、versionName
、versionCode
、icon
、minPlatformVersion
、config
、display
时不可用。否则在构建时会被 应用包名,应用名称,应用图标,应用版本号,应用版本名称 等数据覆盖。小包模式和小包模式服务器路径
该项为选填项。快游戏的包内体积包含代码和资源不能超过 10M,资源可以通过网络请求加载。小包模式 就是帮助用户将脚本文件保留在快游戏包内,其他资源则上传到远程服务器,根据需要从远程服务器下载。而远程资源的下载、缓存和版本管理,Creator 3D 已经帮用户做好了。用户需要做的是以下两个步骤:
1、构建时,勾选 小包模式,填写 小包模式服务器路径。然后点击 构建。
2、构建完成后,点击 发布路径 后面的 打开 按钮,将发布路径下的 res 目录上传到小包模式服务器。例如:默认发布路径是 build,构建任务名是
huawei-quick-game
,则需要上传build/huawei-quick-game/res
目录。此时,构建出来的 rpk 将不再包含 res 目录,res 目录里的资源将通过网络请求从填写的 小包模式服务器地址 上下载。
分包
v1.0.4 起添加该选项,默认开启,用于控制分包功能的开启。
密钥库
勾选 使用调试密钥库 时,表示默认使用的是 Creator 3D 自带的证书构建 rpk 包,仅用于 调试 时使用。
注意:若 rpk 包要用于提交审核,则构建时不要勾选该项。
如果不勾选 密钥库,则需要配置签名文件 certificate.pem 路径 和 private.pem 路径,此时构建出的是可以 直接发布 的 rpk 包。用户可通过输入框右边的按钮来配置两个签名文件。
有以下两种方式可以生成签名文件:
通过 构建发布 面板 certificate.pem 路径 后的 新建 按钮生成
通过命令行生成 release 签名
用户需要通过 openssl 命令等工具生成签名文件 private.pem、certificate.pem。
# 通过 openssl 命令工具生成签名文件 openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 3650 -out certificate.pem
注意:openssl 工具在 linux 或 Mac 环境下可在终端直接打开。而在 Windows 环境下则需要安装 openssl 工具并且配置系统环境变量,配置完成后需重启 Creator 3D。
二、构建发布
构建发布 面板的相关参数设置完成后,点击 构建。构建完成后点击 发布路径 后面的 打开 按钮来打开构建发布包,可以看到在默认发布路径 build 目录下生成了与构建任务名称一致的目录,该目录就是导出的华为快游戏工程目录和 rpk,rpk 包在对应文件夹的 dist 目录下。
三、将打包出来的 rpk 运行到手机上。
目前仅支持手动拷贝到手机上运行。将构建生成的 rpk 包拷贝到手机 sdcard 目录下。然后在手机上打开 华为快应用加载器 后,点击手机的返回键会弹出一个列表,选择第一个选项 本地安装,选择路径为放置 rpk 的路径,即可将 rpk 运行到手机上。
四、分包 rpk
分包 rpk 是根据用户的需求选择是否使用。分包加载,即把游戏内容按一定规则拆分在几个包里,在首次启动的时候只下载必要的包,这个必要的包称为 主包,开发者可以在主包内触发下载其他子包,这样可以有效降低首次启动的消耗时间。若要使用该功能需要在 Creator 3D 中设置 分包加载,设置完成后在构建时就会自动分包。
构建完成后,生成的子包和主包会合并成一个 rpk,生成目录在 /build/huawei-mini-game/dist 目录下。
注意:目前华为不支持同时下载多个分包,需要下载多个分包时请按顺序下载,等待下一个分包下载完成后再下一个分包。