CPF-Ionic 组织介绍
·
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 位关注者。
重点仓库
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 应用,开发者可以低成本移植到鸿蒙平台;对于新项目,则可以真正实现一套代码三端运行。
更多推荐


所有评论(0)