沉潛學(xué)業(yè)許久，終于有時間來更新博客了。早在 2021 年 Cocos 游戲引擎已支持導(dǎo)出 HarmonyOS 工程，在 11 月份 Cocos 又繼續(xù)推出了 OpenHarmony 版本編輯器。

本文基于過去踩過的坑坑洼洼，總結(jié)一套 Cocos 游戲開發(fā)環(huán)境的搭建和一些需要注意的事項。

Cocos-Dashboard下載

Cocos-Dashboard 下載：

https://www.cocos.com/creator-download

任意點擊“從 Dashboard 安裝”，下載 Dashboard。

下載安裝完畢后，注冊 Cocos 賬號登錄即可。

Cocos-Editor 下載

打開 Cocos-Dashboard，選擇編輯器->下載編輯器。

選擇下載編輯器 3.6.1 版本即可。

這里建議點擊設(shè)置，將默認(rèn)下載路徑放置 C 盤以外。

正常的 3.X 版本能夠?qū)С?Web，Windows，Android，HarmonyOS，快游戲等多平臺，但是目前導(dǎo)出 OpenHarmony 工程需要下載特定編輯器。下載資源在文末。

下載好后解壓至 Cocos-editor 目錄下：

命名為 3.6.1-oh，該版本是基于 3.6.1 版本編輯器的，要與原來的 3.6.1 編輯器進行區(qū)分，也只有該版本才能導(dǎo)出 OpenHarmony 工程。

進入到剛剛解壓好的編輯器文件夾內(nèi)，雙擊 Cocoscreator.exe。

點擊打卡 Dashboard，此時成功添加 oh 版本的編輯器。

導(dǎo)出HarmonyOS 工程

①新建 Cocos 工程

安裝 JAVA API5：

Cocos 導(dǎo)出的是基于 Java 的 HarmonyOS 工程，后續(xù)我們可通過反射來實現(xiàn) Cocos 引擎調(diào)用鴻蒙分布式能力。

新建 Cocos-3D 工程：打開 Dashboard，選擇項目->Empty 3D，并自定義工程名稱，點擊創(chuàng)建。

新建場景 scene：點擊層級管理器區(qū)域，按下 ctrl+S。

點擊保存即可：

創(chuàng)建空節(jié)點 root：

創(chuàng)建資源文件夾：在資源管理器的 assets 文件夾下，創(chuàng)建 model 文件夾。

下載文末附件的 model.zip，并且解壓，全選文件，拖入到剛剛創(chuàng)建的 model 文件夾中。

將模型拖入到 root 節(jié)點，點擊 file.fbx 文件拖入到 root 中，root 節(jié)點下新增 file 節(jié)點。

雙擊 file 節(jié)點，可在場景編輯器中查看。

如果此時發(fā)現(xiàn)渲染的模型太小，點擊窗口，讓場景管理器獲得聚焦，按住鼠標(biāo)右鍵，控制 WASD 方向鍵進行漫游，找到模型所在位置，調(diào)整位置，讓模型處在視圖中間。

點擊 Main Camera：可見此時攝像機視角不是我們所想要的正面視角。

點擊 Main Camera，確保其為選中狀態(tài)，同時按下 ctrl+shift+F，攝像頭將自動調(diào)制成預(yù)覽器視角。

可見當(dāng)前攝像機視角畫面偏暗。

點擊 Main light：確保其為選中狀態(tài)，同時按下 ctrl+shift+F，光源將會自動照在當(dāng)前視角。

②進行網(wǎng)頁預(yù)覽

可在本地回環(huán)網(wǎng)址 127.0.0.1 進行預(yù)覽：

③編寫 TypeScript 腳本，讓 model 轉(zhuǎn)動起來

首先按下 ctrl+S 保存一下當(dāng)前進度。

新建 script 文件夾：新建 TypeScript 腳本文件，右鍵文件夾->創(chuàng)建->腳本->New Component，命名為 main。

設(shè)置默認(rèn)腳本編輯器：編輯器左上角 Cocos Creator->偏好設(shè)置->外部程序->默認(rèn)腳本編輯器。

跟蹤到常用的代碼 IDE.exe 文件即可，我這里用的是 IDEA。

編寫業(yè)務(wù)邏輯：雙擊 main.ts 文件。

main.ts 編寫代碼如下：

import{_decorator,Component,Node,Vec3}from'cc';
const{ccclass,property}=_decorator;

@ccclass('main')
exportclassmainextendsComponent{
start(){

}

update(deltaTime:number){
this.node.setRotationFromEuler(newVec3(this.node.eulerAngles.x,this.node.eulerAngles.y+1,this.node.eulerAngles.z))
}
}

回到 Cocos 編輯器中，點擊 root 根節(jié)點下的 file 節(jié)點，將 main.ts 腳本拖入到屬性檢查器中。

模擬器預(yù)覽：可見此時模型以及轉(zhuǎn)動起來。

④導(dǎo)出 HarmonyOS 工程

配置 HarmonyOS-SDK：點擊左上角 Cocos Creator->偏好設(shè)置->外部程序。

設(shè)置 HarmonyOS-SDK 和 NDK，HarmonyOS-SDK 位置可在 Devecho 的 tools 欄下的 SDKManager 中查看。

如果 native-SDK 中存在多個版本，需要具體到某個具體版本文件夾中，這里建議使用 JAVA-API5 以上的版本。

而 SDK 一欄只需要具體到根目錄即可。

項目構(gòu)建：點擊項目->構(gòu)建發(fā)布。

按照如下方式填寫：

資源服務(wù)地址隨意填寫網(wǎng)址即可，點擊構(gòu)建，構(gòu)建完畢后，點擊文件夾按鈕。

進入到如圖路徑，點擊文件夾根目錄->進入 native 目錄。

進入到 engine 目錄，ohos 即為 HarmonyOS 工程。

編譯 HarmonyOS 工程：用 DevEcho 打開項目根目錄 /native/engine/ohos 文件。

用數(shù)據(jù)線連接 HarmonyOS 設(shè)備（手機，平板，智慧屏），進行自動簽名。

自動簽名方式不在贅述，打開 ohos 項目級 build.gradle 文件。其中 debug 簽名為剛剛的自動簽名，而 release 簽名是 cocos 導(dǎo)出工程自帶的手動簽名文件，現(xiàn)已失效，我們需要將 debug 的簽名內(nèi)容替換掉 release 中的內(nèi)容。

我們需要對 2 個項目級別的 build.gradle 進行簽名替換。

替換 ohos/build.gradle：

替換 ohos/entry/build.gradle：

編譯工程，安裝進入 HarmonyOS 設(shè)備。

運行工程：

導(dǎo)出OpenHarmony 工程

準(zhǔn)備：OpenHarmony 開發(fā)板（九聯(lián) tiger，Dayu200），燒錄 3.2 beta2 版本系統(tǒng)（可由每日構(gòu)建下載 9 月之后的版本）。3.2.5.5 版本 native 和 ETS(API)目前僅支持該版本，SDK 見閱讀原文。

添加 3.2.5.5 版本 SDK/NDK：考慮到目前新版已經(jīng)來到 3.2.7.x，目前導(dǎo)出 OpenHarmony-Cocos 工程需要 3.2.5.5 版本，因此我們需要手動添加 SDK 和 NDK。

解壓 ets-windows-3.2.5.6-beta2 壓縮包：

解壓 3.2.5.5-ETS 文件：解壓到 OpenHarmonySDK-ETS 路徑下，并把文件夾名字從 ets 改到 3.2.5.5。

如果 ETS-SDK 文件夾中存在 3.2.7.x 版本，則需要將該文件改名，添加幾個字符后綴，這樣 IDE 就會檢測不到該版本的 SDK，就只會使用 3.2.5.5 的版本。（IDE 默認(rèn)使用最高版本，所以需要把高于 3.2.5.5 的文件都改名）

進入到 3.2.5.5 文件夾，修改配置文件，修改 oh-uni-package.json，防止更新。

{
"apiVersion":"9",
"displayName":"Ets",
"meta":{
"metaVersion":"3.0.0"
},
"path":"ets",
"releaseType":"Beta2",
"version":"3.2.5.5"
}

需要注意，進入 IDE 的時候會提示 SDK 可升級，千萬不要進行升級！

解壓 native-windows-3.2.5.6-beta2 文件：

將壓縮包里的 native 文件夾，解壓到 OpenHarmony-SDK 路徑下的 native 文件夾中，同樣把該文件夾名改為 3.2.5.5（原為 native）

同理，如果此時存在更高版本的 native 文件夾，也需要添加后綴讓 IDE 識別不到更高的版本。

配置 OpenHarmonySDK/NDK：點擊 CocosCreator->偏好設(shè)置->外部程序，追蹤到 OpenHarmonySDK 根目錄即可。

構(gòu)建 OpenHarmony 工程：我們沿用第三節(jié)創(chuàng)建的 Cocos 工程，不過這里我們使用 3.6.1-oh 版本編輯器進行打開，在第一節(jié)中我們已經(jīng)安裝了該編輯器，并命名為 3.6.1-oh。

由于這里使用九聯(lián) tiger 版演示，其自帶的屏幕分辨率為 800x400，我們需要重新設(shè)置分辨率。

點擊項目->項目設(shè)置，設(shè)置寬高。這里根據(jù)實際分辨率進行設(shè)置即可。

構(gòu)建工程：點擊項目->構(gòu)建發(fā)布->新建構(gòu)建項目，勾選導(dǎo)出 OpenHarmony 工程，勾選調(diào)試模式。

點擊構(gòu)建：同理，點擊 OpenHarmony 欄下的文件夾。

項目根目錄 /native/engine/openHarmony 文件夾，即為導(dǎo)出的 OpenHarmony 工程。

編譯 OpenHarmony 工程：同理，用 DevEcho 打開 OpenHarmony 工程，工程結(jié)構(gòu)如下。

自動簽名即可，連接開發(fā)板，編譯運行程序即可：

注意事項

OpenHarmony/HarmonyOS 的 SDK 路徑，可在 tools-sdk manager 中查看。

HarmonyOS 工程導(dǎo)出：

需要在 Cocos 偏好設(shè)置->外部程序中配置對應(yīng)的 SDK 和 NDK 路徑，導(dǎo)出的工程默認(rèn)使用 JAVA-API5

自動簽名時需要確保 ohos 下的 build.gradle 文件和 entry 目錄下 build.gradle 文件的 debug 簽名和 release 簽名一致，均為自動化簽名的信息（其自帶的簽名文件不可用）

OpenHarmony 工程導(dǎo)出：

目前只能使用 3.2.5.5-ETS 和 NATIVE 版本和 3.6.1-oh 版本編輯器，下載資源均在“閱讀原文”。

構(gòu)建發(fā)布時，記得勾選調(diào)試模式。

結(jié)語

在 HarmonyOS 側(cè)，Cocos 引擎提供了 3D 場景繪制功能，目前已實現(xiàn) Cocos 側(cè)反射調(diào)用 HarmonyOS 分布式能力，可以做出非常有有意思的東西。

另外 OpenHarmony 側(cè)還需等待 Cocos 側(cè)進一步適配，同時開發(fā)板自身的渲染計算能力也是硬條件。

審核編輯：湯梓紅