# cpf_flutter_packages **Repository Path**: flyelf/cpf_flutter_packages ## Basic Information - **Project Name**: cpf_flutter_packages - **Description**: No description available - **Primary Language**: Unknown - **License**: BSD-3-Clause - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-09 - **Last Updated**: 2026-10-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Flutter Packages > **仓库迁移公告**:本仓库(`openharmony-tpc/flutter_packages`)计划于 **2026年6月10日** 迁移至 [CPF-Flutter/flutter_packages](https://gitcode.com/CPF-Flutter/flutter_packages),届时旧仓库地址将自动重定向至新地址。迁移后请及时更新 Git 远程地址及项目中的依赖引用。详情参见:[迁移公告](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) ## 仓库介绍 本仓库基于 Flutter 社区官方插件库([flutter/packages](https://github.com/flutter/packages/))进行扩展,新增对 OpenHarmony 平台的兼容适配。通过本仓库,开发者可在 Flutter 应用中无缝集成常用插件,通过最小化业务改动获得完整的OpenHarmony原生能力支持。 [OpenHarmony平台已适配packages三方库](#packages) [OpenHarmony平台已适配三方库列表](https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md) > 三方库问题请在对应仓库提交 issue;三方库适配请求请至 [CPF-Flutter](https://gitcode.com/CPF-Flutter/docs/issues) 组织提交 issue。 ## 贡献指南 本仓库采用多分支管理策略,**每个三方库版本都有对应的 dev 分支和release分支:** | 分支名 | 命名格式 | | ------------ | ------------------------------ | | dev 分支 | `br_<库名>-v<版本号>_ohos_dev` | | release 分支 | `br_<库名>-v<版本号>_ohos` | **开发者贡献代码时,请遵循以下流程:** 1. **确定目标分支**:根据您要修改的三方库及版本,找到对应的 dev 分支。 2. **基于 dev 分支开发**:fork 从对应的 dev 分支进行开发。 3. **提交 PR:将代码变更提交到对应的 **dev 分支**。 > **注意**:release 分支为发布分支,不接受直接提交PR。所有代码贡献请务必提交到对应三方库版本的 dev 分支上。 ## 开始使用 使用本仓库插件前,请确保已完成 Flutter SDK 的 OpenHarmony 环境配置。 - **环境搭建** 参考 [flutter_flutter](https://gitcode.com/openharmony-tpc/flutter_flutter) 仓库文档 `【环境配置】`。 - **示例参考** 前往 [flutter_samples](https://gitcode.com/openharmony-tpc/flutter_samples) 仓库获取集成示例 Demo。 ## 引用方式 适配了OpenHarmony的三方库需通过Git仓库引入。除必填的 `url` 外,常用参数如下: - `path` : 库在仓库中的实际路径,否则可能找不到 `pubspec.yaml`。 - `ref`(可选) : 指定要拉取的版本,可以是 **分支名**、**标签(tag)** 或 **commit id**,不写则使用仓库默认分支,推荐使用**标签(tag)**。 **按标签引用(tag):** ```yaml dev_dependencies: pigeon: git: url: https://gitcode.com/openharmony-tpc/flutter_packages.git path: packages/pigeon ref: pigeon-v26.1.5-ohos-1.0.0 # 发布标签 ``` **按分支引用(branch):** ```yaml dev_dependencies: pigeon: git: url: https://gitcode.com/openharmony-tpc/flutter_packages.git path: packages/pigeon ref: pigeon-v21.2.0 # 分支名 ``` ## 使用示例 ### 一、工具库pigeon使用 1. 引入pigeon库,在pubspec.yaml中dev_dependencies新增配置: ```yaml dev_dependencies: pigeon: git: url: https://gitcode.com/openharmony-tpc/flutter_packages.git path: packages/pigeon ref: pigeon-v26.1.5-ohos-1.0.0 ``` 2. 项目根目录运行 `flutter pub get`。 3. 项目根目录运行 `flutter pub run pigeon --input --arkts_out `,将会生成Flutter与OpenHarmony平台通信的模板代码。 4. 调用示例,参考packages/pigeon/example/app/ohos/entry/src/main/ets/plugins/MessagePlugin.ets。 ### 二、 插件库使用 以 path_provider 举例: 1. 在引用的项目中,pubspec.yaml中dependencies新增配置: ```yaml dependencies: path_provider: git: url: https://gitcode.com/openharmony-tpc/flutter_packages.git path: packages/path_provider/path_provider ref: provider-v2.1.5-ohos-1.0.0 ``` 2. 项目根目录运行 `flutter pub get`,ohos/entry/oh-package.json5会自动添加相关插件har依赖。 3. 在业务代码中调用path_provider相关api,它会在OpenHarmony平台正常运行。 示例:在某个Flutter兼容OpenHarmony项目中加入支持OpenHarmony平台的path_provider库依赖。 可参考示例:[pictures_provider_demo](https://gitcode.com/openharmony-tpc/flutter_samples/tree/master/ohos/pictures_provider_demo) ## OpenHarmony平台已适配packages三方库
序号 原库名 Flutter框架推荐版本 原库版本 release分支 dev分支 tag1 tag2 状态
1 pigeon 3.7 14.0.0 master dev pigeon-v14.0.0-ohos-1.0.1pigeon-v14.0.0-ohos-1.0.2 已适配
3.22 21.2.0 pigeon-v21.2.0 pigeon-v21.2.0_dev -- 已适配
3.27 25.3.2 br_pigeon-v25.3.2_ohos br_pigeon-v25.3.2_ohos_dev pigeon-v25.3.2-ohos-1.0.1pigeon-v25.3.2-ohos-1.0.2 已适配
3.35 26.1.5 br_pigeon-v26.1.5_ohos br_pigeon-v26.1.5_ohos_dev pigeon-v26.1.5-ohos-1.0.1pigeon-v26.1.5-ohos-1.0.2 已适配
3.41 26.3.4 br_pigeon-v26.3.4_ohos br_pigeon-v26.3.4_ohos_dev pigeon-v26.3.4-ohos-1.0.0pigeon-v26.3.4-ohos-1.0.0 已适配
2 file_selector 3.7 1.0.1 master dev file_selector-v1.0.1-ohos-1.0.1file_selector-v1.0.1-ohos-1.0.1 已适配
3.22 1.0.3 br_file_selector-v1.0.3_ohos br_file_selector-v1.0.3_ohos_dev file_selector-v1.0.3-ohos-1.0.1file_selector-v1.0.3-ohos-1.0.1 已适配
3.27 1.0.3 br_file_selector-v1.0.3_ohos br_file_selector-v1.0.3_ohos_dev file_selector-v1.0.3-ohos-1.0.1file_selector-v1.0.3-ohos-1.0.1 已适配
3.35 1.1.0 br_file_selector-v1.1.0_ohos br_file_selector-v1.1.0_ohos_dev file_selector-v1.1.0-ohos-1.0.1file_selector-v1.1.0-ohos-1.0.2 已适配
3.41 1.1.0 br_file_selector-v1.1.0_ohos br_file_selector-v1.1.0_ohos_dev file_selector-v1.1.0-ohos-1.0.1file_selector-v1.1.0-ohos-1.0.2 已适配
3 image_picker 3.7 1.0.4 master dev image_picker-v1.0.4-ohos-1.0.1image_picker-v1.0.4-ohos-1.0.1 已适配
3.22 1.1.2 br_image_picker-v1.1.2_ohos br_image_picker-v1.1.2_ohos_dev image_picker-v1.1.2-ohos-1.0.1image_picker-v1.1.2-ohos-1.0.1 已适配
3.27 1.1.2 br_image_picker-v1.1.2_ohos br_image_picker-v1.1.2_ohos_dev image_picker-v1.1.2-ohos-1.0.1image_picker-v1.1.2-ohos-1.0.1 已适配
3.35 1.2.1 br_image_picker-v1.2.1_ohos br_image_picker-v1.2.1_ohos_dev image_picker-v1.2.1-ohos-1.0.1image_picker-v1.2.1-ohos-1.0.1 已适配
3.41 1.2.1 br_image_picker-v1.2.1_ohos br_image_picker-v1.2.1_ohos_dev image_picker-v1.2.1-ohos-1.0.1image_picker-v1.2.1-ohos-1.0.1 已适配
4 animations 3.7 - master dev - - -
3.22 - master dev - - -
3.27 2.0.11 br_animations-v2.0.11_ohos - - - -
3.35 2.0.11 br_animations-v2.0.11_ohos - - - -
5 url_launcher 3.7 6.1.11 master dev url_launcher_v6.1.11-ohos-1.0.1url_launcher_v6.1.11-ohos-1.0.1 已适配
3.22 6.3.0 br_url_launcher-v6.3.0_ohos br_url_launcher-v6.3.0_ohos_dev url_launcher_v6.3.0-ohos-1.0.1url_launcher_v6.3.0-ohos-1.0.2 已适配
3.27 6.3.1 br_url_launcher_v6.3.1_ohos br_url_launcher_v6.3.1_ohos_dev url_launcher_v6.3.1-ohos-1.0.1url_launcher_v6.3.1-ohos-1.0.1 已适配
3.35 6.3.2 br_url_launcher-v6.3.2_ohos br_url_launcher-v6.3.2_ohos_dev url_launcher_v6.3.2-ohos-1.0.1url_launcher_v6.3.2-ohos-1.0.2 已适配
3.41 6.3.2 br_url_launcher-v6.3.2_ohos br_url_launcher-v6.3.2_ohos_dev url_launcher_v6.3.2-ohos-1.0.1url_launcher_v6.3.2-ohos-1.0.2 已适配
6 shared_preferences 3.7 2.2.2 master dev shared_preferences-v2.2.2-ohos-1.0.1shared_preferences-v2.2.2-ohos-1.0.1 已适配
3.22 2.3.2 br_shared_preferences-v2.3.2_ohos br_shared_preferences-v2.3.2_ohos_dev shared_preferences-v2.3.2-ohos-1.0.1shared_preferences-v2.3.2-ohos-1.0.1 已适配
3.27 2.5.3 br_shared_preferences-v2.5.3_ohos br_shared_preferences-v2.5.3_ohos_dev shared_preferences-v2.5.3-ohos-1.0.1shared_preferences-v2.5.3-ohos-1.0.1 已适配
3.35 2.5.4 br_shared_preferences-v2.5.4_ohos br_shared_preferences-v2.5.4_ohos_dev shared_preferences-v2.5.4-ohos-1.0.1shared_preferences-v2.5.4-ohos-1.0.1 已适配
3.41 2.5.4 br_shared_preferences-v2.5.4_ohos br_shared_preferences-v2.5.4_ohos_dev shared_preferences-v2.5.4-ohos-1.0.1shared_preferences-v2.5.4-ohos-1.0.1 已适配
7 path_provider 3.7 2.1.1 master dev provider-v2.1.1-ohos-1.0.1provider-v2.1.1-ohos-1.0.1 已适配
3.22 2.1.4 br_path_provider-v2.1.4_ohos br_path_provider-v2.1.4_ohos_dev provider-v2.1.4_ohos-1.0.1provider-v2.1.4_ohos-1.0.1 已适配
3.27 2.1.5 br_path_provider-v2.1.5_ohos br_path_provider-v2.1.5_ohos_dev provider-v2.1.5-ohos-1.0.1provider-v2.1.5-ohos-1.0.1 已适配
3.35 2.1.5 br_path_provider-v2.1.5_ohos br_path_provider-v2.1.5_ohos_dev provider-v2.1.5-ohos-1.0.1provider-v2.1.5-ohos-1.0.1 已适配
3.41 2.1.5 br_path_provider-v2.1.5_ohos br_path_provider-v2.1.5_ohos_dev provider-v2.1.5-ohos-1.0.1provider-v2.1.5-ohos-1.0.1 已适配
8 local_auth 3.7 2.1.6 master dev local_auth-v2.1.6-ohos-1.0.1local_auth-v2.1.6-ohos-1.0.1 已适配
3.22 2.3.0 br_local_auth-v2.3.0_ohos br_local_auth-v2.3.0_ohos_dev local_auth-v2.3.0-ohos-1.0.1local_auth-v2.3.0-ohos-1.0.1 已适配
3.27 2.3.0 br_local_auth-v2.3.0_ohos br_local_auth-v2.3.0_ohos_dev local_auth-v2.3.0-ohos-1.0.1local_auth-v2.3.0-ohos-1.0.1 已适配
3.35 3.0.0 br_local_auth-v3.0.0_ohos br_local_auth-v3.0.0_ohos_dev local_auth-v3.0.0-ohos-1.0.1local_auth-v3.0.0-ohos-1.0.1 已适配
3.41 3.0.1 br_local_auth-v3.0.1_ohos br_local_auth-v3.0.1_ohos_dev local_auth-v3.0.1-ohos-1.0.0local_auth-v3.0.1-ohos-1.0.0 已适配
9 camera 3.7 0.10.5+5 master dev camera-v0.10.5_5-ohos-1.0.1camera-v0.10.5_5-ohos-1.0.1 已适配
3.22 0.11.0+2 br_camera-v0.11.0+2_ohos br_camera-v0.11.0_2_ohos_dev camera-v0.11.0_2-ohos-1.0.1camera-v0.11.0_2-ohos-1.0.2 已适配
3.27 0.11.1 br_camera-v0.11.1_ohos br_camera-v0.11.1_ohos_dev camera-v0.11.1-ohos-1.0.1camera-v0.11.1-ohos-1.0.2 已适配
3.35 0.11.3 br_camera-v0.11.3_ohos br_camera-v0.11.3_ohos_dev camera-v0.11.3-ohos-1.0.1camera-v0.11.3-ohos-1.0.1 已适配
3.41 0.12.0+1 br_camera-v0.12.0_1_ohos br_camera-v0.12.0+1_ohos_dev camera-v0.12.0_1-ohos-1.0.0camera-v0.12.0_1-ohos-1.0.0 已适配
10 video_player 3.7 2.7.2 master dev video_player-v2.7.2-ohos-1.0.1video_player-v2.7.2-ohos-1.0.1 已适配
3.22 2.9.2 br_video_player-v2.9.2_ohos br_video_player-v2.9.2_ohos_dev video_player-v2.9.2-ohos-1.0.1video_player-v2.9.2-ohos-1.0.1 已适配
3.27 2.10.0 br_video_player-v2.10.0_ohos br_video_player-v2.10.0_ohos_dev video_player-v2.10.0-ohos-1.0.1video_player-v2.10.0-ohos-1.0.1 已适配
3.35 2.10.1 br_video_player-v2.10.1_ohos br_video_player-v2.10.1_ohos_dev video_player-v2.10.1-ohos-1.0.1video_player-v2.10.1-ohos-1.0.1 已适配
3.41 2.11.1 br_video_player-v2.11.1_ohos br_video_player-v2.11.1_ohos_dev video_player-v2.11.1-ohos-1.0.0video_player-v2.11.1-ohos-1.0.0 已适配
11 webview_flutter 3.7 4.4.2 master dev webview_flutter-v4.4.2-ohos-1.0.1webview_flutter-v4.4.2-ohos-1.0.2 已适配
3.22 4.8.0 br_webview_flutter-v4.8.0_ohos br_webview_flutter-v4.8.0_ohos_dev webview_flutter-v4.8.0-ohos-1.0.1webview_flutter-v4.8.0-ohos-1.0.2 已适配
3.27 4.13.0 br_webview_flutter-v4.13.0_ohos br_webview_flutter-v4.13.0_ohos_dev webview_flutter-v4.13.0-ohos-1.0.1webview_flutter-v4.13.0-ohos-1.0.2 已适配
3.35 4.13.0 br_webview_flutter-v4.13.0_ohos br_webview_flutter-v4.13.0_ohos_dev webview_flutter-v4.13.0-ohos-1.0.1webview_flutter-v4.13.0-ohos-1.0.2 已适配
3.41 4.13.1 br_webview_flutter-v4.13.1_ohos br_webview_flutter-v4.13.1_ohos_dev webview_flutter-v4.13.1-ohos-1.0.1webview_flutter-v4.13.1-ohos-1.0.2 已适配
12 webview_flutter-v4.4.4 - 4.4.4 master dev -- 已适配
13 in_app_purchase 3.7 3.1.11 master dev in_app_purchase_v3.1.11-ohos-1.0.1in_app_purchase_v3.1.11-ohos-1.0.1 已适配
3.22 3.2.0 br_in_app_purchase-v3.2.0_ohos br_in_app_purchase-v3.2.0_ohos_dev in_app_purchase_v3.2.0-ohos-1.0.1in_app_purchase_v3.2.0-ohos-1.0.1 已适配
3.27 3.2.3 br_in_app_purchase-v3.2.3_ohos br_in_app_purchase-v3.2.3_ohos_dev in_app_purchase_v3.2.3-ohos-1.0.1in_app_purchase_v3.2.3-ohos-1.0.2 已适配
3.35 3.2.3 br_in_app_purchase-v3.2.3_ohos br_in_app_purchase-v3.2.3_ohos_dev in_app_purchase_v3.2.3-ohos-1.0.1in_app_purchase_v3.2.3-ohos-1.0.2 已适配
3.41 3.2.3 br_in_app_purchase-v3.2.3_ohos br_in_app_purchase-v3.2.3_ohos_dev in_app_purchase_v3.2.3-ohos-1.0.1in_app_purchase_v3.2.3-ohos-1.0.2 已适配
14 css_colors - - - - - - -
15 flutter_adaptive_scaffold - - - - - - -
16 flutter_image - - - - - - -
17 flutter_lints - - - - - - -
18 flutter_markdown - - - - - - -
19 flutter_migrate - - - - - - -
20 go_router - - - - - - -
21 go_router_builder - - - - - - -
22 metrics_center - - - - - - -
23 multicast_dns - - - - - - -
24 palette_generator - - - - - - -
25 pointer_interceptor - - - - - - -
26 rfw - - - - - - -
27 standard_message_codec - - - - - - -
28 two_dimensional_scrollables - - - - - - -
29 web_benchmarks - - - - - - -
30 xdg_directories - - - - - - -
- 注意:状态为`-`表示为纯Dart库 ## FAQ 1. 运行 `flutter pub get` 遇到 `"File name too long"` 问题。 打开 `Git Bash` 或 `运行 cmd`(需要将git添加到环境变量中),执行以下命令: ``` git config --global core.longpaths true ``` ## 问题交流 - 问题反馈:欢迎在 [Flutter框架仓库](https://gitcode.com/CPF-Flutter/flutter_flutter/issues) 以及各个Flutter三方库提交issue。