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 0f1d6befed679974f96c610a5efc79e743c9aa47..5bdf41e7783278a6fd675d0492fbb1ff7931f489 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 @@ -38,12 +38,18 @@ ``` ##### （4）下载FlutterEngine构建产物 - Flutter工程构建依赖ohos_debug_unopt_arm64与 ohos_release_arm64，请在FlutterTools指令运行参数中添加：--local-engine=src/out/ + 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 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 @@ -144,22 +169,20 @@ flutter build hap --local-engine=/Users/lihui/Documents/flutter_engine/src/out/o ``` ### 3.鸿蒙真机运行Flutter项目 - 通过flutter devices指令发现真机设备之后，获取device-id +* 通过```flutter devices```指令发现真机设备之后，获取device-id - 方式一：进入项目目录指定构建方式编译hap包并安装到鸿蒙手机中 -``` +方式一：进入项目目录指定构建方式编译hap包并安装到鸿蒙手机中 +```sh flutter run --debug --local-engine=/Users/lihui/Documents/flutter_engine/src/out/ohos_debug_unopt_arm64 -d ``` - 方式二：进入工程根目录编译hap包,然后安装到鸿蒙手机中 - ``` +方式二：进入工程根目录编译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项目