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 项目迁移到开源鸿蒙的三步法:
    1. 基于 openHarmony-capacitor 框架完成基础框架与业务代码移植;
    2. 对比项目已使用的 Capacitor 插件与组织下的鸿蒙化插件,完成对应插件移植;
    3. 参照各插件项目的官方说明书完成详细操作。
  • 插件目录:收录了 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-capacitorCapacitor 鸿蒙化核心框架C++
capacitor-cli命令行工具(hionic)JavaScript
ionic-readme项目总介绍-
manifest多仓清单(repo manifest)-
cicdCI/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-settingscapacitor-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 应用,开发者可以低成本移植到鸿蒙平台;对于新项目,则可以真正实现一套代码三端运行。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐