一站式集成Cocos&OpenHarmony/HarmonyOS開發(fā)環(huán)境
??想了解更多關(guān)于開源的內(nèi)容,請訪問:??
1、Cocos-Dashboard下載
Cocos-Dashboard下載。
任意點擊“從Dashboard安裝”,下載Dashboard。
下載安裝完畢后,注冊Cocos賬號登錄即可。
2、Cocos-Editor下載
打開Cocos-Dashboard,選擇編輯器->下載編輯器。
選擇下載編輯器3.6.1版本即可。
這里建議點擊設(shè)置,將默認(rèn)下載路徑放置C盤以外。
正常的3.X版本能夠?qū)С鯳eb,Windows,Android,HarmonyOS,快游戲等多平臺,但是目前導(dǎo)出OpenHarmony工程需要下載特定編輯器。下載資源在文末。
下載CocosCreator-v3.6.1-oh-win-092319(文末)
下載好后解壓至Cocos-editor目錄下。
命名為3.6.1-oh,該版本是基于3.6.1版本編輯器的,要與原來的3.6.1編輯器進(jìn)行區(qū)分,也只有該版本才能導(dǎo)出OpenHarmony工程。進(jìn)入到剛剛解壓好的編輯器文件夾內(nèi),雙擊Cocoscreator.exe。
點擊打卡Dashboard,此時成功添加oh版本的編輯器。
3、導(dǎo)出HarmonyOS工程
(1)新建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方向鍵進(jìn)行漫游,找到模型所在位置,調(diào)整位置,讓模型處在視圖中間。
點擊Main Camera
可見此時攝像機(jī)視角不是我們所想要的正面視角。
點擊Main Camera,確保其為選中狀態(tài),同時按下ctrl+shift+F,攝像頭將自動調(diào)制成預(yù)覽器視角。
可見當(dāng)前攝像機(jī)視角畫面偏暗。
點擊Main light
確保其為選中狀態(tài),同時按下ctrl+shift+F,光源將會自動照在當(dāng)前視角。
(2)進(jìn)行網(wǎng)頁預(yù)覽
可在本地回環(huán)網(wǎng)址127.0.0.1進(jìn)行預(yù)覽。
(3)編寫TypeScript腳本,讓model轉(zhuǎn)動起來
首先按下ctrl+S保存一下當(dāng)前進(jìn)度。
新建script文件夾
新建TypeScript腳本文件,右鍵文件夾->創(chuàng)建->腳本->New Component,命名為main。
設(shè)置默認(rèn)腳本編輯器
編輯器左上角Cocos Creator->偏好設(shè)置->外部程序->默認(rèn)腳本編輯器。
跟蹤到常用的代碼IDE.exe文件即可,我這里用的是IDEA。
編寫業(yè)務(wù)邏輯
雙擊main.ts文件。
main.ts編寫代碼如下:
回到Cocos編輯器中,點擊root根節(jié)點下的file節(jié)點,將main.ts腳本拖入到屬性檢查器中。
模擬器預(yù)覽。
可見此時模型以及轉(zhuǎn)動起來。
(4)導(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)建完畢后,點擊文件夾按鈕。
進(jìn)入到如圖路徑,點擊文件夾根目錄->進(jìn)入native目錄。
進(jìn)入到engine目錄,ohos即為HarmonyOS工程。
編譯HarmonyOS工程
用DevEcho打開項目根目錄/native/engine/ohos文件。
用數(shù)據(jù)線連接HarmonyOS設(shè)備(手機(jī),平板,智慧屏),進(jìn)行自動簽名。
自動簽名方式不在贅述。
打開ohos項目級build.gradle文件。
其中debug簽名為剛剛的自動簽名,而release簽名是cocos導(dǎo)出工程自帶的手動簽名文件,現(xiàn)已失效,我們需要將debug的簽名內(nèi)容替換掉release中的內(nèi)容。我們需要對2個項目級別的build.gradle進(jìn)行簽名替換。
替換ohos/build.gradle。
替換ohos/entry/build.gradle。
編譯工程,安裝進(jìn)入HarmonyOS設(shè)備。
運(yùn)行工程。
4、導(dǎo)出OpenHarmony工程
(1)準(zhǔn)備
OpenHarmony開發(fā)板(九聯(lián)tiger,Dayu200),燒錄3.2 beta2版本系統(tǒng)(可由每日構(gòu)建下載9月之后的版本)。
3.2.5.5版本native和ETS(API)目前僅支持該版本,SDK見文末。
(2)添加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的文件都改名)。
進(jìn)入到3.2.5.5文件夾,修改配置文件。
修改oh-uni-package.json,防止更新。
需要注意,進(jìn)入IDE的時候會提示SDK可升級,千萬不要進(jìn)行升級!
解壓native-windows-3.2.5.6-beta2文件
將壓縮包里的native文件夾,解壓到OpenHarmony-SDK路徑下的native文件夾中,同樣把該文件夾名改為3.2.5.5(原為native)。
同理,如果此時存在更高版本的native文件夾,也需要添加后綴讓IDE識別不到更高的版本。
(3) 配置OpenHarmonySDK/NDK
點擊CocosCreator->偏好設(shè)置->外部程序。
追蹤到OpenHarmonySDK根目錄即可。
(4)構(gòu)建OpenHarmony工程
我們沿用第三節(jié)創(chuàng)建的Cocos工程,不過這里我們使用3.6.1-oh版本編輯器進(jìn)行打開,在第一節(jié)中我們已經(jīng)安裝了該編輯器,并命名為3.6.1-oh。
由于這里使用九聯(lián)tiger版演示,其自帶的屏幕分辨率為800x400,我們需要重新設(shè)置分辨率。
點擊項目->項目設(shè)置,設(shè)置寬高。這里根據(jù)實際分辨率進(jìn)行設(shè)置即可。
構(gòu)建工程。
點擊項目->構(gòu)建發(fā)布->新建構(gòu)建項目。
勾選導(dǎo)出OpenHarmony工程,勾選調(diào)試模式。
點擊構(gòu)建。
同理,點擊OpenHarmony欄下的文件夾。
項目根目錄/native/engine/openHarmony文件夾,即為導(dǎo)出的OpenHarmony工程。
(5)編譯OpenHarmony工程
同理,用DevEcho打開openHarmony工程,工程結(jié)構(gòu)如下。
自動簽名即可。
連接開發(fā)板,編譯運(yùn)行程序即可。
5、注意事項
(1)OpenHarmony/HarmonyOS的SDK路徑
可在tools-sdk manager中查看。
(2)HarmonyOS工程導(dǎo)出
需要在Cocos偏好設(shè)置->外部程序中配置對應(yīng)的SDK和NDK路徑,導(dǎo)出的工程默認(rèn)使用JAVA-API5。
自動簽名時需要確保ohos下的build.gradle文件和entry目錄下build.gradle文件的debug簽名和release簽名一致,均為自動化簽名的信息(其自帶的簽名文件不可用)。
(3)OpenHarmony工程導(dǎo)出
目前只能使用3.2.5.5-ETS和NATIVE版本和3.6.1-oh版本編輯器,下載資源均在文末。
構(gòu)建發(fā)布時,記得勾選調(diào)試模式。
6、結(jié)語
在HarmonyOS側(cè),Cocos引擎提供了3D場景繪制功能,目前已實現(xiàn)Cocos側(cè)反射調(diào)用HarmonyOS分布式能力,可以做出非常有有意思的東西。另外OpenHarmony側(cè)還需等待Cocos側(cè)進(jìn)一步適配,同時開發(fā)板自身的渲染計算能力也是硬條件。
文章相關(guān)附件可以點擊下面的原文鏈接前往下載:
https://ost.51cto.com/resource/2443。
https://ost.51cto.com/resource/2445。
https://ost.51cto.com/resource/2446。