鸿蒙 Flutter 项目适配实战指南
随着 HarmonyOS Next 的推进，将现有 Flutter 项目迁移至鸿蒙生态已成为不少开发者的选择。这里结合实战经验，从环境搭建到应用部署，梳理一套完整的适配流程，并记录一些容易踩坑的细节。
环境准备：DevEco Studio 与 SDK
首先得准备好鸿蒙的开发工具链。下载 DevEco Studio（支持 Windows/macOS），安装后登录华为开发者账号。注意创建模拟器前需提交设备申请，审核通常耗时约 2 小时。
配置鸿蒙版 Flutter SDK
我们需要使用社区维护的鸿蒙分支 SDK，克隆命令如下：
git clone https://gitee.com/openharmony-sig/flutter_flutter.git
cd flutter_flutter
git checkout -b dev origin/dev
建议切换到 dev 分支，功能更新更及时。配置完成后，记得将 SDK 的 bin 目录加入系统 PATH，确保终端能识别 flutter 命令。
JDK 与环境变量
HarmonyOS Next 要求 JDK 17。配置 JAVA_HOME 并添加至 PATH：
# Windows 示例
set JAVA_HOME=C:\Program Files\Java\jdk-17.0.1
set PATH=%PATH%;%JAVA_HOME%\bin
国内网络环境下，建议配置镜像加速依赖下载：
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
同时添加鸿蒙 SDK 工具链路径（以 Windows 为例）：
set PATH=%PATH%;%TOOL_HOME%\tools\ohpm\bin
set PATH=%PATH%;%TOOL_HOME%\tools\hvigor\bin
工程配置：Flutter 适配鸿蒙结构
在 Flutter 项目根目录执行初始化命令，生成鸿蒙模块入口和配置文件：
flutter create --platforms=harmony .
这会创建一个 harmony 目录。接下来检查 pubspec.yaml，移除仅支持 Android/iOS 的插件，替换为鸿蒙兼容版本。
如果需要加速编译，可以下载预编译的 FlutterEngine 解压至 src/out 目录，构建时指定本地引擎：
flutter build hap --debug --local-engine=src/out/ohos_debug_unopt_arm64
代码与 UI 调整
权限声明
在 harmony/module.json5 中声明所需权限，例如网络访问：
"requestPermissions": [
