CPF-Ionic 组织-专注于 Ionic / Capacitor 生态鸿蒙化的开源组织
CPF-Ionic（Cross-Platform Framework Ionic）是 AtomGit 上专注于 Ionic / Capacitor 生态鸿蒙化的开源组织，汇集了 Ionic 中国社区的框架及三方插件资源。组织的目标是：将 iOS / Android 平台的 Capacitor、Ionic 项目向开源鸿蒙（OpenHarmony）平台迁移适配，帮助开发者快速在 OpenHarmony 上开发 Ionic 应用，实现"一次开发，Android、iOS、OpenHarmony 三端部署"。
该组织孵化了 Capacitor 鸿蒙化核心框架、配套命令行工具以及 40+ 个鸿蒙化插件（覆盖@capacitor/*官方插件与@ionic-native/*三方插件），目前拥有 22 名成员、22 位关注者。
- 组织主页：https://atomgit.com/CPF-Ionic
重点仓库
1. openHarmony-capacitor — Capacitor 鸿蒙化核心框架
- 仓库地址：https://atomgit.com/CPF-Ionic/openHarmony-capacitor
- 定位：Capacitor 的 OpenHarmony 化版本，是整个组织的核心依赖，基于
@capacitor/android@8.0.0开发，所有接口兼容 Capacitor 的 Android 和 iOS 版本。 - 技术特点：
- 框架采用 C/C++ 研发，底层使用自研 Socket TCP/IP 通讯，封装 HTTP/HTTPS 协议通讯，解决各种跨域访问问题，无需配置 Web 服务端，结合 WebView 通讯协议栈，大幅提高应用层网络请求效率；
- 支持多页面视图（同时兼容 Android/iOS 原有的单页面视图），复杂项目中可创建多个 WebView 协同工作；
- 支持 ArkTS 侧和 C/C++ 侧自定义插件研发；
- 支持 OpenHarmony 5.0+，依赖 openssl（需先行集成方可编译）。
- 工程结构：包含 OpenHarmony 适配层（CoreHarmony）、Capacitor 适配层（getcapacitor）、热更新（HotCodePushPlugin）、ArkTS 插件（TsCordovaPlugin），以及内置浏览器、图片压缩、权限处理、闪屏等组件。
- 数据：18 Stars / 6 Forks，主语言 C++，MIT License。
- 背景：Capacitor 是移动端跨平台新框架，被大量厂商采用，但官方不支持 OpenHarmony。openHarmony-capacitor 让原有项目无需投入研发即可移植到 OpenHarmony，新项目一次研发适配三端，节省大量时间与人力成本。
2. capacitor-cli — 命令行工具（hionic）
- 仓库地址：https://atomgit.com/CPF-Ionic/capacitor-cli
- 定位：配套命令行工具，基于
@ionic/cli@2.1.15开发，npm 包名为hionic，提供框架及插件的命令行操作环境。 - 核心能力：
- 项目创建：
hionic start capacitor/cordova <目录> <包名> <应用名> [模板]，支持 React、Vue 等前端模板；已有 Web 项目可用hionic init直接初始化； - 平台管理：
hionic platform add/remove openharmony（也支持 android/ios）； - 插件管理：
hionic plugin add/remove <插件名> --platform openharmony，支持 cordova 插件与 capacitor 插件； - 开发调试：
hionic open openharmony在 DevEco 中打开项目、hionic buildapp编译 hap、hionic run安装运行到设备、hionic run browser浏览器快速预览。
- 项目创建：
- 数据：27 Stars / 5 Forks，主语言 JavaScript，Apache-2.0 License。
3. ionic-readme — 项目总介绍与插件导航
- 仓库地址：https://atomgit.com/CPF-Ionic/ionic-readme
- 定位：整个组织的项目总览与入口文档，说明 Capacitor 项目迁移到开源鸿蒙的三步法：
- 基于openHarmony-capacitor框架完成基础框架与业务代码移植；
- 对比项目已使用的 Capacitor 插件与组织下的鸿蒙化插件，完成对应插件移植；
- 参照各插件项目的官方说明书完成详细操作。
- 插件目录：收录了 30 个官方 Capacitor 插件的鸿蒙化版本（app、browser、camera、device、filesystem、keyboard、barcode-scanner、clipboard、geolocation、haptics、push-notifications、network、share、status-bar、toast、local-notifications、preferences、screen-orientation 等，与
@capacitor/xxx一一对应），以及 14 个 Ionic 三方插件的鸿蒙化版本（status-bar、splash-screen、file、in-app-browser、camera、clipboard、pdf-generator 等，与@ionic-native/xxx一一对应），并注明"其它功能陆续更新中"。
组织仓库全景（三方库罗列）
组织下共有 49 个公开仓库，除核心框架与工具外，其余均为插件类三方库。以下链接统一使用 AtomGit 地址。
核心框架与工具（5 个）
| 仓库 | 说明 | 语言 |
|---|---|---|
| openHarmony-capacitor | Capacitor 鸿蒙化核心框架 | C++ |
| capacitor-cli | 命令行工具（hionic） | JavaScript |
| ionic-readme | 项目总介绍 | - |
| manifest | 多仓清单（repo manifest） | - |
| cicd | CI/CD 配置 | - |
Capacitor 官方插件鸿蒙化（30 个，与@capacitor/xxx一一对应）
| 插件仓库 | 对应原插件 |
|---|---|
| capacitor-app | @capacitor/app |
| capacitor-browser | @capacitor/browser |
| capacitor-camera | @capacitor/camera |
| capacitor-device | @capacitor/device |
| capacitor-filesystem | @capacitor/filesystem |
| capacitor-keyboard | @capacitor/keyboard |
| capacitor-barcode-scanner | @capacitor/barcode-scanner |
| capacitor-app-launcher | @capacitor/app-launcher |
| capacitor-clipboard | @capacitor/clipboard |
| capacitor-geolocation | @capacitor/geolocation |
| capacitor-haptics | @capacitor/haptics |
| capacitor-push-notifications | @capacitor/push-notifications |
| capacitor-network | @capacitor/network |
| capacitor-share | @capacitor/share |
| capacitor-status-bar | @capacitor/status-bar |
| capacitor-text-zoom | @capacitor/text-zoom |
| capacitor-action-sheet | @capacitor/action-sheet |
| capacitor-dialog | @capacitor/dialog |
| capacitor-screen-reader | @capacitor/screen-reader |
| capacitor-splash-screen | @capacitor/splash-screen |
| capacitor-toast | @capacitor/toast |
| capacitor-file-transfer | @capacitor/file-transfer |
| capacitor-file-viewer | @capacitor/file-viewer |
| capacitor-inappbrowser | @capacitor/inappbrowser |
| capacitor-local-notifications | @capacitor/local-notifications |
| capacitor-motion | @capacitor/motion |
| capacitor-preferences | @capacitor/preferences |
| capacitor-privacy-screen | @capacitor/privacy-screen |
| capacitor-screen-orientation | @capacitor/screen-orientation |
| capacitor-native-settings | capacitor-native-settings（第三方） |
Ionic 三方插件鸿蒙化（14 个，与@ionic-native/xxx一一对应）
| 插件仓库 | 对应原插件 |
|---|---|
| ionic-native-status-bar | @ionic-native/status-bar |
| ionic-native-splash-screen | @ionic-native/splash-screen |
| ionic-native-file | @ionic-native/file |
| ionic-native-in-app-browser | @ionic-native/in-app-browser |
| ionic-native-device | @ionic-native/device |
| ionic-native-file-transfer | @ionic-native/file-transfer |
| ionic-native-app-version | @ionic-native/app-version |
| ionic-native-camera | @ionic-native/camera |
| ionic-native-clipboard | @ionic-native/clipboard |
| ionic-native-file-opener | @ionic-native/file-opener |
| ionic-native-keyboard | @ionic-native/keyboard |
| ionic-native-network | @ionic-native/network |
| ionic-native-android-permissions | @ionic-native/android-permissions |
| ionic-native-pdf-generator | @ionic-native/pdf-generator |
注：插件仓库主要使用 ArkTS / C++ 实现，各插件与原生插件一一对应，“其它功能陆续更新中”。
总结
CPF-Ionic 构建了一套完整的 Ionic/Capacitor → OpenHarmony 迁移方案：openHarmony-capacitor提供核心框架能力，capacitor-cli（hionic）提供从项目创建、平台/插件管理到构建运行的全流程命令行支撑，ionic-readme作为总览文档串联起 40+ 鸿蒙化插件生态。对于存量 Capacitor/Ionic 应用，开发者可以低成本移植到鸿蒙平台；对于新项目，则可以真正实现一套代码三端运行。
