一、設備開發(fā)介紹

1. 環(huán)境搭建與源碼獲取

• 環(huán)境搭建

搭建OpenHarmony 的系統(tǒng)環(huán)境，需要Windows系統(tǒng)與Ubuntu系統(tǒng)結(jié)合使用。

? Windows系統(tǒng)負責燒錄、測試、與OpenHarmony在windows系統(tǒng)cmd模式下交互。

? Ubuntu系統(tǒng)負責源碼管理、閱讀、開發(fā)、編譯。Ubuntu系統(tǒng)，通過在Windows系統(tǒng)安裝虛擬機，配置初始化虛擬機（內(nèi)存推薦16GB及以上、CPU推薦4核及以上），虛擬機運行安裝Ubuntu系統(tǒng)。

• 源碼獲取

Ubuntu環(huán)境下，更新軟件源命令sudo apt-get update。通過sudo apt_get install git git-lfs，安裝git客戶端與git-lfs，命令 git --version 查看git是否成功。 配置git客戶端 。

安裝碼云repo工具，通過mkdir命令，在固定目錄下創(chuàng)建存放repo的文件目錄。通過命令 curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o 目錄，獲取到repo工具。安裝配置完成之后，通過一下命令步驟進行OpenHarmony源碼獲取 。

2. HarmonyOS源碼編譯

• 編譯環(huán)境搭建

Ubuntu環(huán)境下，編譯OpenHarmony源碼之前，必須進行編譯環(huán)境搭建。通過apt_get和pip3 install命令安裝配置編譯環(huán)境。通過 apt-get update -y 更新軟件源。更新成功之后，通過apt-get命令進行OpenHarmony源碼編譯之前安裝配置。

• 編譯命令

成功配置編譯環(huán)境，Ubuntu環(huán)境下，打開CMD命令行窗口，通過cd命令進入HarmonyOS目錄下，目錄結(jié)構(gòu)如下。

OpenHarmony源碼根目錄下，通過執(zhí)行命令 bash build/prebuilts_download.sh 腳本進行預編譯，安裝編譯器及二進制工具，成功提示。

接著執(zhí)行命令 ./build.sh system_size=standard product_name=harmonyos 編譯OpenHarmony源碼。./build.sh 同時也支持其他多種參數(shù)。

--source-root-dir=SOURCE_ROOT_DIR                 # 指定路徑
--product-name=PRODUCT_NAME                       # 指定產(chǎn)品名
--device-name=DEVICE_NAME                         # 指定裝置名稱
--target-os=TARGET_OS                             # 指定操作系統(tǒng)
-T BUILD_TARGET, --build-target=BUILD_TARGET      # 指定編譯目標，可以指定多個

OpenHarmony源碼編譯成功，OpenHarmony源碼根目錄下 out/harmonyos/packages/phone/images， Ubuntu環(huán)境的終端顯示。

• 編譯出錯

編譯OpenHarmony源碼的過程中，可能出現(xiàn)各類問題。以下枚舉一些異常情況。

解決方法，通過執(zhí)行命令 sudo apt install openjdk-11.0.16 修復這個問題。

解決方法，通過執(zhí)行命令 sudo apt install libtinfo5 修復這個問題。

3. OpenHarmony燒錄簡介

Ubuntu環(huán)境下，編譯OpenHarmony源碼成功，OpenHarmony鏡像文件存放的路徑，OpenHarmony源碼存放路徑/out/harmony/packages/phone/images。Windows環(huán)境下使用燒錄工具瑞芯微開發(fā)工具 v2.84（RKDevTool.exe），燒錄OpenHarmony文件到開發(fā)版3568。

windows環(huán)境下，使用瑞芯微開發(fā)工具之前需要安裝瑞芯微驅(qū)動，打開瑞芯微開發(fā)工具，同時通電開發(fā)板，插入USB。燒錄工具會顯示發(fā)現(xiàn)一個MASKROM設備。開發(fā)板MASKROM模式無法成功燒錄系統(tǒng)。開發(fā)板需要進入LOADER模式才能成功燒錄OpenHarmony系統(tǒng)。如何進入LOADER模式？需要先通過一個牙簽按住3568開關(guān)，再進行通電，通電之后繼續(xù)按住3568開關(guān)。

燒錄工具頁面會顯示發(fā)現(xiàn)一個LOADER設備，放開按住3568的開關(guān)。

瑞芯微開發(fā)工具里面選擇編譯成功后生成的OpenHarmony鏡像，每一個鏡像文件順序都不能有任何的顛倒。一旦選擇鏡像文件出現(xiàn)顛倒，燒錄的時候很大概率會將3568開發(fā)板直接燒壞，導致3568開發(fā)板無法使用。正確選擇OpenHarmony鏡像文件，執(zhí)行3568開發(fā)板燒錄。燒錄工具會提示燒錄是否成功。

4. OpenHarmony測試用例

OpenHarmony為開發(fā)者提供了一套全面的自測試框架，開發(fā)者可根據(jù)測試需求開發(fā)相關(guān)測試用例。同時開發(fā)者也能開發(fā)單獨測試函數(shù)功能的可執(zhí)行程序。

window模塊功能，創(chuàng)建一個cpp文件，內(nèi)部編寫main函數(shù)。main函數(shù)編寫業(yè)務邏輯流程。測試用例在源碼路徑（foundation/windowmanager/snapshot）。

編寫B(tài)UILD.gn增加編譯配置。

cpp目錄上層目錄下，bundle.json文件增加需要編譯的模塊。

執(zhí)行如下命令

./build.sh system_size=standard product_name=harmonyos

生成 snapshot_display，存放目錄 out/harmonyos/window/window_manager。

在 snapshot_display 目錄下，執(zhí)行如下命令

hdc file send snapshot_display /system/bin

推送開發(fā)板 /system/bin目錄。

出現(xiàn)異常提示 [Fail]Error opening file: read-only file system, path:/system/bin/snapshot_display，權(quán)限不夠。執(zhí)行命令

hdc shell mount -o remount,rw /

解決權(quán)限問題。

設置執(zhí)行權(quán)限 ，執(zhí)行命令

hdc shell chmod a+x /system/bin/snapshot_display

執(zhí)行推送到開發(fā)板程序snapshot_display。

文件存放開發(fā)板的實際路徑

5. OpenHarmony源碼閱讀

推薦使用[DevEco Studio]項目管理工具管理OpenHarmony源碼，學習OpenHarmony項目工程的整體目錄結(jié)構(gòu)及進行代碼閱讀，其他項目管理工具請自行選擇適合的個人學習的工具。