编辑此文档时间为2024年 3月4日
我安装的时候参考文档:
https://gitee.com/openharmony-sig/flutter_flutter
https://mp.weixin.qq.com/s/NOQDLcCd7wsJDh8L9lrNuA (此文最最最有用的一句话 :欲练此功,必先仔细阅读此项目的README文件十遍以上。)
工具版本: DevEco Studio 4.0 Release(如果不是4.0及以上,请重新下载,这算是最开始的坑,最开始我的是3.1.0.501,帮大家试过了,不好用,建议下载 DevEco Studio 4.0 Release)
下载地址:https://gitee.com/arkui-x/docs/blob/master/zh-cn/release-notes/ArkUI-X-v1.0.0-release.md
hvigor 版本3.0.9
api version 10
flutter版本:flutter_flutter
踩坑1
现在需要下载的是Dev版本的不是master(帮大家试过了master,暂时没配置成功。Dev版本可以)
这里就是用flutter_flutter 代替之前原有的flutter
git pull https://gitee.com/openharmony-sig/flutter_flutter.git dev
踩坑2
///创建新项目
flutter create --platforms ohos flutter_test_project (flutter_test_project 为新项目名称)
修改 build-profile.json5 的
"runtimeOS"为"OpenHarmony"
"compileSdkVersion": 10,
"compatibleSdkVersion": 10,
修改hvigor-config.json5
"hvigorVersion": "3.0.9",
"dependencies":
{
"@ohos/hvigor-ohos-plugin": "3.0.9"
}
踩坑3
///配置环境变量
//如果之前配置过flutter的环境变量,要删除或者注释.bash_profile中以前的环境变量
export PATH=/Users/**/Documents/flutter/bin:$PATH,
如果上边这行代码在
export PATH=/Users/**/Documents/flutter_flutter/bin:$PATH这行代码前边则不执行后边环境变量的配置
谁先设置默认是谁。要不然每次打开终端都需要重新设置一下环境变量。
踩坑4
看flutter_flutter https://gitee.com/openharmony-sig/flutter_flutter.git文档要下载的太多.实则没那么麻烦,可以根据flutter_flutter说明的步骤走,也可以通过开发工具下载的配置哪种都行,我用的是DevEco-studio系统自己下载的
///环境变量
export PATH=/Users/**/Documents/flutter_flutter/bin:$PATH
export NODE_HOME=/Users/**/nodejs
export PATH=$NODE_HOME/bin:$PATH
export OHPM_HOME=/Users/**/Library/Huawei/ohpm
export PATH=${PATH}:${OHPM_HOME}/bin
export HOS_SDK_HOME=/Users/**/Library/Huawei/Sdk
export OHOS_SDK_HOME=/Users/**/Library/OpenHarmony/Sdk
export HDC_HOME=/Users/**/Library/OpenHarmony/Sdk/10/toolchains
export PATH=$PATH:$HDC_HOME
踩坑5
///build 以下2种都行
///应用构建依赖Flutter Engine构建产物,下载产物地址:https://docs.qq.com/sheet/DUnljRVBYUWZKZEtF?tab=BB08J2
flutter build hap --target-platform ohos-arm64 --local-engine-src-path=/Users/**/Documents/src --local-engine=ohos_release_arm64
其中 --local-engine-src-path=后边的是下载后产物目录地址
我的放了Documents/src文件,不可删除或修改里边的out文件,要不然报错
///或者
flutter build hap --target-platform ohos-arm64 --debug --local-engine=/Users/**/Documents/src/out/ohos_release_arm64
踩坑6
报错 Error: The hvigor depends on the npmrc file. Configure the npmrc file first.是没有npmrc文件,是隐藏文件,检查有没有,如果没有在电脑的根目录/Users/**/下输入终端命令
解决办法:
touch ~/.npmrc
vim ~/.npmrc
写入如下内容
registry=https://repo.huaweicloud.com/repository/npm/
@ohos:registry=https://repo.harmonyos.com/npm/
踩坑7
需要一个真机,而我没有。