從HarmonyOS過渡到OpenHarmony應(yīng)用開發(fā)指南&埋坑
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
開篇第一句,所有學(xué)習(xí)與開發(fā)資料以官方資料為準(zhǔn)。任何博客類只能作為參考,自行判斷優(yōu)良,不要被誤導(dǎo),包括本人的所有博客。
HarmonyOS官方文檔地址
應(yīng)用開發(fā):https://developer.harmonyos.com/cn/documentation
設(shè)備開發(fā):https://device.harmonyos.com/
OpenHarmony官方文檔地址
https://gitee.com/openharmony/docs/
HarmonyOS應(yīng)用開發(fā)&OpenHarmony應(yīng)用開發(fā)區(qū)別
關(guān)于HarmonyOS與OpenHarmony的區(qū)別我這里不再過多闡述,請看開放原子基金會的官方介紹。
我這里著重從開發(fā)角度上講解它們的區(qū)別:
1、開發(fā)語言支持
HarmonyOS主要支持java和js來開發(fā)應(yīng)用(當(dāng)然還有c和c++),而OpenHarmony不支持java來開發(fā)應(yīng)用。
目前階段HarmonyOS里面還是有部分功能是基于AOSP的,因此還是要用java,而OpenHarmony不再使用java,應(yīng)該是想徹底放棄AOSP了。
2、sdk的不同
應(yīng)用開發(fā)工具都是統(tǒng)一使用華為的DevEco Studio,但是使用的sdk不同,開發(fā)前首先要切換sdk配置。雖然HarmonyOS和OpenHarmony都可以用js來開發(fā)應(yīng)用,但是它們的api還是有些細(xì)微的區(qū)別,OpenHarmony的api參考請參看OpenHarmony的官方文檔,千萬別看錯了。然后OpenHarmony的sdk請下載官方的支持OpenHarmony開發(fā)的sdk,而不是DevEco studio自帶的HarmonyOS sdk。
關(guān)于OpenHarmony sdk配置請參考官方文檔,我這里僅僅附上官方鏈接
3、創(chuàng)建項目方式不同
在DevEco 2.2Beat1版本之后,可以直接支持創(chuàng)建OpenHarmony應(yīng)用項目了,創(chuàng)建方式如下:

這里重點對standard解釋下,即OpenHarmony官方說的“標(biāo)準(zhǔn)系統(tǒng)”,本文中所說的所有OpenHarmony應(yīng)用開發(fā)都是針對的標(biāo)準(zhǔn)系統(tǒng)。
輕量和小型系統(tǒng)(參考內(nèi)存<128MB)
標(biāo)準(zhǔn)系統(tǒng)(參考內(nèi)存≥128MB)
詳細(xì)說明請看官方文檔
https://gitee.com/openharmony/docs/blob/master/zh-cn/readme.md
4、工程目錄結(jié)構(gòu)不同
HarmonyOS JS項目結(jié)構(gòu):

OpenHarmony 項目結(jié)構(gòu):

5、運行調(diào)測方式不同
HarmonyOS支持previewer預(yù)覽、模擬器運行、真機運行三種方式,OpenHarmony支持previewer預(yù)覽、真機(目前主要使用3516系列開發(fā)板)運行。
首先,目前OpenHarmony是沒有模擬器的,真正運行調(diào)測只能借助開發(fā)板(主要采用HI3516系列開發(fā)板),注意目前是不支持手機平板等真機調(diào)測的。
6、簽名方式不同
OpenHarmony的簽名方式我這里就不贅述,直接附上官方文檔鏈接
HarmonyOS的簽名我最想吐槽的就是需要添加設(shè)備ID。OpenHarmony的簽名我只想吐槽一句,既然open為何還必須要簽名
埋坑
上面的區(qū)別對比已經(jīng)埋了部分坑了,下面再針對純粹上層應(yīng)用開發(fā)人員初次接觸OpenHarmony開發(fā)的坑。
1、OpenHarmony操作系統(tǒng)編譯
為何要編譯操作系統(tǒng),如果你手上有現(xiàn)成的安裝好操作系統(tǒng)的開發(fā)板你,操作系統(tǒng)和sdk版本也對應(yīng),比如我們是基于OpenHarmony-SDK-2.0-Canary版本,那你應(yīng)該燒錄一個對應(yīng)的操作系統(tǒng)版本。比如我手上是很久之前的一個1.0版本的3516開發(fā)板,顯然要升級。
操作系統(tǒng)編譯的完整資料依然請參考官網(wǎng):
https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-standard.md
關(guān)于這里我強調(diào)幾點:
(1)使用repo進行代碼倉同步時
官方描述的操作命令如下
- repo sync -c
建議替換成
- repo sync -c -j8
這個后面的數(shù)字8根據(jù)自己的cpu核數(shù)進行設(shè)置,查看cpu核數(shù)的命令如下
- grep -c 'processor' /proc/cpuinfo

這樣配置之后,會大大加快你的同步速度,否則這個同步時間會非常漫長
同步過程請使用無限制的公網(wǎng)網(wǎng)絡(luò),比如某些公司訪問外網(wǎng)會有限制。然后就是網(wǎng)絡(luò)下載速度也會會直接關(guān)系到你的同步速度。
repo中途同步失敗了(比如斷網(wǎng)或者異常關(guān)機),也不要過于緊張,可以根據(jù)log提示刪除某些同步異常的部分倉庫,然后繼續(xù)執(zhí)行上面的同步命令即可。
(2)編譯環(huán)境安裝時
Linux編譯服務(wù)器終端輸入不識別的命令時,提示"ImportError: No module named apt_pkg"
解決辦法:
執(zhí)行如下命令重新安裝python3-apt。
- sudo apt-get remove python3-apt
- sudo apt-get install python3-apt
(3)編譯構(gòu)建時
編譯構(gòu)建時,我這里遇到一個大坑,就是電腦突然斷電了,然后再執(zhí)行編譯的時候報大量錯誤,錯誤內(nèi)容如下
rm: cannot remove ‘XXXXX‘: Bad message,這種問題本來可以采用fsck 的方式來修復(fù)文件系統(tǒng),但是由于編譯過程中產(chǎn)生了大量的很小的臨時文件,所以修復(fù)起來太慢太不現(xiàn)實,干脆刪除了虛擬機重新加載之前保存的虛擬機鏡像,重新再來一次。
2、操作系統(tǒng)燒錄
官方描述的是使用網(wǎng)口進行燒錄,官網(wǎng)地址如下
需要注意的點:
本文檔針對的開發(fā)版是官方推薦的AI_Camera_Hi3516DV300開發(fā)套件。
(1)確保USB轉(zhuǎn)串口驅(qū)動能安裝上,即在PC的設(shè)備管理器上能識別到COM口
首先安裝USB-to-Serial Comm Port.exe驅(qū)動,如果沒有識別請再安裝CH341SER驅(qū)動。
(2)網(wǎng)口燒錄注意事項
不支持無線,需要使用網(wǎng)線直連PC,網(wǎng)卡是千兆網(wǎng)卡,最好選擇六類網(wǎng)線,這樣速度更快。
PC端需要設(shè)置ip地址為192.168.1.2/24,網(wǎng)關(guān)為192.168.1.1,如下圖

燒錄工具上網(wǎng)口的設(shè)置:
- upload_net_server_ip:對應(yīng)PC上網(wǎng)口設(shè)置的地址
- upload_net_client_mask:設(shè)置開發(fā)板的子網(wǎng)掩碼,對應(yīng)PC上設(shè)置的子網(wǎng)掩碼,確保開發(fā)板和pc在一個網(wǎng)段。
- upload_net_client_gw:和PC上設(shè)置的網(wǎng)關(guān)保持一致。
- upload_net_client_ip:設(shè)置開發(fā)板的IP地址,例如192.168.1.3,確保和PC在一個網(wǎng)段即可。
我沒有使用官方推薦的DevEco Device Tool進行燒錄,而是使用了我喜歡的HiBurn進行燒錄,但是基本配置相同,截圖如下

點完燒寫按鈕之后,需要先下電再上電,上電之后就會自動進行燒寫了。
網(wǎng)口燒錄時間比較慢,標(biāo)準(zhǔn)系統(tǒng)2.2beta版本燒錄估計要20分鐘。
(3)USB燒錄(強烈推薦,最快的方式,一分鐘即可燒寫完畢)
這種方式是我在配置過程中最卡我的一種方式。主要就是USB的驅(qū)動一直無法識別。首先我們來看看正確識別驅(qū)動之后,設(shè)備管理器中的頁面,必須看到通用串行設(shè)備下識別了設(shè)備才行,如下圖

(1)開發(fā)套件上面有兩個typec接口,屁股后面的那個才是USB口,前面的僅僅是供電口。
(2)安裝HiUSBBurnDriver驅(qū)動程序
(3)win10操作系統(tǒng)需要修改注冊表
a.創(chuàng)建一個“文本文檔.TXT”,文件后綴名修改為.reg,如usb.reg。
b.右鍵打開創(chuàng)建的usb.reg,將如下腳本拷貝到該文件中,然后保存并關(guān)閉。
- Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\12D1D0010100]"SkipBOSDescriptorQuery"=hex:01,00,00,00"osvc"=hex:00,00"IgnoreHWSerNum"=hex:01
c.雙擊執(zhí)行usb.reg文件,自動修改注冊表文件信息
(4)我PC依然遲遲無法識別USB驅(qū)動的時候,我在系統(tǒng)的boot里面(串口終端連接下,進入uboot之前,狂按回車進入boot)輸入以下命令終于解決了無法識別驅(qū)動的問題
- usb device
(5)待識別了USB驅(qū)動之后燒錄需要注意的問題
設(shè)置好燒錄鏡像之后,在下電在上電之前,請一直按住開發(fā)板上面的update按鈕(在開發(fā)板的串口旁邊),上電之后,待出現(xiàn)開始燒寫的打印之后再松開按鈕。
3、OpenHarmony安裝應(yīng)用到開發(fā)板
此處依然貼出對應(yīng)的官方文檔
(1)這里使用的是hdc_std.exe,而不是HarmonyOS sdk中的hdc.exe;
(2)hdc_std.exe在哪里?
它在OpenHarmony sdk的toolchains目錄下面,確保它和開發(fā)板上的版本一致,即確保sdk版本和開發(fā)板的操作系統(tǒng)版本匹配即可。
4、自己編譯OpenHarmony SDK
為了確保sdk和自己燒寫的操作系統(tǒng)版本一致,我們可以自己編譯sdk。
編譯命令如下:
- ./build.sh --product-name ohos-sdk --ccache
結(jié)果輸出:
- out/ohos-arm64-release/packages/ohos-sdk/
耗時了好久終于寫完了,希望本文加上配上OpenHarmony官方的文檔能夠幫助更多的開發(fā)者快速投入OpenHarmony共建中。
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)