鸿蒙版 Flutter 相关仓库已迁移至 GitCode，赋能跨平台开发效率升级！

各位 Flutter 跨平台框架开发者：

为进一步提升文档查阅的稳定性与便捷性，鸿蒙版 Flutter 相关仓库已正式迁移至 GitCode 平台。此后，最新的文档更新、版本化资源及协作支持将集中在此平台进行，欢迎通过以下链接访问： 👉 Flutter-Flutter 仓（GitCode）[1]

flutter-engine[2]

Flutter-Packages[3]

flutter_samples[4]

如何在 GitCode 高效使用 鸿蒙版 Flutter？

为帮助开发者快速定位所需资源，GitCode 平台支持精准的版本化文档查阅，操作步骤如下：

1. 访问上述文档仓链接，进入鸿蒙版 Flutter 仓库，这里有 3.22/3.27 版本，大家根据自己的需要选择。
2. 通过页面顶部的 分支选择器，直接切换至目标版本分支（如 Release 正式版、LTS 长期支持版等）；
3. 切换后即可获取该版本对应的完整文档内容，实现针对性的版本化学习与开发参考。

后续文档的更新、维护及社区协作将主要在 GitCode 开展，若使用中遇到问题或有优化建议，欢迎随时反馈交流！

Flutter 框架概述

Flutter 是谷歌的高性能、跨端 UI 框架，可以通过一套代码，支持 iOS、Android、Windows/MAC/Linux 等多个平台，且能达到原生性能。 Flutter 也可以与平台原生代码进行混合开发。在全世界，Flutter 正在被越来越多的开发者和组织使用，并且 Flutter 是完全免费、开源的。开发者基于 一套主代码 即可构建多平台适配的高性能应用，大幅降低跨平台开发成本。

鸿蒙版 Flutter 学习路线

以下为 鸿蒙版 Flutter 应用开发的完整学习路径，可按阶段逐步深入：

以及坚果派开发者社区也有电子书，可以学习，访问：https://gitcode.com/nutpi/gitbook-harmonyos-flutter

环境搭建

OpenHarmony 版 Flutter 集成与编译教程

1. OpenHarmony 版 Flutter 环境搭建指导[5]
2. OpenHarmony 设备运行指导[6]

功能开发

在 OpenHarmony 应用中添加 Flutter 页面

1. 如何使用 FlutterPage
2. 如何使用混合开发添加跳转 FlutterEntry

在 OpenHarmony 应用中使用 Flutter Channel 能力

1. 如何使用 Flutter 与 OpenHarmony 通信 FlutterChannel

与原生混合渲染

1. Flutter OHOS 外接纹理适配简介
2. 如何使用多引擎 FlutterEngineGroup
3. 如何使用 PlatformView[7]
4. PlatformView 同层渲染方案适配切换指导[8]

开发 Flutter 静态库

1. 开发 module
2. 开发 package[9]
3. 开发 plugin[10]
4. 开发 FFI plugin

性能调优

Flutter OpenHarmony 化的工程，可使用 devtools 对 Dart 代码进行调试，具体内容请参考 DevTools[11]

• 性能分析定界 (OpenHarmony 平台) 指南[12]
• 性能分析第一步 - 梳理线程顺序[13]
• 性能分析 - 帧渲染跟踪[14]
• 性能分析 - 滑动响应时延[15]

调试调测

1. 调试 dart 代码[16]
2. 调试 OpenHarmony 应用 / 服务[17]

三方库接入

1. ohos 平台适配 flutter 三方库指导[18]
2. ohos 平台已兼容库[19]

FAQ

Flutter OpenHarmony 化开发过程中的常见问题：

1. 环境相关问题[20]
2. ohos 引擎产物编译相关问题[21]
3. ohos 应用编译相关问题[22]
4. ohos 代码开发相关问题[23]
5. ohos 运行相关问题[24]
6. 功能开发相关问题[25]
7. 解析 flutter 相关的 cppcrash 堆栈[26]
8. 申请权限相关问题[27]

关于 GitCode 平台

GitCode 是面向专业开发者的高效云端开发协作平台，为鸿蒙版 Flutter 提供以下核心支持：

• 稳定的版本化管理：通过分支机制轻松切换文档版本，适配不同开发需求；
• 高效协作能力：支持多人协同编辑、issue 跟踪与讨论，加速问题反馈与解决；
• 全面的代码托管：集成 Git 版本控制、分支管理功能，保障文档更新的可追溯性。

访问 GitCode 官网了解更多：https://gitcode.com/

祝各位开发者学习顺利，基于鸿蒙版 Flutter 构建更多跨平台精品应用！

参考资料

[1]

Flutter-Flutter 仓（GitCode）: https://gitcode.com/openharmony-tpc/flutter_flutter

[2]

flutter-engine: https://gitcode.com/openharmony-tpc/flutter_engine

[3]

Flutter-Packages: https://gitcode.com/openharmony-tpc/flutter_packages

[4]

flutter_samples: https://gitcode.com/openharmony-tpc/flutter_samples

[5]

OpenHarmony 版 Flutter 环境搭建指导: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/03_environment/openHarmony-flutter环境搭建指导.md

[6]

OpenHarmony 设备运行指导: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/03_environment/OpenHarmony设备运行指导.md

[7]

如何使用 PlatformView: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/04_development/如何使用PlatformView.md

[8]

PlatformView 同层渲染方案适配切换指导: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/04_development/PlatformView同层渲染方案适配切换指导.md

[9]

开发 package: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/04_development/开发package.md

[10]

开发 plugin: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/04_development/开发plugin.md

[11]

DevTools: https://docs.flutter.cn/tools/devtools

[12]

性能分析定界 (OpenHarmony 平台) 指南: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/05_performance/性能分析定界指南.md

[13]

性能分析第一步 - 梳理线程顺序: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/05_performance/性能分析第一步-梳理线程顺序.md

[14]

性能分析 - 帧渲染跟踪: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/05_performance/性能分析-帧渲染跟踪.md

[15]

性能分析 - 滑动响应时延: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/05_performance/性能分析-滑动响应时延.md

[16]

调试 dart 代码: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/06_debug/调试dart代码.md

[17]

调试 OpenHarmony 应用 / 服务: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/ohos-debugging-app-0000001545729889-V2

[18]

ohos 平台适配 flutter 三方库指导: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/07_plugin/ohos平台适配flutter三方库指导.md

[19]

ohos 平台已兼容库: https://gitcode.com/openharmony-sig/flutter_packages#openharmony平台已兼容库

[20]

环境相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/环境相关问题.md

[21]

ohos 引擎产物编译相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/ohos引擎产物编译相关问题.md

[22]

ohos 应用编译相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/ohos应用编译相关问题.md

[23]

ohos 代码开发相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/ohos代码开发相关问题.md

[24]

ohos 运行相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/ohos运行相关问题.md

[25]

功能开发相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/04_development/README.md

[26]

解析 flutter 相关的 cppcrash 堆栈: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/解析flutter相关的cppcrash堆栈.md

[27]

申请权限相关问题: https://gitcode.com/openharmony-tpc/flutter_samples/blob/br_3.7.12-ohos-1.1.0/ohos/docs/08_FAQ/permission.md