OpenHarmony開發-連線開發板調試應用

在OpenHarmony 開發過程中,連接開發板進行應用調試是一個關鍵步驟,只有在真實的硬體環境下,我們才能測試出應用更多的潛在問題,以便後續進行最佳化。本文詳細介紹了連接開發板調試OpenHarmony 應用程式的操作步驟。

首先,我們建立了OpenHarmony的開發環境,安裝OpenHarmony SDK 和所需的驅動程式。接著,我們透過USB連接方式將開發板連接到開發機。在連線成功後,我們使用DevEco-Studio 部署和啟動應用程式。透過監控應用在開發板上的運作情況,我們可以利用日誌輸出進行問題診斷。 


一、建置OpenHarmony開發環境

前面我們已經介紹如何從零到一建立HarmonyOS應用開發環境,這裡只做簡單回顧,詳細流程參考我之前的文章: HarmonyOS應用開發-建立開發環境

1、安裝DevEco Studio

官網: HUAWEI DevEco Studio和SDK下載和升級| HarmonyOS開發者下載DevEco Studio 3.1.1 Release 最新版本。

下載完成後,點選安裝,依照大家自己的喜好選擇路徑安裝即可,需要2GB 的儲存空間。

記得勾選「產生捷徑」 和「新增到path環境變數」 。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

後面一直Next,直到安裝完成。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

安裝完需要對電腦重新啟動。 


2、安裝Node.js 和ohpm

首次運行DevEco Studio 會來到這個頁面。
HarmonyOS 應用程式開發需要我們的電腦上安裝Node.js 和ohpm (鴻蒙生態三方庫的套件管理工具)
這裡華為官方提供了鏡像,如果本機上之前沒有裝過,直接勾選install 然後下一步即可。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區


3.安裝HarmonyOS SDK

基礎元件安裝後,我們需要安裝HarmonyOS 的SDK。 HarmonyOS SDK 提供應用及服務開發所需的一系列系統開放能力,包括框架、Ability、分散式服務、安全性、方舟編譯器、HMS Core、基礎軟體服務、硬體服務等。

這裡選擇安裝路徑即可,我直接預設路徑,點選下一步。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

這個頁面展示了所有需要安裝的包,點擊下一步安裝。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

幾分鐘後安裝完成。


二、開發OpenHarmony應用

前面我們已經介紹瞭如何從零到一開發一款HarmonyOS應用,這裡只做簡單回顧,詳細流程參考我之前的文章: HarmonyOS應用開發-使用低程式碼快速開發一個應用程式

1.創建Stage模式應用

創建時,我們需要選擇模型,模型有兩種,一種是FA模型,一種是Stage模型。 API 8及以前的介面是基於FA模型提供;從API 9開始,OpenHarmony主推Stage模型。這裡我們使用Stage模式創建,勾選低程式碼開發模式。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

創建好之後,我們進入專案開發介面。


2、低程式碼開發應用

參考我之前文章的步驟,很快我們就可以用低程式碼做出一個簡單應用程式。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

程式碼完成後,我們可以使用DevEco Studio自備的模擬器進行偵錯。

新增模擬設備,然後點選啟動。 

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

模擬器調試效果如下:

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區HarmonyOS應用開發-建構開發環境-鴻蒙開發者社區

確保我們的HarmonyOS應用程式在模擬器中可以運行,後面就可以直接在開發板上部署了。


三、開發板安裝OpenHarmonyOS

先確認一下開發板是否已經預先安裝OpenHarmony系統,如果沒有,我們需要自行燒錄OpenHarmony系統到開發板。

前面我們已經介紹瞭如何從零到一燒錄OpenHarmony系統到開發板,這裡只做簡單回顧,詳細流程參考我之前的文章: OpenHarmony開發-燒錄OpenHarmony系統到開發板

本次我們示範所使用的開發板是鴻誠志遠HCPAD-100 ,是基於瑞芯微RK3568 設計的一款人工智慧開發板,其他開發板,例如 RK3568 或HiHope DAYU200 都是可以的。

1、準備工作

硬體準備:

  • RK3568開發板(或HCPAD-100開發板、HiHope DAYU200開發板等)
  • 雙USB埠線
  • 電源適配器等。

軟體準備:

  • 取得OpenHarmony的原始碼。
  • 準備RK3568的燒錄工具,例如RKDevTool。
  • 安裝並配置開發環境,例如確保有適合的編譯工具鏈。

2.下載RK驅動器和燒錄工具

下載RK驅動助手和AndroidTool燒錄工具。
地址: Firefly | 讓科技更簡單,讓生活更聰明(t-firefly.com )

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

下載完成後進行安裝。

① 安裝RK驅動助手

雙擊安裝程序,選擇驅動安裝,安裝完成後電腦連接開發板時才可辨識。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

② 安裝AndroidTool燒錄工具

選擇安裝路徑安裝,安裝完成後開啟如下,在沒有連接裝置時顯示No Devices Found。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區


3.下載HDC指令工具

HDC (OpenHarmony Device Connector) 是為開發人員提供的用於設備連接調試的命令列工具,PC 端開發機使用命令列工具hdc_std進行調試,該工具支援部署在Windows/Linux/Mac 等系統上與OpenHarmony 設備(或模擬器)進行連接調試通訊。

官方或社群連結下載均可,壓縮套件包含Windows 和Linux 兩個版本。

下載連結①:https: //repo.huaweicloud.com/harmonyos/os/3.2-Release/ohos-sdk-windows_linux-public.tar.gz

下載連結②:
developtools_hdc_standard : Device debug connector that provides the device connection capability and a command line tool | 設備調試連接器,提供了連接設備的能力,並提供了對外的命令列工具

下載連結③:
訪問:每日建置| OpenHarmony CI

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

下載後解壓縮,進入目錄ohos-sdk\windows,繼續解壓縮toolchains-windows 開頭的壓縮包。

在解壓縮後的toolchains-windows 開頭的資料夾\toolchains 目錄下,找到hdc.exe。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

配置環境變量,把hdc.exe 的路徑配置到path 裡。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

驗證下HDC 是否安裝成功,使用查看版本的指令

hdc -v
  • 1.

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

可以看到HDC 安裝成功了。


4.連接電腦和開發板

在開發板斷電情況下按住燒錄鍵,透過雙USB線連接電腦和開發板,再給開發板通電,此時開發板進入燒錄模式。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區


5.下載OpenHarmony鏡像

存取:每日建置| OpenHarmony CI

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區


6、燒錄OpenHarmony系統

在鏡像下載完成後,我們需要匯入鏡像配置到燒錄工具中。右鍵Loader 匯入配置,選擇解壓縮的鏡像包中的config.cfg 檔案。匯入新設定後,misc、sys-prod、chip-prod三個分割區不存在鏡像,燒寫時不能勾選。點選執行,出現下載完成,即表示燒錄成功。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

燒錄完成後,我們將板子斷電重插,板子開機進入OpenHarmony系統頁面。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

開機完成後,可以看到OpenHarmony 自帶的系統應用。 

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區OpenHarmony開發-系統燒錄-鴻蒙開發者社區

到此,OpenHarmony 系統燒錄到開發板的步驟完成。


四、連接開發板調試應用

1.下載OpenHarmony的SDK

DevEco-Studio 與OpenHarmony 系統聯調,需要下載OpenHarmony 的SDK。如果之前下載過的只需要導入路徑就可以,沒有下載過的可以在DevEco Studio 直接下載。

我們先開啟 DevEco Studio 的設定。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

為OpenHarmony-SDK 新增路徑,或直接下載OpenHarmony 的SDK。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

這裡我是沒安裝過,所以直接下載。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

大概兩分鐘,下載進度條走到頭,我們的OpenHarmony-SDK 就安裝完成了。


2、連​​接開發設備與開發板

我們為開發板接好電源,連接顯示器和滑鼠,然後USB連接我們的電腦。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

連線成功後,DevEco-Studio 上方可以看到我們的裝置名,如果線沒有插好,則還是顯示No Devices。


3、設定項目簽名 

我們需要為專案設定簽名,才可以和開發板進行聯調。

連接設備,上方出現設備名稱後(圖截早了,應該是顯示設備名稱),點選右上角項目結構按鈕。選擇簽名設置,進入簽名設定頁面。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

簽名設定裡勾選,自動產生簽名。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

如果沒有登入華為雲端開發者帳號,會提示我們需要先登入。 

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

點選登錄,會自動彈出瀏覽器,用華為帳號登入即可。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

登入完成,返回我們的DevEco Studio 用戶端。


4、啟動DevEco-Studio項目

點擊運行按鈕即可。

可以看到我們的開發板自動安裝並運行了剛剛開發的HarmonyOS 應用。

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

APP在首頁也有顯示。 

OpenHarmony開發-連結開發板調試應用-鴻蒙開發者社區

至此,我成功完成了OpenHarmony 環境的部署、應用的開發、開發板燒錄和生產設備聯調的過程,希望本文可以對大家開發中遇到的困難進行答疑解惑。