ARTICLE · 1090793

CPF-Flutter 开发文档导航 - Flutter鸿蒙应用开发必备

发布时间：2026-09-28 13:36:04 最近访问：2026-09-28 13:35:16

CPF-Flutter，全称Cross-Platform Framework Flutter，是Flutter 鸿蒙的官方，官网介绍如下：1、CPF-Flutter是汇集 Flutter 中国社区的框架及三方插件，主要包含openHarmony适配的框架、Engine、官方插件以及主流的三方插件，帮忙开发者快速在openHarmony 开发Flutter应用。2、CPF-Flutter由跨平台框架PMC下属的Flutter SIG主导，欢迎您使用及参与贡献。

我基于官网上的链接，整理了一版应用开发者导航，从框架介绍，到架构概览，帮助开发者环境搭建，功能开发，希望相关文档能帮助到各位开发者！更多的文档，还请移步FPF-Flutter官方（https://gitcode.com/CPF-Flutter）。

一、全景梳理

3 个模块，每个模块都是干货，介绍和分布如下:

模块	内容概要	篇数
入门篇	框架及核心知识介绍	4
应用开发篇	应用开发核心功能介绍及实操，从页面开发到混合开发，从渲染到插件开发	9
三方库篇	已适配三方库清单	2

二、入门篇

入门思路：先看熟悉的上游Flutter框架介绍，再看Flutter鸿蒙版的整体架构设计，从第三篇开始环境的搭建和运行指导，最后看下引擎编译环境和构建指导：

主题	文档路径
上游 Flutter 框架介绍	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/01_framework/README.md
Flutter 鸿蒙框架介绍	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/02_architecture/README.md
Flutter 鸿蒙应用开发环境搭建指导	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/03_environment/OpenHarmony-flutter%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA%E6%8C%87%E5%AF%BC.md
Flutter 鸿蒙 Engine 构建指导	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/03_environment/Flutter-OH-engine%E6%9E%84%E5%BB%BA%E6%8C%87%E5%AF%BC.md

只做应用开发：看第一篇和第三篇就够
要替换SDK的，自己编引擎产物的，看第二，四篇。

三、应用开发篇

应用开发部分整理了4个部分：

1. 核心对象，应用生命周期及Channel通信：只有理解了Flutter鸿蒙核心对象概念，生命周期及通信机制，后续开发才会游刃有余。

主题	文档路径
Flutter鸿蒙应用核心对象介绍	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/Flutter-OH%E6%A0%B8%E5%BF%83%E5%AF%B9%E8%B1%A1%E7%AE%80%E4%BB%8B.md
Flutter鸿蒙应用生命周期	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/Flutter-OH%E5%BA%94%E7%94%A8%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F.md
Flutter Channel 能力	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8Flutter%E4%B8%8EOpenHarmony%E9%80%9A%E4%BF%A1%20FlutterChannel.md

2. 混合开发：通过 FlutterEntry 将 Flutter 页面嵌入到原生 ArkTS 页面中，并管理 Flutter 引擎的创建、销毁以及页面跳转等生命周期行为。

主题	文档路径
使用 `FlutterEntry` 实现原生页面与 Flutter 页面之间的混合开发与跳转	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E6%B7%B7%E5%90%88%E5%BC%80%E5%8F%91%E6%B7%BB%E5%8A%A0%E8%B7%B3%E8%BD%AC%20FlutterEntry.md

3. 渲染：与原生混合渲染。

主题	文档路径
Flutter 鸿蒙外接纹理适配	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/Flutter%20OHOS%E5%A4%96%E6%8E%A5%E7%BA%B9%E7%90%86%E9%80%82%E9%85%8D%E7%AE%80%E4%BB%8B.md
如何使用PlatformView	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8PlatformView.md
PlatformView同层渲染方案适配切换指导	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/PlatformView%E5%90%8C%E5%B1%82%E6%B8%B2%E6%9F%93%E6%96%B9%E6%A1%88%E9%80%82%E9%85%8D%E5%88%87%E6%8D%A2%E6%8C%87%E5%AF%BC.md

4. 库与插件开发：

主题	文档路径
开发 package	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%BC%80%E5%8F%91package.md
开发 plugin	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%BC%80%E5%8F%91plugin.md

四、三方库篇

主题	文档路径
已经适配三方库最新全览	https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md
教你如何适配三方库	https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/07_plugin/ohos%E5%B9%B3%E5%8F%B0%E9%80%82%E9%85%8Dflutter%E4%B8%89%E6%96%B9%E5%BA%93%E6%8C%87%E5%AF%BC.md

五、调试调优篇

【DFX系列开篇】Flutter 鸿蒙应用崩了、卡了、发烫了-从哪里开始查

【DFX系列】Flutter 鸿蒙日志与Trace抓取使用指南

【DFX系列】Flutter 鸿蒙崩溃问题定位指南:三种崩溃,三条排查路径

【DFX系列】Flutter 鸿蒙应用卡死问题定位指南

【DFX系列】Flutter 鸿蒙应用卡顿丢帧定位指南

【DFX系列】Flutter 鸿蒙应用滑动卡顿与时延问题分析

【DFX系列】Flutter 鸿蒙应用负载与功耗问题定位

【DFX系列】Flutter 鸿蒙应用HiAppEvent事件速查字典

【DFX系列】Flutter 鸿蒙应用如何排查黑屏，白屏，OOM闪退和内存持续增长异常

【DFX系列】Flutter 鸿蒙应用外接纹理介绍及问题定位

小伙伴们记得点赞+关注

关注 CPF-Flutter 社区

“AI再牛，技术不能丢”

一、全景梳理

三、应用开发篇

四、三方库篇

相关学习资料