快捷導(dǎo)航

鴻蒙開發(fā)搭建flutter適配的開發(fā)環(huán)境

更新時(shí)間：2024年12月28日 10:49:25 作者：hairuizhi

文章詳細(xì)介紹了在Windows系統(tǒng)上如何創(chuàng)建和運(yùn)行鴻蒙Flutter項(xiàng)目,包括使用flutter?doctor檢測環(huán)境、創(chuàng)建項(xiàng)目、編譯HAP包以及在真機(jī)上運(yùn)行項(xiàng)目,打包鴻蒙Flutter應(yīng)用的測試包和正式包的方法,并介紹了常見問題的解決方法

環(huán)境搭建

1.安裝 DevEco Studio NEXT IDE

注意版本應(yīng)該是 Next，當(dāng)前最新的是 Beta3 .下載之前需要先登錄，后面的模擬器創(chuàng)建還要開發(fā)者驗(yàn)證、審核啥的，好在審核進(jìn)度還可以，我這邊提交申請(qǐng)后差不多兩個(gè)小時(shí)審核通過 .找到自己電腦系統(tǒng)匹配的版本下載，我的電腦是Window的就選擇Window版本下載 .安裝步驟比較簡單，一步步next直到完成即可，新版本的工具已經(jīng)集成node和ohpm等環(huán)境進(jìn)去了，不用單獨(dú)下載安裝了

2.安裝Git

如果要同時(shí)適配安卓,需要安裝Android Studio; 如果要適配ios,需要安裝Xcode

Mac 安裝(推薦) 環(huán)境變量配置

# Flutter Mirror
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

# HarmonyOS SDK
export TOOL_HOME=/Applications/DevEco-Studio.app/Contents/
export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin

Windows 安裝 配置用戶變量

FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
PUB_HOSTED_URL=https://pub.flutter-io.cn
DEVECO_SDK_HOME=C:\Program Files\Huawei\DevEco Studio\sdk

配置環(huán)境變量 編輯 PATH，添加以下路徑

C:\Program Files\Huawei\DevEco Studio\tools\ohpm\bin
C:\Program Files\Huawei\DevEco Studio\tools\hvigor\bin
C:\Program Files\Huawei\DevEco Studio\tools\node

管理多個(gè) Flutter 版本 如果在項(xiàng)目開發(fā)中，需要使用多個(gè) Flutter 版本，可以考慮使用 fvm 1.安裝 FVM 2.使用 fvm 官方 flutter 版本 fvm install 3.22.0 3.安裝自定義鴻蒙版本，進(jìn)入 fvm/version 目錄，通常位于用戶目錄下，如 ~/fvm/versions/3.22.0, 拷貝倉庫并重命名為 custom_x.y.z的名字 git clone -b dev https://gitee.com/openharmony-sig/flutter_flutter.git custom_3.7.12 4.在項(xiàng)目中使用單獨(dú)的 flutter sdk 版本, 在項(xiàng)目目錄中執(zhí)行： fvm use custom_3.7.12

創(chuàng)建運(yùn)行項(xiàng)目

1.檢測flutter

創(chuàng)建鴻蒙運(yùn)用條件是否可以了運(yùn)行flutter doctor -v檢查環(huán)境變量配置是否正確

[?] HarmonyOS toolchain - develop for HarmonyOS devices
    ? OpenHarmony Sdk at E:\ohos\DevEcoStudio\sdk, available api versions has [12:default]
    ? Ohpm version 5.0.8-rc.1    #如果這里報(bào)x錯(cuò)誤，說明上面的`PATH變量添加值 %TOOL_HOME%\tools\ohpm\bin`添加的環(huán)境變量ohpm的路徑配置有問題
    ? Node version v18.20.1      #如果這里報(bào)x錯(cuò)誤，類似PATH配置的node路徑有問題
    ? Hvigorw binary at E:\ohos\DevEcoStudio\tools\hvigor\bin\hvigorw   #如果這里報(bào)x錯(cuò)誤，類似PATH配置的hvigor路徑有問題

2. 創(chuàng)建flutter項(xiàng)目

創(chuàng)建工程方式一該方式只創(chuàng)建了ohos平臺(tái) flutter create --platforms ohos 進(jìn)入工程根目錄編譯hap包，創(chuàng)建完項(xiàng)目之后，要先執(zhí)行這步build才能生成依賴，如果直接使用DevEcho Studio打開會(huì)報(bào)錯(cuò)找不到flutter.har依賴庫flutter build hap --debug

3. 運(yùn)行flutter項(xiàng)目到鴻蒙next手機(jī)

方式一：通過flutter devices指令發(fā)現(xiàn)真機(jī)設(shè)備之后，獲取device-id，進(jìn)入項(xiàng)目目錄指定構(gòu)建方式編譯hap包并安裝到鴻蒙手機(jī)中 flutter run --debug -d

flutter devices
  flutter run --debug -d <deviceId>

方式二：進(jìn)入工程根目錄編譯hap包,然后安裝到鴻蒙手機(jī)中

flutter build hap --debug
  hdc -t <deviceId> install <hap file path>    # 類似Android的adb安裝：adb -s <deviceId> install <apk file path>

方式三：使用DevEcoStudio打開項(xiàng)目的ohos模塊

File --> Project Structure --> Signing Configs --> 勾選Automatically generate signature --> Apply ,可以啟用啟動(dòng)簽名，第一次執(zhí)行flutter build hap的時(shí)候也會(huì)提示到
創(chuàng)建模擬器：Device Manager --> 進(jìn)去根據(jù)提示可以插件模擬器，不過第一次創(chuàng)建還需要進(jìn)行開發(fā)者驗(yàn)證以及審核。。。
重點(diǎn)提示一下：創(chuàng)建的模擬器只有x86架構(gòu)的，而這篇文章我們通過flutter_flutter構(gòu)建的支持鴻蒙的flutter運(yùn)用只支持arm64架構(gòu)的，人家文檔也說明了，所以啊其實(shí)創(chuàng)建模擬器對(duì)flutter應(yīng)用也沒啥用，#要真機(jī)運(yùn)行

打包項(xiàng)目

1. 打包測試包

flutter build hap --debug

如果需要指定engine的話，使用--local-engine參數(shù) 使用flutter build hap --debug --local-engine=E:\ohos\flutter_image\src\out\ohos_debug_unopt_arm64，會(huì)提示失敗src\out\ohos_debug_unopt_arm64\flutter.har找不到如果提示flutter.har找不到，那就是從項(xiàng)目目錄下的ohos\har\flutter.har拷貝一份到src\out\ohos_debug_unopt_arm64目錄下，然后再執(zhí)行上一步就能成功

2. 打包正式包

flutter build hap --release 或者 flutter build hap

如果需要指定engine的話，使用--local-engine參數(shù) 比如flutter build hap --release --local-engine=E:\ohos\flutter_image\src\out\ohos_release_arm64，會(huì)提示失敗src\out\ohos_release_arm64\flutter.har找不到如果提示flutter.har找不到，那就是從項(xiàng)目目錄下的ohos\har\flutter.har拷貝一份到src\out\ohos_release_arm64目錄下，然后再執(zhí)行上一步就能成功

常見問題

運(yùn)行 flutter doctor 出現(xiàn) Error: Unable to find git in your PATH. 執(zhí)行以下命令

git config --global --add safe.directory '*'

總結(jié)

到此這篇關(guān)于鴻蒙開發(fā)搭建flutter適配的開發(fā)環(huán)境的文章就介紹到這了,更多相關(guān)鴻蒙搭建flutter開發(fā)環(huán)境內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: