游戏适配HarmonyOS NEXT流程如下:
适配准备
- 前往开发者官网下载最新的release版本DevEco Studio开发者工具。
- Laya1.0:引擎IDE升级到1.8.16及以上版本
- Laya2.0:引擎IDE升级到2.13.7及以上版本
- Laya3.0:引擎IDE升级到3.2.3及以上版本
游戏适配
如果游戏中有针对不同平台进行适配的代码,需要先判断HarmonyOS NEXT平台并添加对应的适配代码。
checkHarmonyOS() {
let os = Laya.Browser.window.
conch.config.getOS();
return os == 'Conch-ohos';
}
导出HarmonyOS NEXT工程
以Laya2.0为例打包构建HarmonyOS NEXT工程:
- 打开LayaAirIDE—>点击左上角LOGO图标—>工具—>app构建,如图所示:
- 在构建项目配置界面选择最新的Native版本(当前2.13.8)、选择项目类型(ohos),如图所示:
- 配置完成后点击开始创建可在指定的输出路径输出HarmonyOS NEXT工程项目,如图所示:
- 使用DevEco Studio工具打开并连接设备构建hap/app运行,如图所示:
集成应用服务
- 游戏点亮后,需要接入HarmonyOS NEXT平台系统能力(电量、振动器、网络等),为向玩家提供快捷、安全的登录、支付等功能,游戏需集成登录、支付等应用服务,其中游戏业务逻辑调用HarmonyOS NEXT系统接口的原理如下图所示:
- Game Service Kit接入
- IAP Kit接入
调试上架
-
配置证书签名信息,参考应用/元服务签名
-
调试阶段:构建hap包进行调试功能验收,需要申请调试证书、注册调试设备、申请调试Profile,具体操作请参见调试HarmonyOS应用/元服务
-
发布阶段:构建app包提审上架,需要申请发布证书、申请发布Profile、发布HarmonyOS应用,具体操作请参见发布应用(APP)
游戏与ArkTS接口交互
由于HarmonyOS NEXT使用的协议栈和其他系统的协议栈不同,因此游戏原有的系统适配方法在HarmonyOS NEXT平台可能不支持,需要根据当前游戏实际使用情况进行适配。
- 在HarmonyOS NEXT工程中添加ets脚本。
- 在ets脚本中添加需要调用的静态方法,如下示例代码:
// build-profile.json5
{
"apiType": 'stageMode',
"buildOption": {
"arkOptions": {
"runtimeOnly": {
"sources": [
"./src/main/ets/AccountDemo.ets"
]
}
},
...
}
- 游戏中调用添加到HarmonyOS NEXT静态方法,如下示例会调用之前添加在AccountDemo.ets中的静态方法:
// 点击登录按钮
onClickLogin() {
let bridge = Laya.Browser.window.PlatformClass.createClass("entry/src/main/ets/AccountDemo");
bridge.callWithBack((result: string) => {
bridge.callWithBack((result: string) => {
// TODO 添加你的游戏逻辑
}, "login");
}, "gameServiceInit");
}
- 在ArkTS代码中主动执行游戏JS脚本方法,如下示例会在游戏中执行alert('hello world')
// 导入laya的库文件
import laya from "liblaya.so";
function arkTsFunc(): void {
// 调用laya引擎方法在游戏侧执行JS脚本
laya.ConchNAPI_RunJS("alert('hello world')");
}
export { arkTsFunc };
原文链接:华为开发者文章
更多问题可关注:
鸿蒙游戏官方网站:已有游戏移植-鸿蒙游戏-华为开发者联盟
公开课:华为开发者学堂