OpenHarmony應(yīng)用的編譯構(gòu)建過(guò)程

2022 年 3 月 31 日發(fā)布了最新的 IDE 工具 DevEco Studio 3.0 Beta3，仔細(xì)閱讀文檔后發(fā)現(xiàn)最新 OpenHarmony 應(yīng)用的編譯構(gòu)建過(guò)程已經(jīng)公開(kāi)。

對(duì)應(yīng)官方文檔：《編譯構(gòu)建概述》

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-building-overview-0000001263360495

出于好奇，就對(duì)著文檔一步一步，一個(gè)文件一個(gè)文件的開(kāi)始手動(dòng)建立，最后編譯成功，分享一下構(gòu)建過(guò)程。

成果

如下圖：

工具準(zhǔn)備

Node.js:v14.19.1+

最新 OpenHarmonySDK 包，并解壓到一個(gè)文件夾中，SDK下載地址：

https://gitee.com/link?target=https%3A%2F%2Frepo.huaweicloud.com%2Fharmonyos%2Fos%2F3.1-Release%2Fohos-sdk.tar.gz

SDK 目錄結(jié)構(gòu)：

|---ets
|---3.1.5.5
|+---api
|+---build-tools
||+---ets-loader
|---component
---toolchains
---3.1.5.5
+---configcheck
+---lib
---syscapcheck

在創(chuàng)建好該目錄結(jié)構(gòu)后還需要在 ets/js 下的 ./3.1.5.5/build-tools/ets-loader/ 目錄下執(zhí)行 npm install 命令。

創(chuàng)建工程

①創(chuàng)建工程目錄

為了演示我重新在E盤(pán)創(chuàng)建一個(gè)新的工程文件夾 BuildTest，然后借助 vscode 工具創(chuàng)建 build-profile.json5、hvigofile.js、package.json 這三個(gè)配置文件。

build-profile.json5：注意 SDK 版本及 srcPath 配置，簽名信息略想看相應(yīng)配置參考上述官方文檔。

{
"app":{
"signingConfigs":[//工程的簽名信息，可包含多個(gè)簽名信息
],
"compileSdkVersion":8,//指定OpenHarmony應(yīng)用/服務(wù)編譯時(shí)的SDK版本
"compatibleSdkVersion":8,//指定OpenHarmony應(yīng)用/服務(wù)兼容的最低SDK版本
"products":[//定義構(gòu)建的產(chǎn)品品類(lèi)，如通用默認(rèn)版、付費(fèi)版、免費(fèi)版等
{
"name":"default",//定義產(chǎn)品的名稱(chēng)，由開(kāi)發(fā)者自定義
"signingConfig":"debug",//指定當(dāng)前產(chǎn)品品類(lèi)對(duì)應(yīng)的簽名信息，簽名信息需要在signingConfigs中進(jìn)行定義
}
]
},
"modules":[
{
"name":"entry",//模塊名稱(chēng)
"srcPath":"./entry",//標(biāo)明src目錄相對(duì)工程根目錄的相對(duì)路徑
"targets":[//定義構(gòu)建的產(chǎn)物，由product和各模塊定義的targets共同定義
{
"name":"default",//target名稱(chēng)，由各個(gè)模塊的build-profile.json5中的targets字段定義
"applyToProducts":[//產(chǎn)品品類(lèi)名稱(chēng)，由products字段進(jìn)行定義
"default"
]
}
]
}
]
}

hvigorfile.js：

module.exports=require('@ohos/hvigor-ohos-plugin').legacyAppTasks

package.json：熟悉 npm 框架的都應(yīng)該了解，package.json 是 npm 依賴(lài)相的配置文件，我們看看在工程目錄下的配置項(xiàng)。

{
"name":"buildtest",//工程名稱(chēng)
"version":"1.0.0",//版本
"ohos":{//ohos
"org":"huawei",
"buildTool":"hvigor",
"directoryLevel":"project"
},
"description":"exampledescription",
"repository":{},
"license":"ISC",
"dependencies":{//依賴(lài)項(xiàng)
"hypium":"^1.0.0",
"@ohos/hvigor":"1.0.6",
"@ohos/hvigor-ohos-plugin":"1.0.6"
}
}

配置完工程后，我們創(chuàng)建我們的第一個(gè)模塊 entry。

②創(chuàng)建模塊

在工程目錄創(chuàng)建文件夾 entry（于上述 build-profile.json5 的 module 配置的 srcPath 保持一致）。

并添加模塊配置文件：build-profile.json5、hvigorfile.js、package.json以及和 HarmonyOS 一樣的 src 模塊目錄。

build-profile.json5：此處省略了 Cpp 配置，Cpp 相關(guān)配置參考官方文檔。

{
"apiType":'faMode',//API類(lèi)型，API8為FA模型，API9為Stage模型，不需要修改
"showInServiceCenter":true,//是否在服務(wù)中心露出
"buildOption":{
"arkEnable":true,//是否使用方舟編譯器進(jìn)行編譯
},
"targets":[//模塊對(duì)應(yīng)的產(chǎn)物配置
{
"name":"default",
}
]
}

hvigorfile.js：

module.exports=require('@ohos/hvigor-ohos-plugin').legacyHapTasks

大家來(lái)找茬，此處配置乍一看和工程下的 hvigorfile.js 一個(gè)樣，其實(shí) require 引入的模塊卻不相同。

工程目錄是 legacyAppTasks，此處是 legacyHapTasks（工程是 AppTasks 模塊是 HapTasks）。我就因?yàn)榇颂幣渲脝?wèn)題浪費(fèi)了十幾分鐘。

package.json：此處的 npm 配置文件則是模塊中引用第三方組件/插件配置處。

{
"license":"ISC",
"name":"entry",
"ohos":{
"org":"huawei",
"directoryLevel":"module",
"buildTool":"hvigor"
},
"description":"exampledescription",
"repository":{},
"version":"1.0.0",
"dependencies":{}
}

再在 src 目錄下建立 src/main/config.json、src/main/ets/app.ets、src/main/ets/pages/index.ets、src/resources/…等對(duì)應(yīng)文件。此處省略，具體參考對(duì)應(yīng)文件結(jié)構(gòu)及文件。

③構(gòu)建

添加 npm 源：必須先添加 HarmonyOS 的 npm 源，否則執(zhí)行 npm install 會(huì)報(bào) 404 錯(cuò)誤。

npmconfigset@ohos:registry=https://repo.harmonyos.com/npm/

在工程目錄安裝依賴(lài)：在工程目錄（根目錄）下安裝依賴(lài)。

npminstall

執(zhí)行構(gòu)建命令：在工程目錄執(zhí)行構(gòu)建命令，構(gòu)建是通過(guò) node.js 調(diào)用 hvigor 工具進(jìn)行打包構(gòu)建，確保 node 已添加在系統(tǒng)環(huán)境變量中。

node./node_modules/@ohos/hvigor/bin/hvigor.js-mmoduleassembleHap

不出意外會(huì)出現(xiàn)以下錯(cuò)誤：

PSE:BuildTest>node./node_modules/@ohos/hvigor/bin/hvigor.js-mmoduleassembleHap
>hvigorERROR:Aproblemoccurredinrootmodule:
ERROR:Cause:Cannotfindsdk.dirorOHOS_SDK_HOMEinSystemEnvironmentPath
atE:BuildTestlocal.properties:1:1
PSE:BuildTest>

以上原因是我們沒(méi)有配置 SDK 路徑。

處理方式為：在項(xiàng)目根路徑創(chuàng)建 local.properties 文件或者在系統(tǒng)環(huán)境變量中配置 OHOS_SDK_HOME，注意是系統(tǒng)環(huán)境變量不是用戶(hù)環(huán)境變量。

local.properties：

sdk.dir=//sdk所在文件夾
nodejs.dir=//nodejs所在文件夾

配置好后再重新執(zhí)行構(gòu)建命令就能看到我們構(gòu)建成功的結(jié)果了。

結(jié)語(yǔ)

做了這么多步驟，那么有什么實(shí)際意義尼？

①目前 OpenHarmony 和 HarmonyOS 在 UI 上是共通的，只是 API 上不同。那么就能將 HarmonyOS 的 UI 直接拿到 Openharmony 上使用，直接打包構(gòu)建 OpenHarmony 的 HAP。

②再加工一下可以像 vue-cli 那樣直接創(chuàng)建出項(xiàng)目目錄，如果能再實(shí)現(xiàn) preview 功能，就可以實(shí)現(xiàn)無(wú)需依賴(lài) IDE 就能開(kāi)發(fā)打包 HAP。

③有機(jī)會(huì)自己自定義一個(gè) IDE 出來(lái)，將上述過(guò)程黑盒化，想自己做 IDE 的朋友這一步肯定不能少。