隨著鴻蒙系統的不斷完善,許多應用廠商都希望將自己的應用移植到鴻蒙平臺上。最近,Taro 釋出了 v4.0.0-beta.x 版本,支援使用 Taro 快速開發鴻蒙原生應用,也可將現有的小程式轉換為鴻蒙原生應用。
在 《使用 Taro 開發鴻蒙原生應用》 系列文章中,我們已經介紹了 鴻蒙的基本概念 和 Taro 適配鴻蒙的原理。本文作為該系列的第三篇,將正式為開發者提供一份完整的鴻蒙應用開發指南,幫助大家使用 Taro 開發自己的第一個鴻蒙應用。
一、環境配置
首先要準備鴻蒙執行所需的環境,根據參考文件提示的步驟在 HUAWEI DevEco Studio 的 IDE 中完成 MyApplication 專案的建立,熟悉鴻蒙開發者工具的預覽檢視等功能。
步驟 1:安裝、配置 DevEco Studio
1.登入 HarmonysOS 應用開發門戶,點選右上角註冊按鈕,註冊開發者帳號;
2.進入 HUAWEI DevEco Studio 套件貨架中心,申請白名單,由於目前最新版本的 OpenHarmony SDK 和 IDE 仍未對外開發,因此個人開發者若想嚐鮮,需要先申請白名單成為合作伙伴後才能繼續進行下面的步驟;
3.白名單申請透過後,進入貨架,下載 IDE 版本為 DevEco Studio 4.0.3.700 的 DevEcoStudio4.0-API10 開發套件;
4.下載完成後,開啟 IDE 安裝包進行安裝,安裝成功後啟動 DevEco Studio,根據 引導 解壓套件裡附帶的 SDK 壓縮包,並根據引導在 IDE 中配置好 SDK 的使用路徑;
5.SDK 配置成功後,看到設定皮膚中各個 SDK 的版本號與下面的圖片中相同,則標識配置成功了。
步驟 2:建立 Harmony 主專案
1.建立新專案,選擇需要開發的裝置,然後 Mode 選擇 Stage 模型,Compile SDK 選擇 4.0.0(API 10),按照引導操作後一個新的專案就被建立出來了;
2.關注目錄 entry/src/main/ets/pages/Index.ets
下面的檔案,熟悉檔案結構。pages
目錄下為頁面入口,新建專案的頁面目錄會包含若干個 .ets 檔案,應用級配置資訊位於 build-profile.json5
,當前的模組資訊 、編譯資訊配置項位於 entry/build-profile.json5
。專案結構詳情;
3.建立好專案後,根據 配置外掛指引,將下載的套件附帶的外掛配置在專案配置中。
步驟 3:預覽 & 除錯
DevEco Studio 目前只支援在華為提供的測試真機上進行預覽與除錯,模擬器除錯將在不久後支援。
1. 預覽:
使用者真機與電腦相連,開啟開發者模式,即可在真機看到效果。這裡需要注意的是,真機需要使用華為側提供的測試機,測試機中會安裝純鴻蒙的系統映象,能夠體驗到完整的鴻蒙系統功能,純鴻蒙應用目前還不能完美地在 HarmonyOS 4.0 的商用機側跑起來。
2. 除錯:
連結上真機後,選擇好對應的入口模組,在專案程式碼中打上斷點等資訊,在編譯器中啟動除錯即可。
二、Taro 開發流程
步驟 1:安裝 Taro v4.0.0-beta.x
1. 安裝 CLI
安裝 v4.0.0-beta.x
版本的 Taro CLI:
npm i 2. 安裝專案依賴
如您是新專案,建立專案時推薦建立編譯器為 vite 的模板,若建立專案選擇了 webpack 或 webpack5 的模板,則需要手動安裝 vite、terser 以及 @tarojs/vite-runner。
$ npm i vite@舊專案需要把 package.json
檔案中 Taro 相關依賴的版本修改為 ~4.0.0-beta.0,再重新安裝依賴,並新增上述三個和 vite 相關的依賴。
如果安裝失敗或開啟專案失敗,可以刪除 node_modules、yarn.lock、package-lock.json 後重新安裝依賴再嘗試。
步驟 2:安裝 Taro 適配鴻蒙外掛
$ npm i @tarojs步驟 3:修改 Taro 編譯配置
config/index.ts
config 步驟 4:修改鴻蒙主專案的許可權配置
根據專案需要在鴻蒙主專案 entry/src/main/module.json5
中所需要使用到的機器許可權。
{
//...
"requestPermissions"步驟 5:編譯執行
在 package.json
裡新增以下的 scripts 命令,執行命令,Taro 可將打包結果生成到配置的鴻蒙主專案路徑中。
"scripts"步驟 6:預覽 & 除錯
開發者可根據上面執行鴻蒙 demo 專案的方式進行預覽與除錯。
三、注意事項
1. 樣式
佈局
鴻蒙沒有實現盒子模型,因此目前在實現上是使用鴻蒙的 Flex 和 Column 實現的。
尺寸單位
目前 Taro 轉鴻蒙支援使用 px、vw、vh 作為資料的單位,諸如 rem、em 等單位則暫時不支援。
2. 除錯
真機除錯
當前,真機除錯需要使用華為側提供的測試機,測試機中會安裝純鴻蒙的系統映象,能夠體驗到完整的鴻蒙系統功能,純鴻蒙應用目前還不能完美地在 HarmonyOS 4.0 的商用機側跑起來。
SDK 版本問題
由於鴻蒙側迭代 SDK 的速度較快,目前 Taro 適配的 SDK 版本為最新的 API 10 版本,對於 API 版本為 9 的鴻蒙專案可能會存在元件和 API 的不相容和不支援。
3. 與小程式的差異
當下,雖然 Taro 適配鴻蒙 ArkTS 的工作已經基本完成,但在適配過程中,我們也發現了一些暫時無法解決或者計劃後續解決的遺留問題。
元件和 API
由於鴻蒙平臺和小程式平臺本身就存在著較大的差異,因此一些小程式的元件和 API 規範,在鴻蒙平臺會沒有辦法重新實現,如與登入和賬號資訊相關的 API 以及 live-player 等和直播相關的元件。
樣式解析存在一定的限制
由於在 ArkTS 中,會使用宣告式 UI 來對 UI 的樣式進行描述,因此不存在 sass 和 css 等樣式檔案,因此 Taro 在適配鴻蒙 ArkTS 時,會在編譯時去解析這些樣式檔案。並將這些樣式以內聯的方式寫入到元件的 TS/JS 程式碼中。
正常的樣式基於 W3C 規範,存在著類名級聯和樣式繼承的行為,由於開發者在程式碼中的寫法各異,Taro 沒有辦法在編譯時獲取準確的節點結構以及節點類名資訊,因此無法支援這兩種行為。
另外,由於樣式的解析是基於元件檔案的緯度的,因此樣式檔案只能應用於被其引用的元件檔案中,而不能跨檔案應用,並且樣式檔案也只支援類選擇器。
四、總結
本指南詳細介紹了鴻蒙執行環境的配置、使用 Taro 開發鴻蒙應用的步驟和注意事項。我們希望,開發者們透過本指南,可以快速上手並高效開發自己的鴻蒙應用,順利的進入到鴻蒙應用開發的新領域。
讓我們一起開啟鴻蒙應用開發的新篇章吧!
作者:京東零售 利齊諾
來源:京東雲開發者社群 轉載請註明來源