Flutter应用适配鸿蒙平台指导文档-北京尧图网络

Flutter应用适配鸿蒙平台指导文档本文档介绍如何将已有的 Flutter 应用已支持 iOS/Android扩展支持鸿蒙平台在现有项目中添加鸿蒙平台目录保持多端代码复用。前置条件已安装 DevEco Studio已完成 Flutter OH 环境搭建开始适配1. 备份现有项目cp-ryour_flutter_project your_flutter_project_backup2. 添加鸿蒙平台支持进入你的 Flutter 项目目录执行以下命令cdyour_flutter_project# 为现有项目添加 ohos 平台支持flutter create--platformsohos.执行成功后项目新增 ohos 目录结构如下your_flutter_project/├── android/# Android 平台代码 ├── ios/# iOS 平台代码 ├── ohos/# OpenHarmony 平台代码新增 │ ├── build-profile.json5 │ ├── hvigorfile.ts │ ├── local.properties │ ├── entry/# 主入口模块 │ │ ├── build-profile.json5 │ │ ├── hvigorfile.ts │ │ ├── oh-package.json5 │ │ └── src/│ │ ├── main/│ │ │ ├── ets/│ │ │ │ ├── entryability/│ │ │ │ │ └── EntryAbility.ets # 主入口 Ability │ │ │ │ └── pages/│ │ │ │ └── Index.ets # 主页面 │ │ │ └── resources/# 资源文件 │ │ └── ohosTest/# 测试代码 │ └── ohos/# Flutter 引擎模块 ├── lib/# Dart 业务代码多端复用 ├── test/├── pubspec.yaml └──...3. 配置项目签名使用 DevEco Studio 打开ohos目录选择File → Project Structure → Project → Signing Configs勾选Automatically generate signature自动生成签名点击OK保存4. 适配 pubspec.yaml根据目标 Flutter OH 版本调整 SDK 约束# Flutter 3.27.4-ohos 版本environment:sdk:3.0.0 4.0.0flutter:3.27.0# Flutter 3.22.0-ohos 版本environment:sdk:3.0.0 4.0.0flutter:3.22.0获取依赖flutter clean flutter pub get三方库适配适配前请先查阅 OpenHarmony平台已适配三方库检查项目依赖的三方库是否已适配OpenHarmony 平台。若使用到的三方库未适配可提交 issue 反馈。1. 替换为 OpenHarmony 兼容版本dependencies:# 原配置Pub 官方版本不支持 OpenHarmony# path_provider: ^2.1.0# 新配置OpenHarmony 适配版本path_provider:git:url:https://gitcode.com/CPF-Flutter/flutter_packages.gitpath:packages/path_provider/path_providerref:br_path_provider-v2.1.5_ohos# 根据实际版本调整shared_preferences:git:url:https://gitcode.com/CPF-Flutter/flutter_packages.gitpath:packages/shared_preferences/shared_preferencesref:br_shared_preferences-v2.5.4_ohosurl_launcher:git:url:https://gitcode.com/CPF-Flutter/flutter_packages.gitpath:packages/url_launcher/url_launcherref:br_url_launcher-v6.3.2_ohos2. 自定义库适配如果项目中使用自定义的库则需要为自定义库添加 OpenHarmony 平台实现。适配指导请参考开发Flutter Plugin3. 平台判断代码适配如果代码中有平台判断需要添加 OpenHarmony 支持importdart:io;// 原代码if(Platform.isAndroid){// Android 特定逻辑}elseif(Platform.isIOS){// iOS 特定逻辑}// 适配后 - 添加 OpenHarmony 平台判断if(Platform.isAndroid){// Android 特定逻辑}elseif(Platform.isIOS){// iOS 特定逻辑}elseif(Platform.isOhos){// OpenHarmony 特定逻辑}4. 纯 Dart 三方库通常纯 Dart 三方库无需修改即可在 OpenHarmony 上运行。但如果代码中有平台判断还是需要参照上面第3步添加添加 OpenHarmony 平台判断。构建与运行1. 连接设备# 查看连接的设备flutter devices# 预期输出示例# 9CN0123608000xxx (mobile) • 9CN0123608000xxx • ohos-arm64 • Ohos OpenHarmony-6.1.0.262. 运行调试# 运行到鸿蒙设备flutter run-ddevice_id# 或使用简写如果只有一台鸿蒙设备flutter run3. 构建 HAP 包# 调试版本flutter build hap--debug# 正式版本flutter build hap--release4. 安装 HAP 包# 使用 hdc 工具安装hdcinstallbuild\ohos\hap\entry-default-signed.hap# 或指定设备hdc-tdevice_idinstallbuild\ohos\hap\entry-default-signed.hap问题交流问题反馈欢迎在 Flutter框架仓库以及各个 Flutter 三方库提交issue。

Flutter应用适配鸿蒙平台指导文档

相关推荐

MySQL 5.5 Windows版从卸载到安装的完整指南与避坑实践

中文大模型本土化评估：从语义理解到价值观对齐的体系化方案

DoTAT标注规范创建完整指南：可视化定义实体/关系/事件类型，一次创建多次复用

更多资讯

基于STM32与AD5542的微伏级脑电信号模拟发生系统设计

WorkBuddy+微信+deepseek-v4-flash：打造每日AI日报自动推送系统

AgentScope：Java生产级AI Agent框架深度解析

大模型实测避坑指南：数学推理、AI依赖、内存压缩与本地部署

随机森林原理与实战：从民主决策到机器学习应用

训练到部署：Model-Optimizer打通深度学习模型优化全流程

今日更新

淘宝商品详情API开发实战与性能优化指南

Unity Package Manager刷新错误排查与解决方案

Java record 规范构造器能否被反序列化或反射绕过

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？