【学习笔记DAY1】-Flutter适配Harmony平台实现跨平台开发（Windows版）-环境搭建完整指南

前言

随着HarmonyOS生态的不断发展，越来越多的开发者希望将应用适配到Harmony平台。本文将详细介绍如何从零开始搭建Flutter适配Harmony平台的开发环境，帮助开发者顺利完成环境配置。

一、环境准备

1.1 系统要求

在开始之前，请确保您的开发环境满足以下最低要求：

操作系统：Windows10 64位或macOS 10.14/10.15/11.2.2
内存：8GB及以上
硬盘：100GB及以上
分辨率：1280*800像素及以上

系统配置检查

在开始安装前，建议先检查系统配置：

1. 检查Windows版本：

   • 按 Win + R，输入 winver，查看系统版本
   • 确保系统已更新到最新版本

2. 检查磁盘空间：

   • 打开"此电脑"，检查C盘和D盘可用空间
   • 建议在D盘或其他非系统盘安装开发工具

3. 检查BIOS设置（如需要）：

   • 确保已启用虚拟化支持（VT-x/AMD-V）
   • 在BIOS中启用Hyper-V（Windows 10/11专业版）

1.2 前置软件安装

在开始Flutter HarmonyOS环境搭建之前，需要确保已安装以下基础软件：

必需软件清单

1. JDK (Java Development Kit)
   • 版本要求: JDK 17
   • 下载地址:JDK17
   • 安装教程:JDK安装教程
   • 用途: Flutter和HarmonyOS开发工具的基础运行环境
   • 验证命令:

java --version

2. Git
   • 版本要求: Git 2.0.0 或更高版本
   • 下载地址: Git 2.52.0
   • 安装教程：Git 安装教程
   • 用途: 版本控制和Flutter SDK管理

git --version

3. DevEco Studio
   • 版本要求:6.0.1 Release(尽量下载最新版)
   • 下载地址: DevEco Studio 6.0.1 Release
   • 安装教程：DevEco Studio 安装教程
   • 用途: 代码编辑

安装顺序建议

建议按照以下顺序安装软件，避免依赖问题：

1. JDK → 2. Git → 3. DevEco Studio

1.3 下载相关插件及模拟器

1. 新建项目
   
   2.工程配置
   
   3.进入设置页面
   

4.下载ArkUI-X

5.下载openHarmonySDK

6.进入模拟器管理界面

7.打开模拟器入口

8.选择对应类型相应版本的模拟器进行下载

9.选择某一文件夹通过CMD下载FlutterSDK

git clone -b oh-3.27.4-dev https://gitcode.***/openharmony-tpc/flutter_flutter.git

下载安装成功：

1.4 环境变量配置

环境变量配置是安装软件的关键步骤，配置错误会导致后续开发工具无法正常运行。

详细配置步骤：

1. 打开环境变量设置：

   • 方法一：右键 “此电脑” → “属性” → “高级系统设置” → “环境变量”
   • 方法二：按 Win + R，输入 sysdm.cpl，回车 → “高级” 选项卡 → “环境变量”
   • 方法三：按 Win + X，选择 “系统” → “高级系统设置” → “环境变量”

2. 配置CLASSPATH变量（系统变量）：

   • 在 “系统变量” 区域，点击 “新建”
   • 变量名：PUB_HOSTED_URL
   • 变量值：https://pub.flutter-io.***
   • 点击 “确定”
   • 再点击 “新建”
   • 变量名：FLUTTER_STORAGE_BASE_URL
   • 变量值：https://storage.flutter-io.***
   • 点击 “确定”
     

4. 配置Path变量（系统变量）：
   • 在 “系统变量” 区域，找到 “Path” 变量，点击 “编辑”
   • 点击 “新建”，添加对应路径（根据自己的deveco studio安装的路径自行调整）：
   • D:\Git\cmd
   • D:\Java17\bin
   • D:\DevEcoStudio\DevEco Studio\sdk\default\openharmony\toolchains
   • D:\DevEcoStudio\DevEco Studio\tools\ohpm\lib
   • D:\DevEcoStudio\DevEco Studio\tools\node
   • D:\DevEcoStudio\DevEco Studio\tools\hvigor\bin
   • D:\openharmony_flutter\flutter_flutter\bin
   • 点击 “上移” 将这两条路径移到最前面（优先级更高）
   • 点击 “确定” 保存
     

二、新建Flutter项目

2.1 检查Flutter版本

flutter --version

2.2 诊断Flutter环境

flutter doctor -v

2.3 新建Flutter工程

新建一个文件夹，专门保存Flutter鸿蒙项目：

执行以下命令创建一个项目，替换成你自己的项目名

flutter create --platforms ohos <projectName>

2.3 进入项目文件

2.4 打开powershell

在蓝色框中输入powershell接着点击 Enter

2.5 构建项目

flutter doctor -v

2.6 打开项目

2.8信任项目

2.9 选择SDK版本并同步项目

2.10 连接真机（2.10和2.11取其一）

USB连接

无线调试

方法一：

终端输入：IP和端口号，在需要调试的设备上，打开开发者模式，在无线调试页面查看
hdc tconn 192.168.165.202:42949

方法二：从Tools点击IP Connection进入界面

2.11 模拟器连接

进入模拟器管理页面

选择下好的模拟器，点击Next按钮

配置模拟器参数

启动模拟器

2.12 应用签名

2.13 运行项目