自 HBuilderX 4.27
版本開始,uni-app 支持 Harmony Next
平臺的 App 開發,目前僅支持 Vue3 項目編譯到鴻蒙平臺。uni-app x 從 4.61+ 版本起支持純血鴻蒙,即 Harmony NEXT
,其組件、API、CSS 與 Android 和 iOS 基本拉齊。
開發與配置
- 開發工具 :需要下載 uni-app 開發工具 HBuilderX,建議 4.61+ 版本。同時下載鴻蒙開發工具 DevEco Studio,版本建議 5.0.11.100 及以上。若從 HBuilderX 運行工程到鴻蒙手機上,需在 HBuilderX settings.json 中配置 DevEco Studio 路徑。
- 項目創建與配置 :在 HBuilderX 中依次點擊文件 - 新建 - 項目,選擇 uni-app,輸入項目名,默認模版,點擊創建。首次創建項目是沒有 harmony-configs 這個目錄的,在編譯工程到鴻蒙手機上時會自動生成,該目錄是鴻蒙的配置文件,包括應用包名、運行權限、簽名等配置。
運行與調試
uni-app x 編譯到鴻蒙是 ArkTS 語言,在鴻蒙的 ide deveco 中沒有熱刷新,每次改動代碼,需要重新 build 包、簽名、安裝新包到手機。不過 uni-app x 在鴻蒙模擬器運行不受限制,HBuilderX 自身提供了運行、日志、debug、發行、調試證書申請等全套功能,開發者安裝 deveco 后,可以做到不啟動 deveco,在 HBuilderX 中完成所有開發。
發布與簽名
數字簽名證書的配置最終需要落在鴻蒙工程根目錄中的 build-profile.json5
文件中起作用。從 HBuilderX 4.61+ 開始支持以交互方式配置相關信息,這些信息在構建階段會被覆蓋填寫到鴻蒙工程的 build-profile.json5
文件中。也可以在 manifest.json
的編輯頁面中,點擊【鴻蒙 App 配置】里面的【配置調試證書】和【配置發布證書】按鈕,打開配置對話框進行配置。
優勢與意義
- 跨平臺優勢拓展 :uni-app 本身具備跨平臺特性,鴻蒙化后,開發者一套代碼就能同時適配安卓、iOS 和鴻蒙系統,進一步擴大了代碼復用范圍,減少了為不同系統重復開發的工作量,大大提高了開發效率。
- 快速進入鴻蒙生態 :借助 uni-app 鴻蒙化,開發者無需額外學習鴻蒙原生開發語言和框架,就能快速將應用拓展至鴻蒙生態,觸達更多用戶,為應用推廣和商業變現創造新機會。
- 充分利用鴻蒙系統特性 :uni-app x 在鴻蒙上編譯后產物是 arkTS,使用 arkUI 的原生渲染引擎,可獲取更高性能、更佳體驗,實現鴻蒙原生應用的高性能。