編譯易出錯(cuò)？應(yīng)用安裝難？Hi3516開發(fā)攻略來啦
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
Hi3516DV300因其可實(shí)現(xiàn)圖像采集、識(shí)別、雙屏顯示、雙向語音、紅外夜視等多種豐富功能，在開發(fā)者中廣受關(guān)注。然而，正是由于豐富的功能，不少開發(fā)者在Hi3516DV300開發(fā)板的組裝、編譯、應(yīng)用開發(fā)和安裝中或多或少會(huì)遭遇瓶頸。
那么Hi3516DV300開發(fā)板應(yīng)該如何組裝?如何獲取OpenHarmony L2源碼并進(jìn)行編譯和燒錄?應(yīng)用開發(fā)者又該如何基于Huawei DevEco Studio進(jìn)行應(yīng)用開發(fā)?這些開發(fā)者們關(guān)注的問題，我們將用一個(gè)完整指南為大家一一揭秘~
如果你是0基礎(chǔ)上手該開發(fā)板并進(jìn)行應(yīng)用開發(fā)的開發(fā)者，那就千萬不要錯(cuò)過本篇指南啦，我們將從環(huán)境搭建、代碼獲取、鏡像燒錄、應(yīng)用開發(fā)、應(yīng)用簽名和應(yīng)用安裝六個(gè)方面入手，幫助開發(fā)者快速搭建OpenHarmony L2 應(yīng)用開發(fā)調(diào)試環(huán)境。
一、環(huán)境搭建
為了后續(xù)更好的進(jìn)行系統(tǒng)燒錄和應(yīng)用開發(fā)，我們需要先搭建好開發(fā)環(huán)境，這其中包含材料準(zhǔn)備、硬件組裝、安裝USB串口驅(qū)動(dòng)和通過串口連接開發(fā)板。
1. 材料準(zhǔn)備
工欲善其事，必先利其器。為了后續(xù)更好進(jìn)行編譯燒錄和應(yīng)用開發(fā)，【材料準(zhǔn)備】環(huán)節(jié)我們以表格的形式為大家羅列所有需要的硬件和軟件工具，大家可以先行準(zhǔn)備和下載哦~
2. 硬件組裝
我們需要首先完成硬件(Hi3516DV300開發(fā)套件)組裝，具體如何組裝，直接上視頻，讓大家看得更清晰：
https://harmonyos.51cto.com/show/1053
最終安裝效果如圖：
注意：由于測(cè)試時(shí)L1屏幕默認(rèn)橫屏，而L2屏幕默認(rèn)為豎屏。進(jìn)行L2測(cè)試時(shí)需要調(diào)整整體設(shè)備右轉(zhuǎn)90度，建議開發(fā)者將底座部分放到安裝最后，調(diào)整到合適的角度后改為用點(diǎn)膠安裝，可參見下圖：
3. 安裝USB串口驅(qū)動(dòng)
硬件套裝組裝完畢后，我們需要識(shí)別開發(fā)板串口，便于后續(xù)通過串口連接開發(fā)板。
開發(fā)板接通電源線后，將USB串口線連接到電腦，并安裝USBtoSerial Comm Port驅(qū)動(dòng)。
正確安裝驅(qū)動(dòng)后，在系統(tǒng)設(shè)備管理器里可以獲取com端口號(hào)，例如：
注意：圖中的com端口號(hào)是計(jì)算機(jī)隨機(jī)分配的，每個(gè)開發(fā)板識(shí)別出來的com端口號(hào)并不一致。
4. 通過串口連接開發(fā)板
獲取端口號(hào)后，為開發(fā)板供電，在PC端安裝Xshell或MobaXterm并新建連接，這里我們以Xshell工具為例來說明：
(1)點(diǎn)擊“新建會(huì)話”，協(xié)議選擇"SERIAL"，即串行接口，如圖所示：
(2)左側(cè)目錄選“SERIAL”，在右側(cè)“Port ”中選擇開發(fā)板對(duì)應(yīng)的COM端口號(hào)(即上面獲取到的COM4)，“Baud Rate(波特率)”填寫115200，“Flow Control(流控制)”選擇None。
配置完后連接會(huì)話，我們就完成了通過串口連接開發(fā)板。到這里，我們已經(jīng)可以通過串口控制開發(fā)板，同時(shí)可以在電腦端獲取到開發(fā)板的運(yùn)行狀態(tài)，看到設(shè)備打印日志。
接下來我們來看看如何進(jìn)行代碼獲取。
二、代碼獲取
開發(fā)者可以通過兩種途徑獲取代碼：
- 源碼下載并編譯。如果需要對(duì)代碼進(jìn)行編譯，開發(fā)者可以在Gitee下載源碼并使用DevEco Device Tool進(jìn)行編譯;
- 二進(jìn)制代碼直接獲取。如果開發(fā)者僅僅是用于應(yīng)用調(diào)試，不需要進(jìn)行編譯，可以直接下載二進(jìn)制代碼使用;
下面我們將從這兩種途徑詳細(xì)講述代碼獲取流程。
1. 源碼下載并編譯
(1)下載代碼
我們可以在Gitee的OpenHarmony文檔倉庫獲取到最新代碼版本分支。
OpenHarmony文檔倉庫地址
https://gitee.com/openharmony/docs/tree/master
開發(fā)者可以通過以下兩種方式獲取最新版本OpenHarmony v2.2 Beta2：
方式一(推薦)：通過repo + ssh 下載
- repo init -u git@gitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-v2.2-Beta2 --no-repo-verify
- repo sync -c
- repo forall -c 'git lfs pull'
注意：需注冊(cè)公鑰，請(qǐng)參考碼云幫助中心：
https://gitee.com/help/articles/4191
方式二：通過repo + https 下載
- repo init -u https://gitee.com/openharmony/manifest.git -b refs/tags/OpenHarmony-v2.2-Beta2 --no-repo-verify
- repo sync -c
- repo forall -c 'git lfs pull'
(2)編譯代碼
Hi3516DV300的源碼可以在Ubuntu編譯環(huán)境下使用DevEco Device Tool實(shí)現(xiàn)一鍵編譯，開發(fā)者可以參考官網(wǎng)文檔，實(shí)現(xiàn)編譯。
Hi3516DV300開發(fā)板源碼編譯：
https://device.harmonyos.com/cn/docs/ide/user-guides/ide-hi3516dv300-compile-0000001146686054
同樣，開發(fā)者也可以參考下面內(nèi)容通過命令行方式完成代碼編譯：
2. 二進(jìn)制代碼獲取
如果僅需要進(jìn)行應(yīng)用調(diào)試，我們可以從Gitee每日構(gòu)建網(wǎng)站獲取最新下載鏈接。
網(wǎng)站地址：
http://ci.openharmony.cn/dailybuilds
開發(fā)者可以根據(jù)需求，選擇對(duì)應(yīng)的版本進(jìn)行下載。
三、鏡像燒錄
完成代碼獲取后，讓我們進(jìn)入鏡像燒錄環(huán)節(jié)。為了實(shí)現(xiàn)在Linux系統(tǒng)下一站式編譯燒錄，本次我們使用的燒錄工具是HiTool，我們將為大家介紹HiTool實(shí)現(xiàn)燒錄時(shí)的配置，以及燒錄方式的選擇。
1. 燒錄配置
打開HiTool工具，選擇“燒寫eMMC”頁簽，填寫配置。
(1)由于在解壓目錄里，已經(jīng)包含了xml配置文件，開發(fā)者需打開xml文件將其中的文件夾路徑替換為當(dāng)前文件所在的路徑。
(2)替換為當(dāng)前文件路徑后，在工具中點(diǎn)擊“瀏覽”選擇xml文件加載即可：
2. 不同燒錄方式實(shí)現(xiàn)
HiTool提供了三種燒錄方式，分別為串口、網(wǎng)口和USB口，這里我們整理了三種燒錄方式的區(qū)別：
建議大家優(yōu)先選用USB口燒錄，我們也將從USB口燒錄開始為大家介紹。
(1)USB口燒錄
USB口燒錄需要先安裝USB驅(qū)動(dòng)，所以我們就從驅(qū)動(dòng)安裝和HiTool燒錄兩方面講解。
驅(qū)動(dòng)安裝
這里我們選擇的驅(qū)動(dòng)工具為Zadig 2.5 。
① 安裝完畢后，點(diǎn)擊Options，點(diǎn)擊下面幾個(gè)選項(xiàng)查看具體的屬性：
②選擇Device中的Create New Device，新建設(shè)備：
③開發(fā)者需按圖片所示填寫以下三個(gè)字段，使開發(fā)板能夠正確識(shí)別，并點(diǎn)擊Install Driver安裝：
Unknown Device #1
Driver：libusbK(v3.0.7.0)
USB ID：12D1 D001
通過串口連接開發(fā)板，先不要插USBType C線，通電后顯示倒計(jì)時(shí)3秒內(nèi)按回車(或任意鍵)進(jìn)入fastboot，此時(shí)截圖如下：
輸入usb device命令并回車啟動(dòng)USB，如下圖：
此時(shí)在開發(fā)板背后插上USB TypeC線，在設(shè)備管理器中可以看到對(duì)應(yīng)的設(shè)備，說明驅(qū)動(dòng)安裝成功。
HiTool燒錄
在HiTool界面，按照上文完成xml配置文件后，界面如下：
在傳輸方式中選擇“USB口”，先拔掉USBType和電源線進(jìn)行斷電，按住update鍵(該鍵在串口線旁邊)不松手，在HiTool上點(diǎn)擊燒寫，接著快速插入U(xiǎn)SBType線，此時(shí)HiTool界面會(huì)提示串口燒寫，大概在幾分鐘即可完成。
注意：USB最好直插電腦，不要插擴(kuò)展塢，避免由于供電不足導(dǎo)致燒錄失敗。
下面我們簡單講一下如何使用網(wǎng)口和串口進(jìn)行燒錄。
(2)網(wǎng)口燒錄
如果使用網(wǎng)口，開發(fā)者需要使用網(wǎng)線進(jìn)行連接。在HiTool傳輸方式上選擇網(wǎng)口，在左側(cè)輸入相應(yīng)的IP。點(diǎn)擊燒寫，這個(gè)時(shí)候可能會(huì)提示重新加電，開發(fā)者只需要按電源線兩下即可。
(3)串口燒錄
串口燒錄使用的是USB串口線。在HiTool傳輸方式上選擇串口，同樣會(huì)提示重新加電，開發(fā)者按電源線兩下即可解決。但串口燒錄速度非常慢，不推薦開發(fā)者使用。
3. 系統(tǒng)啟動(dòng)
連接串口，在顯示倒計(jì)時(shí)3秒時(shí)按任意鍵進(jìn)入fastboot界面(如果沒趕上，可以reboot或者通過電源按鈕重啟)，接著使用下面的啟動(dòng)參數(shù)：
- setenv bootargs 'mem=640M console=ttyAMA0,115200 mmz=anonymous,0,0xA8000000,384M clk_ignore_unused androidboot.selinux=permissive skip_initramfs rootdelay=5 init=/init root=/dev/mmcblk0p5 rootfstype=ext4 rw blkdevparts=mmcblk0:1M(boot),15M(kernel),20M(updater),1M(misc),3307M(system),256M(vendor),-(userdata)'
- setenv bootcmd "mmc read 0x0 0x80000000 0x800 0x4800; bootm 0x80000000";
- save
- reset
完成上述操作后，屏幕將被點(diǎn)亮，系統(tǒng)會(huì)自動(dòng)啟動(dòng)進(jìn)入桌面。
到這里我們完成燒錄環(huán)節(jié)。下面我們來看看應(yīng)用的開發(fā)、應(yīng)用簽名與安裝。
四、應(yīng)用開發(fā)
我們將簡要介紹OpenHarmony應(yīng)用如何開發(fā)，詳細(xì)介紹請(qǐng)參考OpenHarmony Doc開發(fā)文檔。
- OpenHarmony Doc開發(fā)文檔
- https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/Readme-CN.md
下面操作建議使用DevEco Studio 2.2 Beta1及以上版本進(jìn)行。
1. 配置OpenHarmony SDK
(1)下載OpenHarmony SDK包并解壓，復(fù)制下方鏈接即可直接下載：
下載鏈接
https://mirror.iscas.ac.cn/OpenHarmony/sdk/OpenHarmony-SDK-2.0-Canary.7z
(2)在Settings > Appearance & Behavior > System Settings > HarmonyOS SDK界面，選擇剛才解壓的SDK目錄;
(3)進(jìn)入Sdk\js\2.2.0.0\buildtools\aceloader目錄，在該目錄下運(yùn)行命令行工具，分別執(zhí)行如下命令，直至安裝完成。
- npm cache clean -f
- npm install
2. 新建應(yīng)用
創(chuàng)建工程時(shí)選擇 “[Standard]Empty Ability(JS)” 模板進(jìn)行即可開發(fā)。
如果開發(fā)者是導(dǎo)入歷史應(yīng)用，需要注意在entry\build.gradle的ohos中增加**supportSystem “*standard*”**字段。如果應(yīng)用編譯遇到其它問題，可以新建一個(gè)空項(xiàng)目并比對(duì)一下build.gradle文件排除故障。
五、應(yīng)用簽名
由于在L2上安裝應(yīng)用時(shí)無法關(guān)閉簽名驗(yàn)證，因此開發(fā)者在安裝前需要對(duì)hap包進(jìn)行簽名。OpenHarmony應(yīng)用簽名步驟如下圖所示，詳細(xì)操作開發(fā)者可參考配置OpenHarmony應(yīng)用簽名信息，這里不再贅述。
配置OpenHarmony應(yīng)用簽名信息：
簽名配置完成后，我們可以在Deveco點(diǎn)擊菜單欄中的“BuildBuild Haps(s)/App(s)Build Hap(s)”完成應(yīng)用的編譯，生成hap包。
保持USB TypeC線連接情況下，我們可以通過手動(dòng)執(zhí)行命令行完成對(duì)已簽名的hap應(yīng)用的安裝。
六、應(yīng)用安裝
保持USB TypeC線連接情況下，我們可以通過手動(dòng)執(zhí)行命令行完成對(duì)已簽名應(yīng)用的安裝。
我們可以在SDK的toolchains中找到HDC鴻蒙設(shè)備連接器的“hdc_std”工具，也可以在Gitee上developtools_hdc_standard倉的prebuilt目錄獲取最新編譯的hdc_std。
下載鏈接
https://gitee.com/openharmony/developtools_hdc_standard/tree/master/prebuilt
通過“hdc_std”工具，開發(fā)者可完成應(yīng)用的發(fā)送、安裝、卸載和log抓取等常用功能，這里我們?yōu)榇蠹伊_列了一些具體常用命令：
當(dāng)應(yīng)用正常完成安裝操作后，屏幕上會(huì)顯示應(yīng)用圖標(biāo)，此時(shí)開發(fā)者就可以運(yùn)行自己的應(yīng)用啦。
至此我們已經(jīng)完成了Hi3516DV300 OpenHarmony L2 應(yīng)用開發(fā)調(diào)試環(huán)境的搭建，以上教程旨在幫助開發(fā)者學(xué)習(xí)如何快速搭建OpenHarmony L2 應(yīng)用開發(fā)調(diào)試環(huán)境，更多腦洞大開的業(yè)務(wù)場(chǎng)景，等待開發(fā)者們一一探索。歡迎更多開發(fā)者們加入我們，基于Hi3516DV300開發(fā)有趣的作品，說不定下一次我們分享的就是你的作品哦~
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
