已开启
docs: update README #23
HHHxm2创建于 7月30日
docs: update README #23
已开启
HHHxm2创建于 7月30日
共 1 个文件变更+178-61
MREADME.md+178-61
@@ -1,78 +1,195 @@
1-# CPF-Flutter1+# Flutter for OpenHarmony
2 2 
3-# 介绍3+> 将 Flutter 开发体验完整带入鸿蒙生态(OpenHarmony / HarmonyOS)。基于官方 Flutter SDK 与自渲染 Engine 的 OpenHarmony 适配,让 Flutter 应用无缝运行于鸿蒙设备,性能接近原生。**本仓库项目均由[原 Flutter 官方社区](https://docs.flutter.dev/) Fork 并扩展 OHOS 平台实现,建议应用在 OHOS 平台使用该组织项目版本产物编译,其余平台使用原社区版本产物编译。**
4 4 
5-CPF-Flutter用于汇集、维护Flutter在OpenHarmony平台上适配的SDK、引擎与三方库。帮助应用开发者使用一套代码在OpenHarmony上进行Flutter应用开发。5+<span style="color:red">**仓库迁移公告**:Flutter 鸿蒙化相关仓库已整体迁移至 [CPF-Flutter](https://gitcode.com/CPF-Flutter) 组织(**本组织**)。旧组织仓库将不再维护,请及时更新远程地址和依赖引用。详情参见:[迁移公告](https://gitcode.com/openharmony-tpc/flutter_flutter/wiki/Flutter%20%E9%B8%BF%E8%92%99%E5%8C%96%E4%BB%93%E5%BA%93%E8%BF%81%E7%A7%BB%E5%85%AC%E5%91%8A%EF%BC%9A%E5%85%A8%E6%96%B0%20CPF-Flutter%20%E7%BB%84%E7%BB%87%E4%B8%8A%E7%BA%BF)</span>
6 6 
7+[![License](https://img-transfer.gitcode.com?p=https%3A%2F%2Fimg.shields.io%2Fbadge%2FLicense-BSD-blue.svg&projectId=CPF-Flutter&pageUrl=https%3A%2F%2Fgitcode.com%2FCPF-Flutter)](https://github.com/flutter/flutter/blob/master/LICENSE) [![Flutter OH SDK](https://img-transfer.gitcode.com?p=https%3A%2F%2Fimg.shields.io%2Fbadge%2FSDK-flutter__flutter-green&projectId=CPF-Flutter&pageUrl=https%3A%2F%2Fgitcode.com%2FCPF-Flutter)](https://gitcode.com/CPF-Flutter/flutter_flutter) [![Flutter OH Docs](https://img-transfer.gitcode.com?p=https%3A%2F%2Fimg.shields.io%2Fbadge%2FDocs-flutter__samples-orange&projectId=CPF-Flutter&pageUrl=https%3A%2F%2Fgitcode.com%2FCPF-Flutter)](https://gitcode.com/CPF-Flutter/flutter_samples)
7 8 
9+---
8 10 
9-# 开始使用Flutter11+## 目录
10 12 
11-快速上手OpenHarmony-Flutter,从[开发指南](https://gitcode.com/cpf-flutter/flutter_samples/tree/master/ohos/docs)开始!13+- [项目简介](#项目简介)
14+- [快速链接](#快速链接)
15+- [跨平台框架技术选型](#跨平台框架技术选型)
16+- [版本规划与分支策略](#版本规划与分支策略)
17+ - [稳定版本](#稳定版本)
18+ - [版本规划](#版本规划)
19+- [相关文档](#相关文档)
20+- [三方库适配](#三方库适配)
21+ - [已适配核心三方库](#已适配核心三方库)
22+ - [纯 Dart 三方库](#纯-dart-三方库)
23+ - [引用方式](#引用方式)
24+ - [贡献指南](#贡献指南)
25+- [问题定位](#问题定位)
26+ - [Flutter OHOS 历史修复汇总](#flutter-ohos-历史修复汇总)
27+ - [Skill 资源汇总](#skill-资源汇总)
28+- [问题交流](#问题交流)
12 29 
13-若想了解更多关于Flutter的信息,可访问上游社区 [https://flutter.dev](https://flutter.dev/).30+---
14 31 
32+## 项目简介
15 33 
34+**Flutter for OpenHarmony** 是 [Flutter SDK](https://github.com/flutter/flutter) 与 [Flutter Engine](https://github.com/flutter/flutter/tree/master/engine) 的 OpenHarmony 官方社区适配版本,由 OpenHarmony-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈(Dart 语言 + 自渲染引擎)开发 OpenHarmony / HarmonyOS 应用,亦可基于源码构建支持 OpenHarmony 的 Flutter Engine。
16 35 
17-# 代码仓库36+**核心特性:**
18 37 
19-| 仓库 | 说明 | 入口 |38+- 使用 Dart 语言及 Flutter 生态组件直接构建鸿蒙应用,一套代码多端运行
20-| :--------------- | :---------------------------------- | :----------------------------------------------------------- |39+- 自渲染引擎(Impeller / Skia)独立绘制,性能接近原生,覆盖移动与桌面场景
21-| flutter_flutter | 适配OpenHarmony平台的Flutter SDK | [flutter_flutter](https://gitcode.com/cpf-flutter/flutter_flutter) |40+- 完整混合开发能力:FlutterPage、FlutterEntry、FlutterEngineGroup 多引擎、PlatformView 同层渲染
22-| flutter_engine | 适配OpenHarmony平台的Flutter Engine | [flutter_engine](https://gitcode.com/cpf-flutter/flutter_engine) |41+- 支持纯 Flutter 应用与 Add-to-App 两种集成方式
23-| flutter_packages | 兼容OpenHarmony平台的官方插件 | [flutter_packages](https://gitcode.com/openharmony-tpc/flutter_packages) |42+- 适配鸿蒙特有能力:多设备响应式 DPI、分栏布局、外接纹理、LTPO 等
24-| flutter_samples | OpenHarmony平台的示例代码 | [samples](https://gitcode.com/cpf-flutter/flutter_samples/) |43+- BSD 协议开源,与上游 Flutter 版本持续对齐
25 44 
26-# 三方库接入45+---
27 46 
28-- [识别Flutter三方库是否需要鸿蒙化](https://gitcode.com/cpf-flutter/flutter_samples/blob/master/ohos/docs/07_plugin/flutter_library_ohos_check.md)47+## 快速链接
29-- [三方库适配列表](./ThirdpartyLibrarites.md)
30 48 
31-# 已适配官方插件(持续更新)49+| 资源 | 地址 |
50+| --- | --- |
51+| Flutter OH SDK 与 Engine 仓库 | [gitcode.com/CPF-Flutter/flutter_flutter](https://gitcode.com/CPF-Flutter/flutter_flutter) |
52+| Flutter OH 开发示例与文档 | [gitcode.com/CPF-Flutter/flutter_samples](https://gitcode.com/CPF-Flutter/flutter_samples) |
53+| Flutter OH 三方库适配仓库 | [gitcode.com/CPF-Flutter/flutter_packages](https://gitcode.com/CPF-Flutter/flutter_packages) |
54+| OpenHarmony 平台已适配三方库列表 | [gitcode.com/CPF-Flutter/docs · ThirdpartyLibrarites](https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md) |
55+| 版本规划与分支策略 | [Flutter OH 版本规划 Wiki](https://gitcode.com/CPF-Flutter/flutter_flutter/wiki/Flutter-OH%E7%89%88%E6%9C%AC%E6%BC%94%E8%BF%9B%E8%A7%84%E5%88%92%E5%92%8C%E5%88%86%E6%94%AF%E7%AD%96%E7%95%A5.md) |
56+| Flutter 官方开发指南与 API 文档 | [docs.flutter.dev](https://docs.flutter.dev/) |
32 57 
33-| 序号 | 原库名 | 3.7推荐使用版本 | 3.22推荐使用版本 | 3.27推荐使用版本 | 3.35推荐使用版本 | 仓库名 | 状态 |58+---
34-| ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------ |
35-| 1 | [pigeon](https://pub.dev/packages/pigeon) | [14.0.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/pigeon) | [21.2.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/pigeon-v21.2.0/packages/pigeon) | [25.3.2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_pigeon-v25.3.2_ohos/packages/pigeon) | [26.1.5](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_pigeon-v26.1.5_ohos) | pigeon | 已适配 |
36-| 2 | [file_selector](https://pub.dev/packages/file_selector) | [1.0.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/file_selector) | [1.0.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_file_selector-v1.0.3_ohos/packages/file_selector) | [1.0.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_file_selector-v1.0.3_ohos/packages/file_selector) | [1.0.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_file_selector-v1.0.3_ohos) | file_selector | 已适配 |
37-| 3 | [image_picker](https://pub.dev/packages/image_picker) | [1.0.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/image_picker) | [1.1.2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_image_picker-v1.1.2_ohos/packages/image_picker) | [1.1.2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_image_picker-v1.1.2_ohos/packages/image_picker) | [1.2.1](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_image_picker-v1.2.1_ohos) | image_picker | 已适配 |
38-| 4 | [animations](https://pub.dev/packages/animations) | [2.0.8](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/animations) | [2.0.8](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/animations) | [2.0.11](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_animations-v2.0.11_ohos/packages/animations) | [2.0.11](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_animations-v2.0.11_ohos) | animations | 已适配 |
39-| 5 | [url_launcher](https://pub.dev/packages/url_launcher) | [6.1.11](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/url_launcher) | [6.3.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_url_launcher-v6.3.0_ohos) | [6.3.1](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_url_launcher_v6.3.1_ohos) | [6.3.2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_url_launcher-v6.3.2_ohos) | url_launcher | 已适配 |
40-| 6 | [shared_preferences](https://pub.dev/packages/shared_preferences) | [2.2.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/shared_preferences) | [2.3.2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_shared_preferences-v2.3.2_ohos/packages/shared_preferences) | [2.5.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_shared_preferences-v2.5.3_ohos/packages/shared_preferences) | [2.5.4](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_shared_preferences-v2.5.4_ohos) | shared_preferences | 已适配 |
41-| 7 | [path_provider](https://pub.dev/packages/path_provider) | [2.1.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/path_provider) | [2.1.4](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_path_provider-v2.1.4_ohos/packages/path_provider) | [2.1.5](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_path_provider-v2.1.5_ohos/packages/path_provider) | [2.1.5](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_path_provider-v2.1.5_ohos) | path_provider | 已适配 |
42-| 8 | [local_auth](https://pub.dev/packages/local_auth) | [2.1.6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/local_auth) | [2.3.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_local_auth-v2.3.0_ohos/packages/local_auth) | [2.3.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_local_auth-v2.3.0_ohos/packages/local_auth) | [3.0.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_local_auth-v3.0.0_ohos) | local_auth | 已适配 |
43-| 9 | [camera](https://pub.dev/packages/camera) | [0.10.5+5](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/camera) | [0.11.0+2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_camera-v0.11.0+2_ohos/packages/camera) | [0.11.1](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_camera-v0.11.1_ohos/packages/camera) | [0.11.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_camera-v0.11.3_ohos) | camera | 已适配 |
44-| 10 | [video_player](https://pub.dev/packages/video_player) | [2.7.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/video_player) | [2.9.2](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_video_player-v2.9.2_ohos/packages/video_player) | [2.10.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_video_player-v2.10.0_ohos/packages/video_player) | [2.10.1](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_video_player-v2.10.1_ohos) | video_player | 已适配 |
45-| 11 | [webview_flutter](https://pub.dev/packages/webview_flutter) | [4.4.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/webview_flutter) | [4.8.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_webview_flutter-v4.8.0_ohos/packages/webview_flutter) | [4.13.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_webview_flutter-v4.13.0_ohos/packages/webview_flutter) | [4.13.0](https://gitcode.com/openharmony-tpc/flutter_packages/commits/br_webview_flutter-v4.13.0_ohos) | webview_flutter | 已适配 |
46-| 12 | [webview_flutter-v4.4.4](https://pub.dev/packages/webview_flutter) | [4.4.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/webview_flutter-v4.4.4) | - | - | - | webview_flutter-v4.4.4 | 已适配 |
47-| 13 | [in_app_purchase](https://pub.dev/packages/in_app_purchase) | [3.1.11](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/in_app_purchase) | [3.2.0](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_in_app_purchase-v3.2.0_ohos/packages/in_app_purchase) | [3.2.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_in_app_purchase-v3.2.3_ohos/packages/in_app_purchase) | [3.2.3](https://gitcode.com/openharmony-tpc/flutter_packages/tree/br_in_app_purchase-v3.2.3_ohos/packages/in_app_purchase) | in_app_purchase | 已适配 |
48-| 14 | [css_colors](https://pub.dev/packages/css_colors) | [1.1.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/css_colors) | [1.1.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/css_colors) | [1.1.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/css_colors) | [1.1.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/css_colors) | css_colors | 已适配 |
49-| 15 | [espresso](https://pub.dev/packages/espresso) | [0.3.0+6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/espresso) | [0.3.0+6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/espresso) | [0.3.0+6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/espresso) | [0.3.0+6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/espresso) | espresso | 已适配 |
50-| 16 | [extension_google_sign_in_as_googleapis_auth](https://pub.dev/packages/extension_google_sign_in_as_googleapis_auth) | [2.0.11](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/extension_google_sign_in_as_googleapis_auth) | [2.0.11](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/extension_google_sign_in_as_googleapis_auth) | [2.0.11](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/extension_google_sign_in_as_googleapis_auth) | [2.0.11](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/extension_google_sign_in_as_googleapis_auth) | extension_google_sign_in_as_googleapis_auth | 已适配 |
51-| 17 | [flutter_adaptive_scaffold](https://pub.dev/packages/flutter_adaptive_scaffold) | [0.1.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_adaptive_scaffold) | [0.1.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_adaptive_scaffold) | [0.1.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_adaptive_scaffold) | [0.1.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_adaptive_scaffold) | flutter_adaptive_scaffold | 已适配 |
52-| 18 | [flutter_image](https://pub.dev/packages/flutter_image) | [4.1.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_image) | [4.1.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_image) | [4.1.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_image) | [4.1.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_image) | flutter_image | 已适配 |
53-| 19 | [flutter_lints](https://pub.dev/packages/flutter_lints) | [2.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_lints) | [2.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_lints) | [2.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_lints) | [2.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_lints) | flutter_lints | 已适配 |
54-| 20 | [flutter_markdown](https://pub.dev/packages/flutter_markdown) | [0.6.15](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_markdown) | [0.6.15](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_markdown) | [0.6.15](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_markdown) | [0.6.15](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_markdown) | flutter_markdown | 已适配 |
55-| 21 | [flutter_migrate](https://pub.dev/packages/flutter_migrate) | [0.1.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_migrate) | [0.1.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_migrate) | [0.1.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_migrate) | [0.1.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_migrate) | flutter_migrate | 已适配 |
56-| 22 | [flutter_plugin_android_lifecycle](https://pub.dev/packages/flutter_plugin_android_lifecycle) | [2.0.17](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_plugin_android_lifecycle) | [2.0.17](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_plugin_android_lifecycle) | [2.0.17](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_plugin_android_lifecycle) | [2.0.17](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_plugin_android_lifecycle) | flutter_plugin_android_lifecycle | 已适配 |
57-| 23 | [flutter_template_images](https://pub.dev/packages/flutter_template_images) | [4.2.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_template_images) | [4.2.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_template_images) | [4.2.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_template_images) | [4.2.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/flutter_template_images) | flutter_template_images | 已适配 |
58-| 24 | [go_router](https://pub.dev/packages/go_router) | [12.1.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router) | [12.1.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router) | [12.1.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router) | [12.1.1](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router) | go_router | 已适配 |
59-| 25 | [go_router_builder](https://pub.dev/packages/go_router_builder) | [2.3.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router_builder) | [2.3.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router_builder) | [2.3.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router_builder) | [2.3.4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/go_router_builder) | go_router_builder | 已适配 |
60-| 26 | [google_identity_services_web](https://pub.dev/packages/google_identity_services_web) | [0.2.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_identity_services_web) | [0.2.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_identity_services_web) | [0.2.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_identity_services_web) | [0.2.2](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_identity_services_web) | google_identity_services_web | 已适配 |
61-| 27 | [google_maps_flutter](https://pub.dev/packages/google_maps_flutter) | [2.3.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_maps_flutter) | [2.3.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_maps_flutter) | [2.3.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_maps_flutter) | [2.3.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_maps_flutter) | google_maps_flutter | 已适配 |
62-| 28 | [google_sign_in](https://pub.dev/packages/google_sign_in) | [6.1.6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_sign_in) | [6.1.6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_sign_in) | [6.1.6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_sign_in) | [6.1.6](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/google_sign_in) | google_sign_in | 已适配 |
63-| 29 | [ios_platform_images](https://pub.dev/packages/ios_platform_images) | [0.2.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/ios_platform_images) | [0.2.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/ios_platform_images) | [0.2.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/ios_platform_images) | [0.2.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/ios_platform_images) | ios_platform_images | 已适配 |
64-| 30 | [metrics_center](https://pub.dev/packages/metrics_center) | [1.0.12](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/metrics_center) | [1.0.12](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/metrics_center) | [1.0.12](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/metrics_center) | [1.0.12](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/metrics_center) | metrics_center | 已适配 |
65-| 31 | [multicast_dns](https://pub.dev/packages/multicast_dns) | [0.3.2+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/multicast_dns) | [0.3.2+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/multicast_dns) | [0.3.2+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/multicast_dns) | [0.3.2+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/multicast_dns) | multicast_dns | 已适配 |
66-| 32 | [palette_generator](https://pub.dev/packages/palette_generator) | [0.3.3+3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/palette_generator) | [0.3.3+3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/palette_generator) | [0.3.3+3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/palette_generator) | [0.3.3+3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/palette_generator) | palette_generator | 已适配 |
67-| 33 | [pointer_interceptor](https://pub.dev/packages/pointer_interceptor) | [0.9.3+5](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/pointer_interceptor) | [0.9.3+5](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/pointer_interceptor) | [0.9.3+5](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/pointer_interceptor) | [0.9.3+5](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/pointer_interceptor) | pointer_interceptor | 已适配 |
68-| 34 | [rfw](https://pub.dev/packages/rfw) | [1.0.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/rfw) | [1.0.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/rfw) | [1.0.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/rfw) | [1.0.9](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/rfw) | rfw | 已适配 |
69-| 35 | [standard_message_codec](https://pub.dev/packages/standard_message_codec) | [0.0.1+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/standard_message_codec) | [0.0.1+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/standard_message_codec) | [0.0.1+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/standard_message_codec) | [0.0.1+4](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/standard_message_codec) | standard_message_codec | 已适配 |
70-| 36 | [two_dimensional_scrollables](https://pub.dev/packages/two_dimensional_scrollables) | - | - | - | - | [two_dimensional_scrollables](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/two_dimensional_scrollables) | 未适配 |
71-| 37 | [web_benchmarks](https://pub.dev/packages/web_benchmarks) | [0.1.0+8](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/web_benchmarks) | [0.1.0+8](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/web_benchmarks) | [0.1.0+8](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/web_benchmarks) | [0.1.0+8](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/web_benchmarks) | web_benchmarks | 已适配 |
72-| 38 | [webview_flutter_platform_interface](https://pub.dev/packages/webview_flutter_platform_interface) | [2.6.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/webview_flutter_platform_interface-v2.10.0) | [2.6.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/webview_flutter_platform_interface-v2.10.0) | [2.6.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/webview_flutter_platform_interface-v2.10.0) | [2.6.0](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/webview_flutter_platform_interface-v2.10.0) | webview_flutter_platform_interface | 已适配 |
73-| 39 | [xdg_directories](https://pub.dev/packages/xdg_directories) | [1.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/xdg_directories) | [1.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/xdg_directories) | [1.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/xdg_directories) | [1.0.3](https://gitcode.com/openharmony-sig/flutter_packages/tree/master/packages/xdg_directories) | xdg_directories | 已适配 |
74 59 
75-# 社区交流60+## 跨平台框架技术选型
76 61 
77-- 微信群:待补充62+为破解原生开发痛点,行业持续迭代演进跨平台技术方案,主流框架已形成多元格局:
78-- 邮件列表:待补充63+ 
64+- **基于 Web 技术的跨端方案**:如 uni-app、Electron、各类小程序框架,延续 BS 架构优势并适配移动生态
65+- **React Native**:通过 DSL 描述 UI 并采用原生组件渲染,提升性能与原生 API 调用体验
66+- **Flutter**:以 Dart 语言与自渲染引擎为核心,实现接近原生的性能表现并覆盖移动与桌面场景
67+- **Kotlin Multiplatform(KMP)与 Compose Multiplatform(CMP)**:以逻辑跨端为突破,叠加 UI 跨端能力,获得企业级开发者广泛认可
68+ 
69+> 详情请参见:[开源鸿蒙跨平台框架社区正式发布《跨平台框架白皮书》](https://openharmonycrossplatform.csdn.net/6a1d3e4810ee7a33f276c2c5.html)
70+ 
71+---
72+ 
73+## 版本规划与分支策略
74+ 
75+### 稳定版本
76+ 
77+推荐基于版本tag获取稳定版本,版本tag格式如下:
78+- 3.7.12-ohos-X.X.X: 基于上游社区3.7.12分支适配OpenHarmony的X.X.X版本。
79+- 3.22.1-ohos-X.X.X: 基于上游社区3.22.0分支适配OpenHarmony的X.X.X版本。
80+- 3.27.5-ohos-X.X.X: 基于上游社区3.27.4分支适配OpenHarmony的X.X.X版本。
81+- 3.35.8-ohos-X.X.X: 基于上游社区3.35.7分支适配OpenHarmony的X.X.X版本。
82+ 
83+### 版本规划
84+ 
85+| Flutter 版本 | 源社区发布时间 | 鸿蒙版本发布时间 | 间隔时间 |
86+| :----------- | :------------- | :--------------- | -------- |
87+| Flutter 3.35 | 2025/08 | 2026/03 | 7个月 |
88+| Flutter 3.41 | 2026/02 | 2026/06 | 4个月 |
89+| Flutter 3.44 | 2026/05 | 2026/09 | 4个月 |
90+| Flutter 3.47 | 2026/08 | 2026/12 | 4个月 |
91+ 
92+*注:以上时间为预估,实际发版可能会根据质量验收情况及交付规划微调。*
93+ 
94+> 详情请参见:[Flutter OH 版本规划与分支策略](https://gitcode.com/CPF-Flutter/flutter_flutter/wiki/Flutter-OH%E7%89%88%E6%9C%AC%E6%BC%94%E8%BF%9B%E8%A7%84%E5%88%92%E5%92%8C%E5%88%86%E6%94%AF%E7%AD%96%E7%95%A5.md)
95+ 
96+---
97+ 
98+## 相关文档
99+ 
100+Flutter OH 配套文档位于 [flutter_samples](https://gitcode.com/CPF-Flutter/flutter_samples) 仓库,覆盖从快速入门到性能调优、调试调测的全流程实践。
101+ 
102+---
103+ 
104+## 三方库适配
105+ 
106+[flutter_packages](https://gitcode.com/CPF-Flutter/flutter_packages) 基于 Flutter 社区官方插件库([flutter/packages](https://github.com/flutter/packages/))扩展,新增对 OpenHarmony 平台的兼容适配。开发者可通过 Git 仓库引入适配后的插件,以最小化业务改动获得完整的 OpenHarmony 原生能力支持。
107+ 
108+### 已适配核心三方库
109+ 
110+按三方库聚合,列出每个 Flutter SDK 版本对应的推荐版本。链接指向对应的发布 Tag 或分支(无 Tag 的标为「分支」)。
111+ 
112+| 序号 | 原库名 | Flutter 3.7 | Flutter 3.22 | Flutter 3.27 | Flutter 3.35 |
113+| :--: | --- | --- | --- | --- | --- |
114+| 1 | pigeon | [14.0.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/pigeon-v14.0.0-ohos-1.0.0/packages/pigeon) | [21.2.0 *](https://gitcode.com/CPF-Flutter/flutter_packages/tree/pigeon-v21.2.0/packages/pigeon) | [25.3.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/pigeon-v25.3.2-ohos-1.0.0/packages/pigeon) | [26.1.5](https://gitcode.com/CPF-Flutter/flutter_packages/tree/pigeon-v26.1.5-ohos-1.0.0/packages/pigeon) |
115+| 2 | file_selector | [1.0.1](https://gitcode.com/CPF-Flutter/flutter_packages/tree/file_selector-v1.0.1-ohos-1.0.0/packages/file_selector/file_selector) | [1.0.3](https://gitcode.com/CPF-Flutter/flutter_packages/tree/file_selector-v1.0.3-ohos-1.0.0/packages/file_selector/file_selector) | [1.0.3](https://gitcode.com/CPF-Flutter/flutter_packages/tree/file_selector-v1.0.3-ohos-1.0.0/packages/file_selector/file_selector) | [1.1.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/file_selector-v1.1.0-ohos-1.0.0/packages/file_selector/file_selector) |
116+| 3 | image_picker | [1.0.4](https://gitcode.com/CPF-Flutter/flutter_packages/tree/image_picker-v1.0.4-ohos-1.0.0/packages/image_picker/image_picker) | [1.1.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/image_picker-v1.1.2-ohos-1.0.0/packages/image_picker/image_picker) | [1.1.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/image_picker-v1.1.2-ohos-1.0.0/packages/image_picker/image_picker) | [1.2.1](https://gitcode.com/CPF-Flutter/flutter_packages/tree/image_picker-v1.2.1-ohos-1.0.0/packages/image_picker/image_picker) |
117+| 4 | animations | — | — | [2.0.11 *](https://gitcode.com/CPF-Flutter/flutter_packages/tree/br_animations-v2.0.11_ohos/packages/animations) | [2.0.11 *](https://gitcode.com/CPF-Flutter/flutter_packages/tree/br_animations-v2.0.11_ohos/packages/animations) |
118+| 5 | url_launcher | [6.1.11](https://gitcode.com/CPF-Flutter/flutter_packages/tree/url_launcher_v6.1.11-ohos-1.0.0/packages/url_launcher/url_launcher) | [6.3.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/url_launcher_v6.3.0-ohos-1.0.0/packages/url_launcher/url_launcher) | [6.3.1](https://gitcode.com/CPF-Flutter/flutter_packages/tree/url_launcher_v6.3.1-ohos-1.0.0/packages/url_launcher/url_launcher) | [6.3.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/url_launcher_v6.3.2-ohos-1.0.0/packages/url_launcher/url_launcher) |
119+| 6 | shared_preferences | [2.2.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/shared_preferences-v2.2.2-ohos-1.0.0/packages/shared_preferences/shared_preferences) | [2.3.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/shared_preferences-v2.3.2-ohos-1.0.0/packages/shared_preferences/shared_preferences) | [2.5.3](https://gitcode.com/CPF-Flutter/flutter_packages/tree/shared_preferences-v2.5.3-ohos-1.0.0/packages/shared_preferences/shared_preferences) | [2.5.4](https://gitcode.com/CPF-Flutter/flutter_packages/tree/shared_preferences-v2.5.4-ohos-1.0.0/packages/shared_preferences/shared_preferences) |
120+| 7 | path_provider | [2.1.1](https://gitcode.com/CPF-Flutter/flutter_packages/tree/provider-v2.1.1-ohos-1.0.0/packages/path_provider/path_provider) | [2.1.4](https://gitcode.com/CPF-Flutter/flutter_packages/tree/provider-v2.1.4-ohos-1.0.0/packages/path_provider/path_provider) | [2.1.5](https://gitcode.com/CPF-Flutter/flutter_packages/tree/provider-v2.1.5-ohos-1.0.0/packages/path_provider/path_provider) | [2.1.5](https://gitcode.com/CPF-Flutter/flutter_packages/tree/provider-v2.1.5-ohos-1.0.0/packages/path_provider/path_provider) |
121+| 8 | local_auth | [2.1.6](https://gitcode.com/CPF-Flutter/flutter_packages/tree/local_auth-v2.1.6-ohos-1.0.0/packages/local_auth/local_auth) | [2.3.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/local_auth-v2.3.0-ohos-1.0.0/packages/local_auth/local_auth) | [2.3.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/local_auth-v2.3.0-ohos-1.0.0/packages/local_auth/local_auth) | [3.0.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/local_auth-v3.0.0-ohos-1.0.0/packages/local_auth/local_auth) |
122+| 9 | camera | [0.10.5+5](https://gitcode.com/CPF-Flutter/flutter_packages/tree/camera-v0.10.5_5-ohos-1.0.0/packages/camera/camera) | [0.11.0+2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/camera-v0.11.0_2-ohos-1.0.0/packages/camera/camera) | [0.11.1](https://gitcode.com/CPF-Flutter/flutter_packages/tree/camera-v0.11.1-ohos-1.0.0/packages/camera/camera) | [0.11.3](https://gitcode.com/CPF-Flutter/flutter_packages/tree/camera-v0.11.3-ohos-1.0.0/packages/camera/camera) |
123+| 10 | video_player | [2.7.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/video_player-v2.7.2-ohos-1.0.0/packages/video_player/video_player) | [2.9.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/video_player-v2.9.2-ohos-1.0.0/packages/video_player/video_player) | [2.10.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/video_player-v2.10.0-ohos-1.0.0/packages/video_player/video_player) | [2.10.1](https://gitcode.com/CPF-Flutter/flutter_packages/tree/video_player-v2.10.1-ohos-1.0.0/packages/video_player/video_player) |
124+| 11 | webview_flutter | [4.4.2](https://gitcode.com/CPF-Flutter/flutter_packages/tree/webview_flutter-v4.4.2-ohos-1.0.0/packages/webview_flutter/webview_flutter) | [4.8.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/webview_flutter-v4.8.0-ohos-1.0.0/packages/webview_flutter/webview_flutter) | [4.13.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/webview_flutter-v4.13.0-ohos-1.0.0/packages/webview_flutter/webview_flutter) | [4.13.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/webview_flutter-v4.13.0-ohos-1.0.0/packages/webview_flutter/webview_flutter) |
125+| 12 | in_app_purchase | [3.1.11](https://gitcode.com/CPF-Flutter/flutter_packages/tree/in_app_purchase_v3.1.11-ohos-1.0.0/packages/in_app_purchase/in_app_purchase) | [3.2.0](https://gitcode.com/CPF-Flutter/flutter_packages/tree/in_app_purchase_v3.2.0-ohos-1.0.0/packages/in_app_purchase/in_app_purchase) | [3.2.3](https://gitcode.com/CPF-Flutter/flutter_packages/tree/in_app_purchase_v3.2.3-ohos-1.0.0/packages/in_app_purchase/in_app_purchase) | [3.2.3](https://gitcode.com/CPF-Flutter/flutter_packages/tree/in_app_purchase_v3.2.3-ohos-1.0.0/packages/in_app_purchase/in_app_purchase) |
126+ 
127+> 注:`*` 表示该版本仅有 release 分支,未发布 Tag;`—` 表示该 Flutter SDK 版本下未提供适配版本。
128+>
129+> 另:`webview_flutter-v4.4.4`(4.4.4 版本)仅在 [master 分支](https://gitcode.com/CPF-Flutter/flutter_packages/tree/master/packages/webview_flutter-v4.4.4) 维护。
130+>
131+> 完整三方库适配列表(含 dev/release 分支信息):[OpenHarmony 平台已适配三方库列表](https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md)
132+> 三方库问题请在对应仓库提交 issue;三方库适配请求请至 [CPF-Flutter/docs](https://gitcode.com/CPF-Flutter/docs/issues) 提交 issue。
133+ 
134+#### 纯 Dart 三方库
135+ 
136+以下三方库为纯 Dart 实现,无需平台适配,OpenHarmony 平台可直接使用:
137+ 
138+`css_colors`、`flutter_adaptive_scaffold`、`flutter_image`、`flutter_lints`、`flutter_markdown`、`flutter_migrate`、`go_router`、`go_router_builder`、`metrics_center`、`multicast_dns`、`palette_generator`、`pointer_interceptor`、`rfw`、`standard_message_codec`、`two_dimensional_scrollables`、`web_benchmarks`、`xdg_directories`
139+ 
140+### 引用方式
141+ 
142+适配了 OpenHarmony 的三方库需通过 Git 仓库引入:
143+ 
144+```yaml
145+dependencies:
146+ path_provider:
147+ git:
148+ url: https://gitcode.com/CPF-Flutter/flutter_packages.git
149+ path: packages/path_provider/path_provider
150+ ref: provider-v2.1.5-ohos-1.0.0 # 推荐使用 tag
151+```
152+ 
153+### 贡献指南
154+ 
155+本仓库采用多分支管理策略,**每个三方库版本都有对应的 dev 分支和 release 分支**:
156+ 
157+| 分支名 | 命名格式 |
158+| --- | --- |
159+| dev 分支 | `br_<库名>-v<版本号>_ohos_dev` |
160+| release 分支 | `br_<库名>-v<版本号>_ohos` |
161+ 
162+贡献代码时请基于对应版本的 **dev 分支** 开发并提交 PR;release 分支为发布分支,不接受直接提交 PR。
163+ 
164+---
165+ 
166+## 问题定位
167+ 
168+Flutter OHOS 平台的问题定位、稳定性修复与方法论,请参见 [Flutter OHOS 问题定位导航](https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/docs/ohos/troubleshooting/README.md)。
169+ 
170+### Flutter OHOS 历史修复汇总
171+ 
172+按 Flutter OHOS 版本(3.27 / 3.35 / 3.41)汇总 OHOS 平台已修复的稳定性问题,覆盖崩溃、冻屏、内存、键盘输入、渲染、PlatformView、窗口屏幕、手势鼠标、输入法文本、LTPO/帧率、Plugin/Channel 等 12 大类问题。数据来源于 [flutter_flutter](https://gitcode.com/CPF-Flutter/flutter_flutter) 与 [flutter_engine](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release/engine) 两个仓库,3.35 之前分仓维护,3.35 之后合仓。
173+ 
174+👉 详情参见:[Flutter OHOS 历史修复汇总](https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/docs/ohos/troubleshooting/fix-history/README.md)
175+ 
176+### Skill 资源汇总
177+ 
178+| 来源 | 链接 |
179+| --- | --- |
180+| CPF-Flutter Skill 总仓库 | [gitcode.com/CPF-Flutter/skills](https://gitcode.com/CPF-Flutter/skills) |
181+| flutter_samples 文档配套 Skill | [docs/ohos/skills](https://gitcode.com/CPF-Flutter/flutter_samples/tree/master/docs/ohos/skills) |
182+ 
183+> 更多常见问题请参见 [FAQ](https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/docs/ohos/faq/README.md)
184+ 
185+---
186+ 
187+## 问题交流
188+ 
189+- **问题反馈**:欢迎在 [Flutter 框架仓库 Issues](https://gitcode.com/CPF-Flutter/flutter_flutter/issues) 以及各个 Flutter 三方库仓库提交 issue。
190+- **版本与文档**:[flutter_flutter README](https://gitcode.com/CPF-Flutter/flutter_flutter/blob/oh-3.35.7-release/README.md) | [flutter_samples README](https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/README.md) | [flutter_packages README](https://gitcode.com/CPF-Flutter/flutter_packages/blob/master/README.md)
191+- **贡献指南**:如果您想为 Flutter-OH 贡献代码,请参考 [Flutter-OH 代码合入流程](https://gitcode.com/CPF-Flutter/flutter_flutter/wiki/Flutter_OH%E4%BB%93%E5%BA%93%E4%BB%A3%E7%A0%81%E5%90%88%E5%85%A5%E6%B5%81%E7%A8%8B.md)。
192+ 
193+---
194+ 
195+Built with ❤️ by OpenHarmony Flutter 社区