一、前置环境准备

1. JDK 安装与配置

• 版本选择：推荐 JDK 17（兼容 Flutter 3.x+、DevEco Studio 4.x），避免 JDK 21/25（易插件不兼容）。
• 下载与安装：从 Oracle 官网 / 华为镜像下载，解压到英文路径（如F:\Hongmeng\Java-jdk17）。
• 环境变量配置：
  • 新建系统变量JAVA_HOME，值为 JDK 根路径；
  • 编辑Path，添加%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin。
• 验证：重启 CMD 后运行java -version、javac -version，应输出 JDK 17 版本。
• 常见坑点：变量名错误、路径含中文、配置后未重启终端。
  

2. Git 安装

   安装路径含中文 / 空格导致命令执行失败

   桌面无 Git 快捷方式

   安装过程中提示 “权限不足”

   克隆仓库时提示 “SSL certificate problem”

• 下载与安装：从 Git 官网 / 阿里镜像下载 x64 版本，安装到英文路径，勾选 “添加到 PATH” 和桌面快捷方式。
  安装后终端输入git无响应 / 提示 “不是内部命令”
• 原因：安装时没勾选 “添加到 PATH”，或系统未识别到 Git 的环境变量。
• 解决：
  • 重新安装 Git，勾选 “Add Git to the system PATH”；
  • 手动将 Git 安装目录的bin文件夹（如D:\Git\bin）添加到系统环境变量Path，重启终端。
• 原因：Git 对中文路径兼容性较差，空格会被终端识别为命令分隔符。
• 解决：卸载后重新安装到纯英文无空格路径（如D:\Git）。
• 原因：安装时未勾选 “Create a desktop icon” 选项。
• 解决：重新运行安装程序，在组件选择步骤勾选 “桌面快捷方式”。
• 原因：当前用户无管理员权限，无法写入系统目录。
• 解决：右键点击安装包，选择 “以管理员身份运行”。
• 原因：网络环境导致 SSL 证书验证失败。
• 解决：临时关闭 Git 的 SSL 验证（仅临时使用，不建议长期开启）：

  bash

  git config --global http.sslVerify false

3. 启用 Hyper-V（虚拟化）

3. 修复 Ohpm 组件缺失

若路径中无 Ohpm 文件，需重新安装组件：

二、Node.js 版本不兼容 Ohpm 的解决

Ohpm 依赖 Node.js 14.19.0+（低版本会提示 “找不到 node:events 模块”）：

构建鸿蒙 HAP 安装包（Release 版）

步骤 1：进入项目目录

通过终端切换到刚创建的项目根目录（或在项目文件夹地址栏输入powershell回车，直接打开对应路径的 PowerShell）。

步骤 2：执行构建命令

在 PowerShell 中输入以下命令，构建 Release 版本的鸿蒙应用包：

bash

flutter build app --release

步骤 3：获取构建结果

构建成功后，终端会提示输出路径，可在以下目录找到未签名的 HAP 包：ohos\build\outputs\default

在 DevEco Studio 中打开并配置项目

步骤 1：导入项目

步骤 2：配置目标 SDK 版本

 连接调试设备（真机 / 模拟器）

方式 1：连接鸿蒙真机

方式 2：使用鸿蒙模拟器

配置自动签名（关键步骤）

编译并启动项目

• 适用场景：鸿蒙模拟器依赖，Windows 家庭版默认隐藏。
• 启用方法：以管理员身份运行批处理脚本：

  cmd

  pushd "%~dp0"
  dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
  for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
  del hyper-v.txt
  Dism /online /enable-feature /featurename:Microsoft-Hyper-V -All /LimitAccess /ALL
  pause
  

• 验证：执行后重启电脑，在 “Windows 功能” 中确认 Hyper-V 已启用。

  4.Ohpm 与 Node.js 问题解决指南

  一、Ohpm 缺失 / 环境变量错误的处理

  Ohpm 是鸿蒙开发的包管理工具，若flutter doctor提示缺少 Ohpm，通常是 ** 路径未配置、组件缺失或鸿蒙版本过低（＜6.0）** 导致的，可按以下步骤解决：

  1. 先排查鸿蒙版本

  若你的鸿蒙 SDK 版本＜6.0，可能本身不包含 Ohpm 组件。建议先升级到HarmonyOS 6.0.0 及以上版本（在 DevEco Studio 的 Device Manager 中下载对应 SDK）
  下载链接：最新版本 - 下载中心 - 华为开发者联盟
  
  
  因为我之前下载的是5.0.5版本所以导致有一些环境报错，无法运行，所以推荐大家使用6.0以上版本的。

  2. 配置 Ohpm 环境变量

• 找到 Ohpm 路径：正常安装后，路径一般为C:\HarmonyOS\ArkUI-X\Sdk\20\toolchains\ohpm\bin（具体以实际安装目录为准）。
• 添加到环境变量：
  1. 按Win+R输入sysdm.cpl，打开 “系统属性→高级→环境变量”；
  2. 在系统变量Path中新增 Ohpm 的bin路径；
  3. 重启终端后，输入ohpm -v验证（显示版本号则成功）。
     
• 方法 1：重装 Toolchains：在 DevEco Studio 的Settings→OpenHarmony SDK中，先取消勾选 API 20 的 “Toolchains” 卸载，再重新勾选安装，完成后即可在 SDK 目录找到 ohpm。
• 方法 2：手动下载：从华为官方下载命令行工具包（含 Ohpm），解压后将 ohpm 的bin路径添加到环境变量。
• 卸载旧版本 Node.js（可选）；
• 从 Node.js 官网下载 **LTS 版本（如 14.19.0+）** 的 64 位安装包；
• 安装后重启终端，输入node -v验证版本，即可正常运行 Ohpm。

  5、Flutter 鸿蒙项目创建、编译与运行完整流程

  创建鸿蒙专属 Flutter 项目

  步骤 1：准备项目目录

  专门新建一个文件夹存放 Flutter 鸿蒙项目（路径需全英文，无空格 / 中文），在文件夹地址栏输入cmd并回车，快速打开终端。

  步骤 2：执行创建命令

  在终端中输入以下命令（将flutter_harmonyos替换为你的项目名）：

  bash

  flutter create --platforms ohos flutter_harmonyos
  

  该命令会直接创建仅支持鸿蒙（ohos）平台的 Flutter 项目，避免多余平台配置。

  步骤 3：配置 Impeller 渲染模式（可选）

  Flutter 鸿蒙平台支持impeller-vulkan高性能渲染模式，可通过配置文件控制开关：

• 初次创建项目后，配置文件路径：ohos\entry\src\main\resources\base\profile\buildinfo.json5
• 首次执行run或build后，文件会自动迁移至：ohos/entry/src/main/resources/rawfile/buildinfo.json5
• 编辑配置（开启 / 关闭渲染优化）：

  json5

  {
     "string": [
        {
           "name": "enable_impeller",
           "value": "true"  // true=开启（默认），false=关闭
        }
     ]
  }
  

• 打开 DevEco Studio，选择「Open」导入刚创建的 Flutter 项目，信任该项目；
• 导入后开发环境会自动下载并编译依赖，若报错需检查前文环境配置是否完整。
• 首次打开项目时，会提示「添加目标 SDK 版本」，选择选项 1；
• 打开项目根目录下的build-profile.json5文件，手动添加你需要适配的鸿蒙设备 SDK 版本（需与后续模拟器 / 真机 SDK 版本一致）。
• 在鸿蒙设备上开启「开发者模式」，进入「无线调试」页面，查看设备的 IP 地址和端口号；
• 打开 DevEco Studio 终端，执行命令连接设备：

  bash

  hdc tconn IP:端口号  # 示例：hdc tconn 192.168.1.100:5555
  

• 打开 DevEco Studio 的「Device Manager」，启动已下载的 HarmonyOS 6.0.0 及以上版本模拟器（需提前启用 Hyper-V）；
• 确保模拟器启动成功后，再进行后续签名配置。
• 点击 DevEco Studio 顶部菜单栏「Project Structure」（项目结构）；
• 选择「Sign In」，通过华为账号登录配置自动签名；
• 在弹出的网页中点击「允许」授权，授权后 DevEco 会自动刷新签名配置；
• 若出现签名报错，大概率是电脑系统时间与网络时间不一致，校准系统时间后重新尝试，即可签名成功。
• 确认模拟器 / 真机已正常连接（DevEco 右下角会显示设备名称）；
• 点击 DevEco Studio 右上角的绿色「运行」按钮，项目会自动编译并部署到目标设备；
• 等待编译完成后，即可在设备上看到运行的 Flutter 鸿蒙应用。