一、基础环境搭建
1.1 Git 下载与安装
下载地址:
https://git-scm.***/install/
下载安装文章:
【2025最新】下载安装 Git 详细教程 (Windows)-CSDN博客
1.2 Java JDK17 下载与安装
下载地址:
https://mirrors.huaweicloud.***/openjdk/11.0.2/
注:这里提供的连接里面有三个包,只需要根据自己的系统选择下载,这里以Windows为例,其他系统安装自行百度
下载jdk包后直接解压解压后如图:
我这里是在E盘Java目录下进行解压,解压完成后得到jdk-11.0.2文件夹
下一步环境变量
这里就不一一说明了看图
打开环境变量设置后----第一步--新建变量---变量名为 JAVA_HOME 值为jdk解压目录后打开jdk-11.0.2目录的路径 如图
可以看到上面我的解压路径加上解压后的文件名就是javahome的值
下一步添加path变量如图
编辑Path变量
新增两个
新增第一个输入
%JAVA_HOME%\bin
在新增一个
%JAVA_HOME%\jre\bin
到这里就齐活了
注:bug指南,部分同学打开path编辑是图下这种
这种就蒙了对吧?
只需要在变量值最后面加上
;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
杰克 注意 这串代码最前面的 ; 符号需要根据你变量值最后面结尾是否有 ; 符号决定添加 没有再加有则不用加,大概意思就是配置环境工具路径 ; 就是结束符的意思因为path有很多工具很多软件的路径所以用 ; 结束
当然如何恢复成我上面那种简单易懂的可以自行百度和ai问答,能解决,但是这里就不再做讲解
2.1 DevEco Studio下载安装
1.下载官网压缩包
下载地址:
DevEco Studio-鸿蒙应用集成开发环境(IDE)-华为开发者联盟
这里打开后直接下载即可
双击运行直接下一步路径哪里可以修改比如在D盘新建一个目录来存放 如: oh_ide 用来设置为安装路径
安装以后就是配置软件具体可以参考
【2025最新】Flutter 编译开发 鸿蒙HarmonyOS 6 项目教程(Windows)_flutter deveco studio-CSDN博客
根据步骤安装好下载好sdk和配置环境变量后
安装flutter
大家也可以参考上面的安装方法
这里是学习打开所以主要以问题处理讲解,因为我环境搭建基本上没有什么问题,我就收集了一些同学部署中遇到的问题来写
问:No Hmos SDK found. Try setting the HOS_SDK_HOME environment variable.
报错找不到SDK
解决方法:
开发工具步骤,设置过sdk路径和下载,打开路径
如图
我们只需要在环境变量新建一个变量 名称 HOS_SDK_HOME 值就是sdk目录下面的20目录当然 这里根据sdk版本决定,我的是20所以只有一个20目录 如果你有多个sdk也可以自行选择
这个错误理论上不会出现只要每一步骤都是按照上面连接操作的
注意 值 不是oh_sdk就可以了 一定要是oh_sdk\20 打开20文件夹复制路径
问题2:
答:
这个问题一般是flutter安装路径有异常路径名称 如该同学 路径存在空格 如文件名 oh sdk 这个路径就不行中间有空格,删除或者把flutter重新移动到新的路径下重新配置环境即可解决
这一步你前面的所有步骤都不会报错唯独编译报错,修改环境变量后打开powershell编译依旧报错,重新创建一个项目即可解决,因为上一次编译报错写编译记录里了,这样说能明白把,或者用指令删除编译记录,但是简单粗暴的方法就是重新创建
目前为止 遇到并帮助解决的就这两个问题有问题可以在评论里问,然后我这边能回答的就回答,这样这个帖子也能做问题汇总和解答方便后续同学可以快速解决问题
这里要说一下
基本上按照隔壁学习文档的内容一步一步操作是没有任何问题的,主要就是环境变量和路径配置
路径尽量 就是比如在D E盘根据自己的电脑来决定,尽量就是如jdk git flutter可以在如D 盘下创建一个目录用来存放他们的解压文件
比如 创建一个tools用来存放 jdk安装 git 安装flutter安装都选择这个目录就好
然后开发工具在D盘新建一个如oh_ide 这种 来存放 像 ide需要配置sdk目录和ark目录其实也可以放tools目录下 在tools下创建oh_sdk oh_ark这种就行了,不用多层路径 也不要直接放D盘,尽量做一下分类存放,命名尽量就是一个整体名称不要用空格字符 符号什么的, _ 这个可以在中间用开头结尾不要用,这样这个符号可以用来解释意思又能看懂记住自己放哪又不容易报错,大多数出问题的都是路径问题
新增:
报错3:WARN: ArkTS:WARN File:
D:/DevEco/flutter_sdk/harmonyos/flutter_harmonyos/ohos/oh_modules/.ohpm/@ohos+flutter_ohos@om4d5v8+rovmfrwedbpni+qru+qkb
o5i0gbcrt+48xg=/oh_modules/@ohos/flutter_ohos/src/main/ets/embedding/ohos/TouchEventTracker.ets:53:5
Function may throw exceptions. Special handling is required.
编译出现这个错误立马停止折腾 检查环境,环境各方面没问题,这个估计就是你之前创建的项目但是那会环境有问题,所以果断放弃,重新新建项目
flutter create --platforms ohos 项目名称
当然该方法仅仅帮助才部署环境不太会处理异常的,完整工程项目建议删除构建记录重新编译即可