使用Cocos Creator引擎构建鸿蒙游戏

游戏技术分享 · 2025年06月3日 10:03

游戏HarmonyOS NEXT适配流程如下：

适配准备：

前往开发者官方网站下载最新的release版本版本开发者工具DevEco Studio。
前往Cocos官网下载最新版本的引擎版本。

游戏适配

升级引擎版本。Cocos Creator 2.x 游戏升级到 Cocos Creator 2.4.15及以上。Cocos Creator 3.x 游戏升级到 Cocos Creator 3.8.6（正式版本若发布，请至Cocos官方论坛下载社区版本）及以上。

如需定制引擎，请参考Cocos Creator 2.x指导文档，Cocos Creator 3.x指导文档定制引擎。

增加HarmonyOS NEXT平台的分支业务处理。

如果涉及引擎版本升级，需要解决各引擎升级兼容性问题，比如依赖库版本升级、API接口变更等，确保游戏代码没有编译报错。

例如：
if(cc.sys.os == cc.sys.OS_ANDROID){ 
// 游戏逻辑 
}
修改为：
if(cc.sys.os == cc.sys.OS_ANDROID || cc.sys.os == cc.sys.OS_OPENHARMONY){
 // 游戏逻辑 
}

导出HarmonyOS NEXT工程

游戏适配完成后，用对应引擎Editor构建出HarmonyOS NEXT工程，再进行打包。
关于JS引擎的选择请参考，涉及到JIT和热更新策略的选择，当前推荐选择JSVM，具体的js引擎介绍请参见JS引擎。

构建HarmonyOS工程。
```
 a.打开构建发布面板

 b.发布平台选择HarmonyOS NEXT

 c.选择合适的屏幕朝向

 d.点击构建生成HarmonyOS NEXT工程
```
1. 构建完成后使用Deveco Studio打开HarmonyOS NEXT工程。
  
  Cocos Creator 2.x的HarmonyOS NEXT工程相对游戏项目路径为： build\jsb-link\frameworks\runtime-src\proj.harmonyos-next。
  
  Cocos Creator 3.x的HarmonyOS NEXT工程相对游戏项目路径为： native\engine\harmonyos-next。

JS引擎

Cocos Creator提供了三种JS引擎给开发者，分别是方舟引擎，V8引擎和JSVM。在方舟引擎中，游戏的JavaScript代码和HarmonyOS NEXT的ArkTs均运行在方舟引擎环境中。V8引擎和JSVM中，游戏JS代分别运行在V8引擎和JSVM的环境中，而HarmonyOS NEXT的ArkTs则运行在方舟引擎上，运行环境不同所带来的差异就是游戏JS和HarmonyOS NEXT ArkTs的执行环境的差异。在方舟引擎中，JS和ArkTs在同一个JS运行环境，因此全局对象是可以访问到的；在V8和JSVM引擎下，游戏的JS分别运行在V8和JSVM环境中，因此需要通过C++去桥接，这里Cocos官方提供了封装好的接口用于接口通信，这块内容将在下一节的内容中展开说明。当前的JS引擎关于热更新的方案如表格所示，方舟引擎暂时不支持热更新，V8引擎和JSVM支持热更新，因此在选择JS引擎时推荐选择JSVM。