Flutter OH 文档索引
快速入门
| 文档名 | 说明 |
|---|---|
| Flutter OH 框架介绍 | 框架介绍 |
| Flutter OH 架构介绍 | 架构介绍 |
| Flutter OH 工程目录结构 | 工程目录结构 |
| Flutter OH 开发环境搭建指导 | 开发环境搭建（DevEco Studio 安装、模拟器配置） |
| Flutter OH Engine 构建指导 | Flutter OH Engine 构建指导 |
| OpenHarmony 设备运行指导 | 真机设备运行 Flutter 应用步骤 |
| Flutter 开发板运行指导 | RK3568 等开发板上运行 Flutter 应用 |
| FVM (Flutter Version Management) 使用指导 | 用 FVM 在同一开发机管理多个 Flutter OH 版本，按项目锁定分支/tag |
应用开发
| 文档名 | 说明 |
|---|---|
| Flutter OH 核心对象介绍 | 介绍 Flutter OH 核心对象职责与协作关系 |
| 核心对象架构原理 | 解析五大核心对象架构原理与生命周期协同 |
| Flutter OH 应用生命周期 | 两种集成方式的生命周期时序流程 |
| 启动生命周期回调机制 | 启动生命周期回调机制与最佳实践 |
| OpenHarmony 应用集成 Flutter 指导 | OpenHarmony 应用集成 Flutter 模块指导 |
| Flutter OH 应用构建与运行指导 | 应用构建、签名配置及 Impeller 开关设置 |
| 使用 Hvigor 插件构建 Flutter 项目 | Hvigor 插件编译 Flutter 项目方式 |
| Flutter 应用 OpenHarmony 接入指导 | 已有Flutter应用适配OpenHarmony平台指导 |
| Flutter Engine 异步创建与销毁 | Flutter Engine 异步创建与销毁能力的使用说明 |
| Flutter 分栏功能（平行视界）接入 | Flutter 分栏功能接入，支持折叠屏等设备 |
混合开发
| 文档名 | 说明 |
|---|---|
| 使用 FlutterPage | 使用 FlutterPage 组件嵌入 Flutter 页面 |
| 使用 FlutterEntry 混合开发 | 使用 FlutterEntry 实现原生与 Flutter 页面混合开发 |
| 使用 Module 混合开发 | 原生工程引用 flutter_module 子模块进行混合开发 |
| 使用 FlutterEngineGroup | 使用 FlutterEngineGroup 管理多个引擎实例 |
| 使用 FlutterEnginePreload | FlutterEnginePreload 预加载与预绘制机制 |
| 使用 Flutter Channel 通信 | Flutter 与 OpenHarmony 通过 Channel 机制双向通信 |
| 使用 PlatformView | 在 Flutter 中嵌入 OpenHarmony 原生 PlatformView |
| PlatformView 同层渲染适配 | PlatformView 同层渲染方案适配切换 |
| 导入自定义渲染内容 | 通过外接纹理导入 Native 自渲染内容到 Flutter |
| Flutter OH 多引擎开发指导 | Flutter OH 多引擎场景开发指导 |
插件与三方库
| 文档名 | 说明 |
|---|---|
| 识别Flutter三方库是否需要适配OpenHarmony | 识别 Flutter 三方库是否需要适配 OpenHarmony |
| Flutter三方库适配OpenHarmony平台指导 | Flutter 三方库适配 OpenHarmony 平台完整流程 |
| OpenHarmony 平台已适配三方库 | OpenHarmony 平台已适配三方库清单 |
| 开发 Flutter Plugin | 开发支持 ohos 平台的 Flutter 原生插件 |
| 开发 Dart Package | 开发纯 Dart 的 Flutter Package |
| 开发 FFI 插件 | 开发支持 ohos 平台的 FFI 插件 |
| 使用 Flutter 开发 OpenHarmony 插件 | 使用 Flutter 开发 OpenHarmony 原生插件 |
| 更新插件项目结构 | 将插件 ohos 目录从 project 结构更新为 module 结构 |
| 三方库鸿蒙化适配文档模板 | Flutter 三方库鸿蒙化适配文档编写模板 |
渲染引擎
| 文档名 | 说明 |
|---|---|
| 渲染引擎切换指导 | Impeller 与 Skia 渲染引擎切换配置 |
| 外接纹理适配 | 外接纹理适配（视频/相机 Surface 纹理与图片 PixelMap） |
| 外接纹理首帧自定义 | 外接纹理首帧背景自定义 |
| LTPO 屏幕动态帧率适配 | LTPO 屏幕动态帧率功能适配 |
| 渲染流程与异常诊断指导 | 渲染流程分析与异常诊断方法 |
性能调优
| 文档名 | 说明 |
|---|---|
| 性能分析定界指南 | 如何定位性能问题所属模块 |
| 性能分析第一步-梳理线程顺序 | 介绍 Flutter 渲染相关线程及其顺序 |
| 性能分析-帧渲染跟踪 | 单帧追踪方法，用于分析卡顿/丢帧 |
| 性能分析-滑动响应时延 | 滑动场景的 trace 分析与时延优化 |
| 性能调优-图片加载 | 图片预加载、缓存等优化手段 |
| 性能调优-内存分析与优化实践 | HarmonyOS 上 Flutter 应用的内存分析方法 |
| 性能调优-毕昇编译器开 PGO | 利用毕昇编译器 PGO 提升运行性能 |
| 性能优化-预加载渲染管线 | 解决页面转场白屏问题 |
| 性能调优索引 | 性能调优详细索引（含环境配置说明） |
降负载和功耗优化
| 文档名 | 说明 |
|---|---|
| Flutter OH 降负载和功耗优化 | 降负载和功耗优化详细索引 |
调试与排查
| 文档名 | 说明 |
|---|---|
| Flutter OH 热重载操作指导 | Debug 模式下使用热重载 / 热重启快速预览 Dart 代码变更 |
| 调试 Dart 代码 | 使用 VS Code / Android Studio / DevEco Studio 调试 Dart 代码 |
| 原生代码断点调试 | 使用 DevEco Studio 调试 ArkTS / Native 代码 |
| 调试 OpenHarmony 应用/服务 | OpenHarmony 官方文档：调试应用/服务 |
| 解析 Flutter 相关的 cppcrash 堆栈 | 使用 llvm-addr2line 解析 Flutter 相关的 CppCrash 堆栈 |
| Dart 堆栈符号化 | 使用 flutter symbolize 工具还原 Release/Profile 模式堆栈 |
| 内存泄漏与稳定性排查 | 卡顿丢帧、ArkTS / Native 内存泄漏分析 |
| 调试指导索引 | 调试调测详细索引 |
问题定位
| 文档名 | 说明 |
|---|---|
| DFX 问题定位导航 | 基于 HarmonyOS DFX 能力（HiAppEvent/HiLog/HiCollie/HiTrace）的问题诊断方法论 |
| 崩溃定位 | 应用闪退、崩溃（Native/Dart/ETS 异常）问题定位 |
| 卡死冻屏定位 | 应用卡死、无响应、冻屏问题定位 |
| 卡顿丢帧定位 | 界面卡顿、滑动不流畅、丢帧问题定位 |
| 内存/GPU 定位 | OOM、黑屏、渲染异常等内存与 GPU 问题定位 |
| 日志抓取 | 日志抓取、过滤与查看方法 |
| 卡顿与时延深度分析 | 滑动卡顿丢帧与时延问题深度分析 |
| 负载与功耗定位 | 负载异常与功耗问题定位 |
| 外接纹理问题定位 | 外接纹理问题定位 |
| 多设备适配问题定位 | 多设备适配问题定位 |
| 问题定位索引 | DFX 问题定位总索引 |
FAQ
| 文档名 | 说明 |
|---|---|
| 环境搭建问题 | SDK 配置、模拟器、长路径、跨平台复制等环境问题 |
| Engine 编译问题 | Flutter OH Engine 编译环境推荐版本与产物生成 |
| 应用编译构建问题 | 编译报错、依赖冲突、so 包未打入、跨磁盘等问题 |
| 签名与发布问题 | 自动签名、Release 构建异常、debug 版 har 上线闪退 |
| 代码开发问题 | 平台判断、资源获取、折叠屏适配、启动闪退等 |
| 三方库与插件适配问题 | 插件同步失败、依赖冲突、MissingPluginException 等 |
| 渲染引擎与 UI 问题 | WebView 拉伸、折叠屏、启动页闪动、Impeller 锯齿等 |
| 运行相关问题 | 运行时错误、白屏闪退、安全避让区异常等 |
| Crash 分析与调试问题 | 引擎调试、启动闪退、可复现 demo 提供等 |
| 权限与安全问题 | 权限声明位置、权限场景、功能与权限对照表 |
| 常见问题索引 | 常见问题详细索引 |
场景化案例
| 文档名 | 说明 |
|---|---|
| 应用上架与启动闪退场景案例 | 应用发布邀请测试或正式上架启动闪退问题的分析与解决方案 |
| 登录接入场景案例 | Flutter 接入华为账号一键登录的集成实践 |
| Flutter module 调试案例 | Flutter module 调试中线程合并导致断点阻塞 UI 线程引发崩溃 |
| Flutter OHOS ICU 升级问题与解决方案 | OHOS ICU 库大版本升级后的兼容性问题与解决方案 |
| 多设备自适应 DPI 指导文档 | 多设备自适应 DPI 的核心策略、断点系统、布局适配与最佳实践 |
| 引入插件失效问题场景案例 | APP release 打包发布后插件丢失问题的分析与解决方案 |
| webview 拉起支付白屏场景案例 | webview 拉起支付白屏（自定义 scheme）问题的分析与解决方案 |
| 场景化案例索引 | 场景化案例详细索引 |
示例代码
| 文档名 | 说明 |
|---|---|
| flutter_samples | Flutter 示例代码仓库 |
API 参考
| 文档名 | 说明 |
|---|---|
| Flutter OHOS 适配层 API 接口说明 | FlutterAbility、FlutterEntry、FlutterEngine、FlutterView 等核心类 API 使用说明 |
| Flutter 适配层 API | API 总览（按源码路径生成的逐类参考索引） |
版本说明
| 文档名 | 说明 |
|---|---|
| Flutter OH 版本说明 | 版本演进规划和分支策略 |
| Flutter OH 版本升级指导 | Flutter OH 版本升级指导 |
| Flutter 3.35 OpenHarmony 升级指导 | Flutter 3.35 OpenHarmony 升级指导 |