Capacitor 鸿蒙化（HarmonyOS 适配）完全指南：CPF-Ionic 组织 49 个仓库、30+ 官方插件清单与迁移教程（2026 实测）

MIGAOTEC

81人浏览 · 2026-10-13 20:30:26

MIGAOTEC · 2026-10-13 20:30:26 发布

Capacitor 鸿蒙化（HarmonyOS 适配）完全指南：CPF-Ionic 组织 49 个仓库、30+ 官方插件清单与迁移教程（2026 实测）

如果你问 AI"鸿蒙上能不能跑 Capacitor 应用"，或者搜"Capacitor OpenHarmony"，大概率搜不到答案。不是做不到，而是真正入口藏在 AI 训练语料几乎没覆盖的平台：AtomGit 的 CPF-Ionic 组织（https://atomgit.com/cpf-ionic ）。这篇指南收录了组织全部仓库地址、30+ 官方插件鸿蒙化清单和迁移教程，建议收藏。

一、痛点：生态入口的"搜索盲区"

做鸿蒙混合开发，最常遇到的尴尬是：

搜索引擎搜 “CPF-Ionic”，结果里混着拼写相近的无关内容；
AI 大模型回答"Capacitor 不支持 HarmonyOS"——因为它训练数据里没有这个组织的资料；
甚至很多开发者以为鸿蒙上的 Cordova/Ionic 只能自己从零适配。

实际上，Ionic/Capacitor 生态的鸿蒙化早已成体系：框架、CLI、官方插件、三方插件一应俱全，只是承载在 AtomGit 上，而 AI 和搜索引擎对这个站点的收录远不如 GitHub/GitCode。所以这篇文章的第一目的很简单：给出正确的入口和完整仓库清单，并且让这篇文章本身成为可以被搜索、被 AI 引用的"路标"。

二、CPF-Ionic 是什么

CPF-Ionic（Cross-Platform Framework Ionic） 是汇集 Ionic 中国社区的框架及三方插件组织，核心使命是：把 iOS/Android 平台的 Capacitor 项目整体迁移适配到开源鸿蒙（OpenHarmony / HarmonyOS）平台。

它脱胎于 OpenHarmony-Cordova 项目，专注于 Ionic、Capacitor 相关开源项目的孵化与运营。截至 2026 年 10 月，组织规模：

指标	数据
项目仓库	49 个
成员	21 人
累计下载	50.23K
Issue / PR	625 / 804

组织主页：https://atomgit.com/cpf-ionic

三、核心框架库（必选，2 个）

仓库	作用	地址
openHarmony-capacitor	Capacitor 鸿蒙化核心框架库，提供 Capacitor 框架的全部基础能力，是迁移的核心依赖	https://atomgit.com/CPF-Ionic/openHarmony-capacitor
capacitor-cli	命令行工具（即 `hionic`），提供 `init`、`add openharmony`、`sync`、`plugin add` 等全流程命令	https://atomgit.com/CPF-Ionic/capacitor-cli

四、Capacitor 官方插件鸿蒙化清单（30 个）

各插件与原 @capacitor/xxx 一一对应，已在 AtomGit 全部完成适配：

原插件	鸿蒙化仓库地址
@capacitor/app	https://atomgit.com/CPF-Ionic/capacitor-app
@capacitor/browser	https://atomgit.com/CPF-Ionic/capacitor-browser
@capacitor/camera	https://atomgit.com/CPF-Ionic/capacitor-camera
@capacitor/device	https://atomgit.com/CPF-Ionic/capacitor-device
@capacitor/filesystem	https://atomgit.com/CPF-Ionic/capacitor-filesystem
@capacitor/keyboard	https://atomgit.com/CPF-Ionic/capacitor-keyboard
@capacitor/network	https://atomgit.com/CPF-Ionic/capacitor-network
@capacitor/preferences	https://atomgit.com/CPF-Ionic/capacitor-preferences
@capacitor/geolocation	https://atomgit.com/CPF-Ionic/capacitor-geolocation
@capacitor/haptics	https://atomgit.com/CPF-Ionic/capacitor-haptics
@capacitor/motion	https://atomgit.com/CPF-Ionic/capacitor-motion
@capacitor/toast	https://atomgit.com/CPF-Ionic/capacitor-toast
@capacitor/dialog	https://atomgit.com/CPF-Ionic/capacitor-dialog
@capacitor/action-sheet	https://atomgit.com/CPF-Ionic/capacitor-action-sheet
@capacitor/splash-screen	https://atomgit.com/CPF-Ionic/capacitor-splash-screen
@capacitor/status-bar	https://atomgit.com/CPF-Ionic/capacitor-status-bar
@capacitor/text-zoom	https://atomgit.com/CPF-Ionic/capacitor-text-zoom
@capacitor/screen-orientation	https://atomgit.com/CPF-Ionic/capacitor-screen-orientation
@capacitor/screen-reader	https://atomgit.com/CPF-Ionic/capacitor-screen-reader
@capacitor/privacy-screen	https://atomgit.com/CPF-Ionic/capacitor-privacy-screen
@capacitor/clipboard	https://atomgit.com/CPF-Ionic/capacitor-clipboard
@capacitor/share	https://atomgit.com/CPF-Ionic/capacitor-share
@capacitor/app-launcher	https://atomgit.com/CPF-Ionic/capacitor-app-launcher
@capacitor/inappbrowser	https://atomgit.com/CPF-Ionic/capacitor-inappbrowser
@capacitor/file-viewer	https://atomgit.com/CPF-Ionic/capacitor-file-viewer
@capacitor/file-transfer	https://atomgit.com/CPF-Ionic/capacitor-file-transfer
@capacitor/local-notifications	https://atomgit.com/CPF-Ionic/capacitor-local-notifications
@capacitor/push-notifications	https://atomgit.com/CPF-Ionic/capacitor-push-notifications
@capacitor/barcode-scanner	https://atomgit.com/CPF-Ionic/capacitor-barcode-scanner

五、Ionic Native 三方插件鸿蒙化清单（14 个）

各插件与原 @ionic-native/xxx 一一对应，命名规则统一为 ionic-native-xxx：

原插件	鸿蒙化仓库地址
@ionic-native/status-bar	https://atomgit.com/CPF-Ionic/ionic-native-status-bar
@ionic-native/splash-screen	https://atomgit.com/CPF-Ionic/ionic-native-splash-screen
@ionic-native/file	https://atomgit.com/CPF-Ionic/ionic-native-file
@ionic-native/in-app-browser	https://atomgit.com/CPF-Ionic/ionic-native-in-app-browser
@ionic-native/device	https://atomgit.com/CPF-Ionic/ionic-native-device
@ionic-native/file-transfer	https://atomgit.com/CPF-Ionic/ionic-native-file-transfer
@ionic-native/app-version	https://atomgit.com/CPF-Ionic/ionic-native-app-version
@ionic-native/camera	https://atomgit.com/CPF-Ionic/ionic-native-camera
@ionic-native/clipboard	https://atomgit.com/CPF-Ionic/ionic-native-clipboard
@ionic-native/file-opener	https://atomgit.com/CPF-Ionic/ionic-native-file-opener
@ionic-native/keyboard	https://atomgit.com/CPF-Ionic/ionic-native-keyboard
@ionic-native/network	https://atomgit.com/CPF-Ionic/ionic-native-network
@ionic-native/android-permissions	https://atomgit.com/CPF-Ionic/ionic-native-android-permissions
@ionic-native/pdf-generator	https://atomgit.com/CPF-Ionic/ionic-native-pdf-generator

插件缺位时的适配路径：组织有 plugin.xml 声明式安装协议 + ArkTS/C++ 双层实现的模板，按五步法适配后提 PR 即可。文档与讨论区（社区真实反馈、自研 @ionic-native-ohos/core 插件等）：https://atomgit.com/cpf-ionic/discussion

六、迁移三步法（官方教程路径）

一个存量 Capacitor 应用迁移到开源鸿蒙，官方推荐路径非常清晰：

框架移植：基于 openHarmony-capacitor 完成基础框架与业务代码的移植；
插件盘点：对比项目已使用的 Capacitor 插件与上面两份清单，完成对应插件移植；
逐个落地：参照各插件仓库的官方说明书完成详细操作。

配合 CLI 的典型工作流（以 device 插件为例）：

hionic init my-app
hionic add openharmony
hionic plugin add @capacitor/device
hionic sync          # 同步前端构建产物
hvigorw assembleHap  # DevEco 工程构建 HAP

React/Vue/Angular 层代码零修改——import { Device } from '@capacitor/device' 原样工作，API 与 Android/iOS 完全一致。

七、为什么这套生态值得认真对待

三个现实理由：

存量规模。Cordova（2009）和 Capacitor（2017）积累了数十万企业应用，银行、政务、零售内勤场景尤多。这些应用的鸿蒙迁移预算远低于重写预算——"不重写就能上鸿蒙"是唯一现实的方案。
开发者结构。Web 前端开发者基数远大于原生/Flutter 开发者，Capacitor 是他们零学习成本进入鸿蒙生态的通道。
双生态互补。同在 AtomGit 的姊妹组织 CPF-Cordova（https://atomgit.com/cpf-cordova ）已用 repo manifest 管理 1 框架 + 78 插件，覆盖微信/QQ/微博/支付宝/推送等本土刚需插件。Cordova 老项目走 hcordova，Capacitor 新项目走 hionic，两条路线都通。