From e5444b2b4c865c026e961288e7ad836aba088aea Mon Sep 17 00:00:00 2001 From: zjxi Date: Thu, 11 Jul 2024 07:50:35 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20update=20ohos/docs/03=5Fenvironment/?= =?UTF-8?q?=E9=B8=BF=E8=92=99=E7=89=88Flutter=E7=8E=AF=E5=A2=83=E6=90=AD?= =?UTF-8?q?=E5=BB=BA=E6=8C=87=E5=AF=BC.md.=20=E5=A2=9E=E5=8A=A0=E6=A1=86?= =?UTF-8?q?=E6=9E=B6=E7=8E=AF=E5=A2=83=E9=85=8D=E7=BD=AE=E7=9A=84=E7=BB=86?= =?UTF-8?q?=E8=8A=82=E6=8F=8F=E8=BF=B0=EF=BC=8C=E5=AE=8C=E5=96=84=E5=85=88?= =?UTF-8?q?=E5=89=8D=E5=AD=98=E5=9C=A8=E7=9A=84=E9=85=8D=E7=BD=AE=E6=BC=8F?= =?UTF-8?q?=E6=B4=9E=EF=BC=8C=E9=81=BF=E5=85=8D=E9=9D=9E=E5=BF=85=E8=A6=81?= =?UTF-8?q?bug?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zjxi --- ...55\345\273\272\346\214\207\345\257\274.md" | 79 ++++++++++++------- 1 file changed, 51 insertions(+), 28 deletions(-) diff --git "a/ohos/docs/03_environment/\351\270\277\350\222\231\347\211\210Flutter\347\216\257\345\242\203\346\220\255\345\273\272\346\214\207\345\257\274.md" "b/ohos/docs/03_environment/\351\270\277\350\222\231\347\211\210Flutter\347\216\257\345\242\203\346\220\255\345\273\272\346\214\207\345\257\274.md" index 0f1d6bef..4bbb9fc1 100644 --- "a/ohos/docs/03_environment/\351\270\277\350\222\231\347\211\210Flutter\347\216\257\345\242\203\346\220\255\345\273\272\346\214\207\345\257\274.md" +++ "b/ohos/docs/03_environment/\351\270\277\350\222\231\347\211\210Flutter\347\216\257\345\242\203\346\220\255\345\273\272\346\214\207\345\257\274.md" @@ -2,7 +2,7 @@ ## 一、环境准备 -### 1.下载并安装鸿蒙最新开发套件 +### 1.下载并安装鸿蒙最新开发套件，及其依赖环境 #### 1.1 官方下载地址 鸿蒙开发套件官方下载地址：https://developer.harmonyos.com/deveco-developer-suite/enabling/kit @@ -36,14 +36,20 @@ 1 git clone https://gitee.com/openharmony-sig/flutter_flutter.git 2 git checkout -b dev origin/dev ``` -##### （4）下载FlutterEngine构建产物 - - Flutter工程构建依赖ohos_debug_unopt_arm64与 ohos_release_arm64，请在FlutterTools指令运行参数中添加：--local-engine=src/out/ - https://docs.qq.com/sheet/DUnljRVBYUWZKZEtF?tab=BB08J2 下载编译产物，engine路径指向需带上src/out目录。 解压后，存放到一个目录(engine本地路径必须需带上src/out目录)： - 如：/Users/lihui/Documents/flutter_engine/src/out +##### （4）下载FlutterEngine构建产物（非必选项） +* Flutter工程构建依赖ohos_debug_unopt_arm64与ohos_release_arm64 +* 请在FlutterTools指令运行参数中添加：```--local-engine=src/out/``` +* [下载编译产物](https://docs.qq.com/sheet/DUnljRVBYUWZKZEtF?tab=BB08J2)， +* engine路径指向需带上src/out目录; 解压后，存放到一个目录(engine本地路径必须需带上src/out目录)：如：/Users/lihui/Documents/flutter_engine/src/out ![](../media/03_1/img_4.png) +#### 1.3 鸿蒙开发环境的前置环境依赖 +* 由于鸿蒙系统sdk存在java环境依赖，在[oracle官网](https://www.oracle.com/cn/java/technologies/downloads/#java17)或openjdk官网下载jdk 17环境，并进行相应配置 +* 执行如下命令，检查JDK安装结果，安装成功后进行后续操作 +```sh +java -version +``` ### 2.安装说明 @@ -56,18 +62,33 @@ ![](../media/03_1/img_02.png) #### 2.3 环境变量配置 - +* 首先，利用终端工具确定不同系统的真实环境变量存储路径，执行如下命令 +```sh +echo $SHELL ``` -vim .bash_profile - +* 若上述命令输出结果为```/bin/bash```，则执行以下命令，打开.bash_profile文件。 +```sh +vi ~/.bash_profile +``` +* 若上述命令输出结果为```/bin/zsh```，则执行以下命令，打开.zshrc文件。 +```sh +vi ~/.zshrc +``` +* 确定了环境变量存储文件后，进行相关环境变量配置（例如，打开bash_profile文件，执行```vi ～/.bash_profile```命令） +```sh # 打开bash_profile处理环境变量 - -export HOS_SDK_HOME=/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/sdk/M1SDK +export DEVECO_SDK_HOME=/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/sdk/M1SDK export HDC_HOME=/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/sdk/M1SDK/HarmonyOS-NEXT-DP2/base/toolchains export PATH=$PATH:$HDC_HOME export PATH=$PATH:/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/commandline/command-line-tools/bin +# harmonyos sdk环境配置 +export PATH=$PATH:/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/commandline/command-line-tools/sdk +export PATH=$PATH:/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/commandline/command-line-tools/ohpm/bin +export PATH=$PATH:/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/commandline/command-line-tools/hvigor/bin +export PATH=$PATH:/Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700/commandline/command-line-tools/tool/node/bin + # flutter_flutter export PATH=/Users/lihui/flutter/flutter_flutter/bin:$PATH @@ -75,13 +96,17 @@ export PATH=/Users/lihui/flutter/flutter_flutter/bin:$PATH export PUB_HOSTED_URL=https://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn -export NODE_HOME=/Users/lihui/node/node-18.14.1 -export PATH=$PATH:$NODE_HOME/bin +# 可选配置项（防止由于flutter鸿蒙版的git下载地址环境变量不匹配，影响后续的flutter项目创建） +export FLUTTER_GIT_URL=https://gitee.com/openharmony-sig/flutter_flutter.git -配置生效： +# 非必选配置项（若command-line-tools目录下的tool文件里存在node环境，则无需配置，若无则可进行如下单独配置） +# export NODE_HOME=/Users/lihui/node/node-18.14.1 +# export PATH=$PATH:$NODE_HOME/bin +``` +* 全部所需环境变量配置完成后，执行如下命令刷新环境配置，使其生效 +```sh source ~/.bash_profile ``` - #### 2.4 DevEcoStudio与模拟器安装完后的目录 ``` /Users/lihui/flutter/software/devecostudio-mac-arm-4.1.3.700 @@ -125,14 +150,14 @@ deveco-studio-4.1.3.700-aarch64 ## 二、集成与调试鸿蒙版Flutter ### 1.检查环境 -运行 flutter doctor -v 检查环境变量配置是否正确，Futter与OpenHarmony应都为ok标识，若两处提示缺少环境，按提示补上相应环境即可。 +运行```flutter doctor -v```检查环境变量配置是否正确，Futter与OpenHarmony应都为ok标识，若两处提示缺少环境，按提示补上相应环境即可。 ![](../media/03_1/doctor1.png) ### 2.创建Flutter工程 创建工程与编译命令，编译产物在${projectName}/ohos/entry/build/default/outputs/default/entry-default-signed.hap下 -``` +```sh # 创建工程 方式一 该方式只创建了ohos平台 flutter create --platforms ohos @@ -140,26 +165,24 @@ flutter create --platforms ohos flutter create # 进入工程根目录编译hap包 -flutter build hap --local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64 --debug +flutter build hap [--local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64] --debug ``` ### 3.鸿蒙真机运行Flutter项目 - 通过flutter devices指令发现真机设备之后，获取device-id +* 通过```flutter devices```指令发现真机设备之后，获取device-id - 方式一：进入项目目录指定构建方式编译hap包并安装到鸿蒙手机中 -``` - flutter run --debug --local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64 -d +方式一：进入项目目录指定构建方式编译hap包并安装到鸿蒙手机中 +```sh + flutter run --debug [--local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64] -d ``` - 方式二：进入工程根目录编译hap包,然后安装到鸿蒙手机中 - ``` - flutter build hap --local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64 --debug - +方式二：进入工程根目录编译hap包,然后安装到鸿蒙手机中 +```sh + flutter build hap [--local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64] --debug hdc -t install ``` 方式三：使用DevEcoStudio 选择设备为真机，点击启动 - ![](../media/03_1/img12.png) ### 4.模拟器运行Flutter项目 @@ -206,4 +229,4 @@ flutter build hap --local-engine=/Users/lihui/Documents/flutter_engine/src/out/o -HarmonyOS-NEXT-DP2/ -licenses/ -``` +``` \ No newline at end of file -- Gitee