無需DevEco Studio就能編譯OHOS應(yīng)用
??51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)??
在2022年3月31日發(fā)布了最新的IDE工具DevEco Studio 3.0 Beta3，仔細(xì)閱讀文檔后發(fā)現(xiàn)最新OpenHarmony應(yīng)用的編譯構(gòu)建過程已經(jīng)公開，對應(yīng)官方文檔：編譯構(gòu)建概述
出于好奇，就對著文檔一步一步，一個文件一個文件的開始手動建立，最后編譯成功，分享一下構(gòu)建過程。
成果
工具準(zhǔn)備
Node.js:v14.19.1+
最新OpenHarmonySDK包，并解壓到一個文件夾中，??SDK下載地址??。
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)建工程
1、創(chuàng)建工程目錄
為了演示我重新在E盤創(chuàng)建一個新的工程文件夾 BuildTest,然后借助vscode工具創(chuàng)建build-profile.json5、hvigofile.js、package.json這三個配置文件。
build-profile.json5:
注意SDK版本及srcPath配置，簽名信息略想看相應(yīng)配置參考上述官方文檔。
{
"app": {
"signingConfigs": [ //工程的簽名信息，可包含多個簽名信息
],
"compileSdkVersion": 8, //指定OpenHarmony應(yīng)用/服務(wù)編譯時的SDK版本
"compatibleSdkVersion": 8, //指定OpenHarmony應(yīng)用/服務(wù)兼容的最低SDK版本
"products": [ //定義構(gòu)建的產(chǎn)品品類，如通用默認(rèn)版、付費版、免費版等
{
"name": "default", //定義產(chǎn)品的名稱，由開發(fā)者自定義
"signingConfig": "debug", //指定當(dāng)前產(chǎn)品品類對應(yīng)的簽名信息，簽名信息需要在signingConfigs中進行定義
}
]
},
"modules": [
{
"name": "entry", //模塊名稱
"srcPath": "./entry", //標(biāo)明src目錄相對工程根目錄的相對路徑
"targets": [ //定義構(gòu)建的產(chǎn)物，由product和各模塊定義的targets共同定義
{
"name": "default", //target名稱，由各個模塊的build-profile.json5中的targets字段定義
"applyToProducts": [ //產(chǎn)品品類名稱，由products字段進行定義
"default"
]
}
]
}
]
}hvigorfile.js：
module.exports = require('@ohos/hvigor-ohos-plugin').legacyAppTasks
package.json：
熟悉npm框架的都應(yīng)該了解，package.json是npm依賴相的配置文件，我們看看在工程目錄下的配置項。
{
"name": "buildtest", //工程名稱
"version": "1.0.0", //版本
"ohos": { //ohos
"org": "huawei",
"buildTool": "hvigor",
"directoryLevel": "project"
},
"description": "example description",
"repository": {},
"license": "ISC",
"dependencies": { //依賴項
"hypium": "^1.0.0",
"@ohos/hvigor": "1.0.6",
"@ohos/hvigor-ohos-plugin": "1.0.6"
}
}配置完工程后，我們創(chuàng)建我們的第一個模塊entry。
2、創(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類型，API 8為FA模型，API 9為Stage模型，不需要修改
"showInServiceCenter": true, //是否在服務(wù)中心露出
"buildOption": {
"arkEnable": true, //是否使用方舟編譯器進行編譯
},
"targets": [ //模塊對應(yīng)的產(chǎn)物配置
{
"name": "default",
}
]
}hvigorfile.js：
module.exports = require('@ohos/hvigor-ohos-plugin').legacyHapTasks
大家來找茬，此處配置乍一看和工程下的hvigorfile.js一個樣，其實require引入的模塊卻不相同，工程目錄是legacyAppTasks此處是legacyHapTasks(工程是AppTasks模塊是HapTasks)。
我就因為此處配置問題浪費了十幾分鐘。
package.json：
此處的npm配置文件則是模塊中引用第三方組件/插件配置處。
{
"license": "ISC",
"name": "entry",
"ohos": {
"org": "huawei",
"directoryLevel": "module",
"buildTool": "hvigor"
},
"description": "example description",
"repository": {},
"version": "1.0.0",
"dependencies": {}
}再在src目錄下建立src/main/config.json、src/main/ets/app.ets、src/main/ets/pages/index.ets、src/resources/…等對應(yīng)文件。此處省略，具體參考對應(yīng)文件結(jié)構(gòu)及文件。
3、構(gòu)建
（1）添加npm源
必須先添加harmonyOS的npm源，否則執(zhí)行npm install 會報404錯誤。
npm config set @ohos:registry=https://repo.harmonyos.com/npm/
（2）在工程目錄安裝依賴
在工程目錄(根目錄)下安裝依賴。
npm install
（3）執(zhí)行構(gòu)建命令
在工程目錄執(zhí)行構(gòu)建命令。
構(gòu)建是通過node.js調(diào)用hvigor工具進行打包構(gòu)建。
確保node已添加在系統(tǒng)環(huán)境變量中。
node ./node_modules/@ohos/hvigor/bin/hvigor.js -m module assembleHap
不出意外會出現(xiàn)以下錯誤：
PS E:\BuildTest> node ./node_modules/@ohos/hvigor/bin/hvigor.js -m module assembleHap
> hvigor ERROR: A problem occurred in root module:
ERROR: Cause: Can not find sdk.dir or OHOS_SDK_HOME in System Environment Path
at E:\BuildTest\local.properties:1:1
PS E:\BuildTest>
以上原因是我們沒有配置SDK路徑。
處理方式為：
在項目根路徑創(chuàng)建 local.properties文件 或者在系統(tǒng)環(huán)境變量中配置OHOS_SDK_HOME，注意是系統(tǒng)環(huán)境變量不是用戶環(huán)境變量。
local.properties:
sdk.dir= //sdk所在文件夾
nodejs.dir=//nodejs所在文件夾
復(fù)制配置好后再重新執(zhí)行構(gòu)建命令就能看到我們構(gòu)建成功的結(jié)果了。
結(jié)語
做了這么多步驟，那么有什么實際意義尼?
1.目前openharmony和HarmonyOS在UI上是共通的，只是API上不同。那么就能將HarmonyOS的UI直接拿到Openharmony上使用，直接打包構(gòu)建openharmony的HAP
2.再加工一下可以像vue-cli那樣直接創(chuàng)建出項目目錄，如果能再實現(xiàn)preview功能，就可以實現(xiàn)無需依賴IDE就能開發(fā)打包HAP。
3.有機會自己自定義一個IDE出來，將上述過程黑盒化,想自己做IDE的朋友這一步肯定不能少。
??51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)??
