一 鴻蒙簡(jiǎn)介：

1.1?HarmonyOS是華為自研的一款分布式操作系統(tǒng)，兼容Android，但又區(qū)別Android，不僅僅定位于手機(jī)系統(tǒng)。更側(cè)重于萬物物聯(lián)和智能終端，目前已更新到4.0版本。

1.2?HarmonyOS軟件編程語言是ArkTS，是基于TypeScript的拓展，而TypeScript又是JavaScript的拓展，所以有過JavaScript經(jīng)驗(yàn)會(huì)更容易些。

二?HarmonyOS編程環(huán)境搭建

2.1?HarmonyOS軟件編程工具是DevEco Studio，下載官網(wǎng)鏈接：https://developer.harmonyos.com/cn/develop/deveco-studio

2.2 下載后點(diǎn)擊安裝

2.3 安裝好運(yùn)行

2.4? 點(diǎn)擊同意進(jìn)入配置

2.5?進(jìn)入DevEco Studio配置頁面，首先需要進(jìn)行基礎(chǔ)配置，包括Node.js與Ohpm的安裝路徑設(shè)置，選擇從華為鏡像下載至合適的路徑

2.6?單擊'Next'進(jìn)入SDK配置，設(shè)置為合適的路徑

2.7?點(diǎn)擊'Next'后會(huì)顯示'SDK License Agreement'，閱讀相關(guān)協(xié)議后，勾選'Accept'。

2.8?單擊‘Next’進(jìn)入配置預(yù)覽頁，在這里進(jìn)行配置項(xiàng)的確認(rèn)。

?2.9?確認(rèn)完成后，單擊'Next'，進(jìn)入下一步。

2.10?等待配置自動(dòng)下載完成，完成后，單擊'Finish'，IDE會(huì)進(jìn)入歡迎頁，我們也就成功配置好了開發(fā)環(huán)境。

三 創(chuàng)建項(xiàng)目

3.1?在歡迎頁中單擊Create Project，進(jìn)入項(xiàng)目創(chuàng)建頁面。

3.2?選擇‘Application’，然后選擇‘Empty Ability’，單擊‘Next’進(jìn)入工程配置頁。

?3.3?配置頁中，詳細(xì)信息如下：

• Project name是開發(fā)者可以自行設(shè)置的項(xiàng)目名稱，這里根據(jù)自己選擇修改為自己項(xiàng)目名稱。
• Bundle name是包名稱，默認(rèn)情況下應(yīng)用ID也會(huì)使用該名稱，應(yīng)用發(fā)布時(shí)對(duì)應(yīng)的ID需要保持一致。
• Save location為工程保存路徑，建議用戶自行設(shè)置相應(yīng)位置。
• Compile SDK是編譯的API版本，這里默認(rèn)選擇API9。
• Model選擇Stage模型，其他保持默認(rèn)即可。
• 然后單擊“Finish”完成工程創(chuàng)建，等待工程同步完成。

3.4??進(jìn)入IDE后，可以看到根大部分編輯器差不多。整個(gè)IDE的界面大致上可以分為四個(gè)部分，分別是代碼編輯區(qū)、通知欄、工程目錄區(qū)以及預(yù)覽區(qū)。

3.5?單擊右上角Previewer，可以預(yù)覽相應(yīng)的文件UI展示效果。?

四 調(diào)試

4.1??單擊頂部工具欄Tools>Device Manager。

4.2?選擇Local Emulator，設(shè)置合適的Local Emulator Location存儲(chǔ)地址，然后單擊’+New Emulator’

4.3?選擇Huawei_Phone手機(jī)模擬器，單擊'Next'，進(jìn)入模擬器系統(tǒng)下載頁。

4.4??選擇下載api9的系統(tǒng)鏡像，然后單擊'Next’，等待下載完成。

4.5??下載完成后，在Local Emulator頁面中會(huì)出現(xiàn)創(chuàng)建的手機(jī)模擬器，點(diǎn)擊Actions按鈕，就能夠啟動(dòng)模擬器。

4.6?模擬器啟動(dòng)后，點(diǎn)擊上方啟動(dòng)按鈕，將Hello World工程運(yùn)行到模擬器上。

4.7?IDE構(gòu)建完成后，即可在模擬器上看到運(yùn)行效果，我們也就完成了Hello World工程在模擬器上的運(yùn)行。

五 工程介紹

5.1 工程目錄

• AppScope中存放應(yīng)用全局所需要的資源文件。
• entry是應(yīng)用的主模塊，存放HarmonyOS應(yīng)用的代碼、資源等。
• oh_modules是工程的依賴包，存放工程依賴的源文件。
• build-profile.json5是工程級(jí)配置信息，包括簽名、產(chǎn)品配置等。
• hvigorfile.ts是工程級(jí)編譯構(gòu)建任務(wù)腳本，hvigor是基于任務(wù)管理機(jī)制實(shí)現(xiàn)的一款全新的自動(dòng)化構(gòu)建工具，主要提供任務(wù)注冊(cè)編排，工程模型管理、配置管理等核心能力。
• oh-package.json5是工程級(jí)依賴配置文件，用于記錄引入包的配置信息。

5.2 模塊目錄

entry>src目錄中主要包含總的main文件夾，單元測(cè)試目錄ohosTest，以及模塊級(jí)的配置文件。

• main文件夾中，ets文件夾用于存放ets代碼，resources文件存放模塊內(nèi)的多媒體及布局文件等，module.json5文件為模塊的配置文件。
• ohosTest是單元測(cè)試目錄。
• build-profile.json5是模塊級(jí)配置信息，包括編譯構(gòu)建配置項(xiàng)。
• hvigorfile.ts文件是模塊級(jí)構(gòu)建腳本。
• oh-package.json5是模塊級(jí)依賴配置信息文件。

進(jìn)入src>main>ets目錄中，其分為entryability、pages兩個(gè)文件夾。

• entryability存放ability文件，用于當(dāng)前ability應(yīng)用邏輯和生命周期管理。
• pages存放UI界面相關(guān)代碼文件，初始會(huì)生成一個(gè)Index頁面。

5.3?AppScope>app.json5是應(yīng)用的全局的配置文件，用于存放應(yīng)用公共的配置信息。

• bundleName是包名。
• vendor是應(yīng)用程序供應(yīng)商。
• versionCode是用于區(qū)分應(yīng)用版本。
• versionName是版本號(hào)。
• icon對(duì)應(yīng)于應(yīng)用的顯示圖標(biāo)。
• label是應(yīng)用名。

5.4?src/main/resources/base/profile/main_pages.json文件保存的是頁面page的路徑配置信息，所有需要進(jìn)行路由跳轉(zhuǎn)的page頁面都要在這里進(jìn)行配置。

六 編譯問題

6.1?如果工程中配置的releaseType字段與設(shè)備（模擬器和真機(jī)）鏡像版本不匹配，則運(yùn)行時(shí)會(huì)報(bào)INSTALL_PARSE_FAILED_USESDK_ERROR錯(cuò)誤，如下圖所示。

6.2 解決措施：

在設(shè)備中運(yùn)行應(yīng)用/服務(wù)時(shí)，build.gradle（API4-7）或build-profile.json5（API8及以上版本）文件中的compileSdkVersion和compatibleSdkVersion，以及SDK Stage（Beta或Release）需要與設(shè)備的apiVersion、releaseType相互匹配才能正常運(yùn)行。具體的修改方法如下

6.3，在HarmonyOS SDK存儲(chǔ)目錄下的Sdk\hmscore\{版本號(hào)}\toolchains文件下打開CMD命令行工具，執(zhí)行如下命令進(jìn)行查詢真機(jī)設(shè)備的apiVersion和releaseType取值。

在手機(jī)/平板HarmonyOS 3.1 Release設(shè)備上：

hdc -c shell 
getprop persist.sys.ohc.apiversion
getprop persist.sys.ohc.releasetype

在手機(jī)/平板HarmonyOS 3.1 Release之前版本的設(shè)備上：

hdc -c shell
getprop hw_sc.build.os.apiversion
getprop hw_sc.build.os.releasetype

如下?

打開模塊的build.gradle（API4-7）或打開工程的build-profile.json5（API8-9）文件，查看compileSdkVersion、compatibleSdkVersion。

在模塊的build.gradle（API4-7）文件中查看compileSdkVersion、compatibleSdkVersion

在工程的build-profile.json5（API8-9）文件查看compileSdkVersion、compatibleSdkVersion

6.4，點(diǎn)擊File?>?Settings?> SDKs > HarmonyOS，查看compileSdkVersion對(duì)應(yīng)的SDK stage。例如，下圖中API Version 7對(duì)應(yīng)的Stage為Release。

6.5，根據(jù)查詢的設(shè)備apiversion、releaseType，以及SDK Stage的取值，再查詢下表中的匹配關(guān)系，來修改compileSdkVersion和compatibleSdkVersion的值。其中compileSdkVersion需要修改工程和各模塊build.gradle中的取值；compatibleSdkVersion需要修改各模塊下的build.gradle中的取值。

apiVersion	releaseType	compileSdkVersion	SDK Stage	compatibleSdkVersion
4	Release	4	Release	4
4	Release	5	Release	4
5	Release	5	Release	4或5
5	Release	5	Release	4或5
5	Release	6	Release	4或5
5	Release	6	Release	4或5
6	Release	5	Release	4或5
6	Release	6	Release	4或5或6
6	Release	5	Release	4或5
6	Release	6	Release	4或5或6
7	Release	7	Release	4或5或6或7
7	Release	6	Release	4或5或6
8	Release	6	Release	4或5或6
8	Release	8	Release	8
9	Release	9	Release	9

6.6，當(dāng)前應(yīng)用版本和設(shè)備鏡像版本匹配后，如果仍然報(bào)該錯(cuò)誤，且設(shè)備鏡像版本已更新為3.1 Release版本，則說明當(dāng)前使用的DevEco Studio版本與設(shè)備運(yùn)行的鏡像版本不匹配，請(qǐng)升級(jí)DevEco Studio至3.1 Release版本，在新版本DevEco Studio上進(jìn)行運(yùn)行/調(diào)試。