開篇第一句，所有學習與開發資料以官方資料為準。任何博客類只能作為參考，自行判斷優良，不要被誤導，包括本人的所有博客。

HarmonyOS 官方文檔地址

應用開發：

https://developer.harmonyos.com/cn/documentation

設備開發：

https://device.harmonyos.com/

OpenHarmony 官方文檔地址

如下：

https://gitee.com/openharmony/docs/

HarmonyOS 與 OpenHarmony 的區別

關于 HarmonyOS 與 OpenHarmony 的區別我這里不再過多闡述，請看開放原子基金會的官方介紹。

我這里著重從開發角度上講解它們的區別：

①開發語言支持

HarmonyOS 主要支持 Java 和 JS 來開發應用（當然還有 C 和 C++），而 OpenHarmony 不支持 Java 來開發應用。

目前階段 HarmonyOS 里面還是有部分功能是基于 AOSP 的，因此還是要用 Java，而 OpenHarmony 不再使用 Java，應該是想徹底放棄 AOSP 了。

②SDK 的不同

應用開發工具都是統一使用華為的 DevEco Studio，但是使用的 sdk 不同，開發前首先要切換 sdk 配置。

雖然 HarmonyOS 和 OpenHarmony 都可以用 js 來開發應用，但是它們的 api 還是有些細微的區別。

OpenHarmony 的 api 參考請參看 OpenHarmony 的官方文檔，千萬別看錯了。

然后 OpenHarmony 的 sdk 請下載官方的支持 OpenHarmony 開發的 sdk，而不是 DevEco studio 自帶的 HarmonyOS sdk。

關于 OpenHarmony sdk 配置請參考官方文檔，我這里僅僅附上官方鏈接：

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/配置OpenHarmony-SDK.md

③創建項目方式不同

在 DevEco 2.2 Beat1 版本之后，可以直接支持創建 OpenHarmony 應用項目了。

創建方式如下圖：

這里重點對 standard 解釋下，即 OpenHarmony 官方說的“標準系統”，本文中所說的所有 OpenHarmony 應用開發都是針對的標準系統。

輕量和小型系統（參考內存《128MB），標準系統（參考內存≥128MB），詳細說明請看官方文檔：

https://gitee.com/openharmony/docs/blob/master/zh-cn/readme.md

⑤運行調測方式不同

HarmonyOS 支持 previewer 預覽、模擬器運行、真機運行三種方式；OpenHarmony 支持 previewer 預覽、真機（目前主要使用 3516 系列開發板）運行。

首先，目前 OpenHarmony 是沒有模擬器的，真正運行調測只能借助開發板（主要采用 HI3516 系列開發板），注意目前是不支持手機平板等真機調測的。

⑥簽名方式不同

OpenHarmony 的簽名方式我這里就不贅述，直接附上官方文檔鏈接：

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/配置OpenHarmony應用簽名信息.md

HarmonyOS 的簽名我最想吐槽的就是需要添加設備 ID。OpenHarmony 的簽名我只想吐槽一句，既然 open 為何還必須要簽名。

埋坑

上面的區別對比已經埋了部分坑了，下面再針對純粹上層應用開發人員初次接觸 OpenHarmony 開發的坑。

①OpenHarmony 操作系統編譯

為何要編譯操作系統，如果你手上有現成的安裝好操作系統的開發板你，操作系統和 sdk 版本也對應。

比如我們是基于 OpenHarmony-SDK-2.0-Canary 版本，那你應該燒錄一個對應的操作系統版本。比如我手上是很久之前的一個 1.0 版本的 3516 開發板，顯然要升級。

操作系統編譯的完整資料依然請參考官網：

https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-standard.md

關于這里我強調幾點：

（1）使用 repo 進行代碼倉同步時，官方描述的操作命令如下：

repo sync -c

建議替換成：

repo sync -c -j8

這個后面的數字 8 根據自己的 cpu 核數進行設置，查看 cpu 核數的命令如下：

grep -c ‘processor’ /proc/cpuinfo

這樣配置之后，會大大加快你的同步速度，否則這個同步時間會非常漫長。

同步過程請使用無限制的公網網絡，比如某些公司訪問外網會有限制。然后就是網絡下載速度也會會直接關系到你的同步速度。

repo 中途同步失敗了（比如斷網或者異常關機），也不要過于緊張，可以根據 log 提示刪除某些同步異常的部分倉庫，然后繼續執行上面的同步命令即可。

（2）編譯環境安裝時，Linux 編譯服務器終端輸入不識別的命令時，提示“ImportError： No module named apt_pkg”。

解決辦法：執行如下命令重新安裝 python3-apt。

sudo apt-get remove python3-apt

sudo apt-get install python3-apt

（3）編譯構建時，我這里遇到一個大坑，就是電腦突然斷電了，然后再執行編譯的時候報大量錯誤，錯誤內容如下：

rm： cannot remove ‘XXXXX‘： Bad message

這種問題本來可以采用 fsck 的方式來修復文件系統，但是由于編譯過程中產生了大量的很小的臨時文件，所以修復起來太慢太不現實，干脆刪除了虛擬機重新加載之前保存的虛擬機鏡像，重新再來一次。

②操作系統燒錄

官方描述的是使用網口進行燒錄，官網地址如下：

https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-standard-burn.md

需要注意的點：本文檔針對的開發版是官方推薦的 AI_Camera_Hi3516DV300 開發套件。

（1）確保 USB 轉串口驅動能安裝上，即在 PC 的設備管理器上能識別到 COM 口。

首先安裝 USB-to-Serial Comm Port.exe 驅動，如果沒有識別請再安裝 CH341SER 驅動。

（2）網口燒錄注意事項：不支持無線，需要使用網線直連 PC，網卡是千兆網卡，最好選擇六類網線，這樣速度更快。

PC 端需要設置 ip 地址為 192.168.1.2/24，網關為 192.168.1.1，如下圖：

燒錄工具上網口的設置：

upload_net_server_ip：對應 PC 上網口設置的地址。

upload_net_client_mask：設置開發板的子網掩碼，對應 PC 上設置的子網掩碼，確保開發板和 PC 在一個網段。

upload_net_client_gw：和 PC 上設置的網關保持一致。

upload_net_client_ip：設置開發板的 IP 地址，例如 192.168.1.3，確保和 PC 在一個網段即可。

我沒有使用官方推薦的 DevEco Device Tool 進行燒錄，而是使用了我喜歡的 HiBurn 進行燒錄，但是基本配置相同，截圖如下：

點完燒寫按鈕之后，需要先下電再上電，上電之后就會自動進行燒寫了。網口燒錄時間比較慢，標準系統 2.2beta 版本燒錄估計要 20 分鐘。

（3）USB 燒錄（強烈推薦，最快的方式，一分鐘即可燒寫完畢），這種方式是我在配置過程中最卡我的一種方式。主要就是 USB 的驅動一直無法識別。

首先我們來看看正確識別驅動之后，設備管理器中的頁面，必須看到通用串行設備下識別了設備才行，如下圖：

（1）開發套件上面有兩個 typec 接口，屁股后面的那個才是 USB 口，前面的僅僅是供電口。

（2）安裝 HiUSBBurnDriver 驅動程序。

（3）Win10 操作系統需要修改注冊表。

a.創建一個“文本文檔.TXT”，文件后綴名修改為 .reg，如 usb.reg。

b.右鍵打開創建的 usb.reg，將如下腳本拷貝到該文件中，然后保存并關閉。

Windows Registry Editor Version 5.00 ［HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlusbflags12D1D0010100］“SkipBOSDescriptorQuery”=hex:01，00，00，00“osvc”=hex:00，00“IgnoreHWSerNum”=hex:01

c.雙擊執行 usb.reg 文件，自動修改注冊表文件信息。

（4）我 PC 依然遲遲無法識別 USB 驅動的時候，我在系統的 boot 里面（串口終端連接下，進入 uboot 之前，狂按回車進入 boot）輸入以下命令終于解決了無法識別驅動的問題。

usb device

（5）待識別了 USB 驅動之后燒錄需要注意的問題。

設置好燒錄鏡像之后，在下電在上電之前，請一直按住開發板上面的 update 按鈕（在開發板的串口旁邊），上電之后，待出現開始燒寫的打印之后再松開按鈕。

③OpenHarmony 安裝應用到開發板

此處依然貼出對應的官方文檔：

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/安裝運行OpenHarmony應用.md

這里使用的是 hdc_std.exe，而不是 HarmonyOS sdk 中的 hdc.exe。

hdc_std.exe 在哪里？它在 OpenHarmony sdk 的 toolchains 目錄下面，確保它和開發板上的版本一致，即確保 sdk 版本和開發板的操作系統版本匹配即可。

④自己編譯 OpenHarmony SDK

為了確保 sdk 和自己燒寫的操作系統版本一致，我們可以自己編譯 sdk。

編譯命令如下：

。/build.sh --product-name ohos-sdk --ccache

結果輸出：

out/ohos-arm64-release/packages/ohos-sdk/

耗時了好久終于寫完了，希望本文加上配上 OpenHarmony 官方的文檔能夠幫助更多的開發者快速投入 OpenHarmony 共建中。

責任編輯：haq