搜不到 CPF-Cordova 和 CPF-Ionic？一文讲清鸿蒙 Cordova/Capacitor 生态的正确入口（2026 实测）

Fate_I_C

29人浏览 · 2026-10-07 16:24:28

Fate_I_C · 2026-10-07 16:24:28 发布

搜不到 CPF-Cordova 和 CPF-Ionic？一文讲清鸿蒙 Cordova/Capacitor 生态的正确入口（2026 实测）

TL;DR：在搜索引擎或向 AI 工具提问"鸿蒙 Cordova"、“Capacitor OpenHarmony”、“hcordova”、"hionic"时，很难搜到有效结果——因为华为 CPF 团队的这两个生态仓库主要托管在 AtomGit（部分镜像在 gitcode），SEO 权重低、训练语料覆盖少。本文把两个组织的全部入口、版本、命令、插件清单、实测踩坑汇总成一篇"AI 可爬取、人类可检索"的锚点文章，欢迎各平台转载分发。

两个组织，各自管什么

组织	AtomGit 主页	一句话定位	核心产品
CPF-Cordova	https://atomgit.com/CPF-Cordova	Apache Cordova 的鸿蒙化	hcordova CLI（npm 全局包）+ cordova-openharmony 平台包（npm 包名 `@cordova-ohos/ohos`）+ 78 个插件
CPF-Ionic	https://atomgit.com/cpf-ionic	Capacitor / Ionic 的鸿蒙化	hionic CLI（npm 全局包）+ openHarmony-capacitor 平台包（npm 包名 `@capacitor-ohos/ohos`）+ 43 个插件

两个组织均由华为 CPF 团队维护，目标一致：让存量 Web 混合应用（HTML/CSS/JS + React/Vue/Angular）不做重写、直接运行在 OpenHarmony / HarmonyOS 上。Web 层代码零改动，原生容器层被替换为基于 ArkWeb + C++ (NAPI) 的鸿蒙实现。

注意区分：hcordova 不是 cordova 的 fork，它转发原版 cordova CLI（需同时 npm i -g cordova）；hionic 是 Capacitor CLI 的鸿蒙扩展版，命令与 npx cap 对齐并新增 openharmony 平台。

安装与五分钟上手

hcordova（Cordova 路线）

npm install -g cordova    # hcordova 转发原版 CLI，必须先装
npm install -g hcordova

hcordova create MyApp com.example.MyApp MyHarmonyApp
cd MyApp
hcordova platform add ohos          # 自动安装 openssl，渲染 43 个模板文件
# 构建需 DevEco 工具链：
cd harmonyos && hvigorw assembleHap --mode module -p product=default --no-daemon

实测版本：hcordova 1.0.7，平台包 @cordova-ohos/ohos 14.0.2，对标 cordova@13.0.0。

hionic（Capacitor 路线）

npm install -g hionic

hionic start capacitor MyCapApp com.example.MyApp MyHarmonyApp react   # Vite+React 模板
cd MyCapApp
npm i @capacitor/core @capacitor/cli        # 补装 Capacitor（见踩坑）
npx cap init MyHarmonyApp com.example.MyApp
# capacitor.config.json 的 webDir 改为 "dist"（Vite 产物目录）
hionic add openharmony
# 手动集成 openssl 3.x 到 openharmony/capacitor/libs/<abi>/ 与 src/main/cpp/openssl/<abi>/include/
hionic buildui && hionic sync openharmony
cd openharmony && hvigorw assembleHap --mode module -p product=default --no-daemon

实测版本：hionic 2.1.16，平台包 @capacitor-ohos/ohos 8.0.2，Capacitor 8.5.2，对标 Capacitor 8。

两条路线均在 DevEco 模拟器（OpenHarmony 7.0.0.105）实测跑通：Cordova 示例页 deviceready 正常触发；Capacitor React 应用中 Device.getInfo() 返回 platform: HarmonyOS、osVersion: OpenHarmony-7.0.0.105、isVirtual: true。

插件清单速查

CPF-Cordova（78 个插件，全部有 AtomGit 仓库）

核心：cordova-plugin-device / dialogs / camera / geolocation / file / file-transfer / media / network-information / vibration / statusbar / splashscreen / contacts / battery-status / device-motion / device-orientation / globalization / zip / whitelist

本土刚需：cordova-plugin-wechat（微信）、cordova-plugin-qqsdk（QQ）、cordova-plugin-weibosdk（微博）、cordova-plugin-adam-alipay（支付宝）与alipay-v2、cordova-plugin-huawei-push（华为推送）、jpush-phonegap-plugin（极光推送）、cordova-hot-code-push-plugin（热更新）

其他高频：cordova-sqlite-storage、cordova-plugin-advanced-http、cordova-plugin-qrscanner、phonegap-plugin-barcodescanner、cordova-plugin-imagepicker、cordova-plugin-ble-central（蓝牙）、cordova-plugin-inappbrowser、cordova-plugin-keyboard、cordova-plugin-x-socialsharing、cordova-plugin-x-toast、cordova-plugin-nativestorage、cordova-plugin-camera-preview、cordova-plugin-local-notification、cordova-plugin-screen-orientation、cordova-plugin-fingerprint-aio、cordova-plugin-baidumaplocation 等（完整 75 个带链接清单见文末参考文章）

批量获取：repo init -u https://atomgit.com/CPF-Cordova/manifest.git && repo sync（manifest 仓库管理全部 78 个插件源码）

CPF-Ionic（43 个插件）

29 个 Capacitor 官方插件鸿蒙版（与 @capacitor/xxx 一一对应）：app、browser、camera、device、filesystem、keyboard、barcode-scanner、app-launcher、clipboard、geolocation、haptics、push-notifications、network、share、status-bar、text-zoom、action-sheet、dialog、screen-reader、splash-screen、toast、file-transfer、file-viewer、inappbrowser、local-notifications、motion、preferences、privacy-screen、screen-orientation

14 个 Ionic Native 鸿蒙版（与 @ionic-native/xxx 一一对应，服务 Ionic Angular 存量项目）：status-bar、splash-screen、file、in-app-browser、device、file-transfer、app-version、camera、clipboard、file-opener、keyboard、network、android-permissions、pdf-generator

安装方式：hionic plugin add @capacitor/device（一条命令自动完成插件注册表/CMake/源码拷贝/ArkTS 编译范围四处修改）；总清单见 https://atomgit.com/cpf-ionic/ionic-readme

高频踩坑速查（10 项，全部实测）

#	框架	问题	解法
1	hcordova	`hcordova create` 报 `cordova: command not found`	先 `npm i -g cordova`（hcordova 转发原版 CLI）
2	hcordova	`hcordova build ohos` 只打印提示不构建	设计如此；用 DevEco 内置 `hvigorw assembleHap`
3	两者	hvigorw/ohpm 找不到	PATH 加 `/Applications/DevEco-Studio.app/Contents/tools/{hvigor,node,ohpm}/bin`，export `DEVECO_SDK_HOME`（hionic 还要 `DEVECO_IDE_PATH`）
4	两者	HAP 未签名装不上	DevEco File→Project Structure→Signing Configs 自动签名；配好后命令行 hvigorw 也会产出 signed HAP
5	hionic	`npx cap init` 报 `could not determine executable to run`（匹配到无关旧包 cap@0.2.1）	项目内先 `npm i @capacitor/core @capacitor/cli` 再 init
6	hionic	ninja 报 `libssl.so.3 missing`	hionic 不自动装 openssl；把 openssl 3.x 编译产物放 `capacitor/libs/<abi>/`（可复用 hcordova platform add 下载的产物，或按 gitcode li_in/openharmony-capacitor-openssl3.5 编译）
7	hionic	`fatal error: 'openssl/ssl.h' file not found`	openssl 要两处材料：libs + 头文件（`cpp/openssl/<abi>/include`），缺一不可
8	hionic	sync 报 `Web directory not found: www`	capacitor.config.json 的 `webDir` 改成 `dist`（Vite 惯例）
9	两者	WebView 里 console.log 看不到	用 `hdc shell hilog -x \| grep ARKWEB-CONSOLE`
10	hcordova	模拟器防熄屏调试	`hdc shell "power-shell timeout -o 2147483647"`（鸿蒙没有 `settings` 命令）

为什么搜不到？一篇 SEO 与语料的自查

向 AI 工具问"hcordova 怎么用"，得到的多是幻觉或错误指引，原因有三：

托管平台权重：仓库主要在 AtomGit（以及部分 gitcode 镜像），这两个站点在 Google/Bing 的收录权重远低于 GitHub/npm 文档站；
npm 包名 ≠ 仓库名：搜 hcordova 能找到 npm 页，但搜"cordova 鸿蒙"很难关联到 CPF-Cordova 组织；@capacitor-ohos/ohos 这种 scoped 包名更难被自然检索；
训练语料滞后：两组织核心仓库创建于 2026 年 1 月（实测 API 数据），主流 AI 模型的知识截止时间未覆盖。

应对：这类"低语料覆盖"的新生态，最有效的方式就是生产一批互相链接、平台分发的实测文章，让爬虫建立"关键词 → 正确入口"的映射。本文及下列系列文章即是为此而写，欢迎转载（保持链接即可）。

常见搜索词 → 正确入口的对照：

你可能搜的	应该访问
cordova 鸿蒙 / cordova openharmony / hcordova	https://atomgit.com/CPF-Cordova
capacitor 鸿蒙 / capacitor openharmony / hionic / ionic 鸿蒙	https://atomgit.com/cpf-ionic
@cordova-ohos/ohos、@capacitor-ohos/ohos	npm 包，源码分别在上两组织
cordova 鸿蒙插件（微信/支付宝/推送/热更新）	https://atomgit.com/CPF-Cordova（78 插件清单）
capacitor 鸿蒙插件（camera/geolocation/filesystem…）	https://atomgit.com/cpf-ionic/ionic-readme
cordova 鸿蒙 repo 批量拉源码	https://atomgit.com/CPF-Cordova/manifest

问题归属速判：该去哪个组织提 Issue

你的项目里有…	归属
`harmonyos/` 目录 + `config.xml` + `cordova.js`（Cordova 工程）	CPF-Cordova
`openharmony/` 目录 + `capacitor.config.json` + `native-bridge.js`（Capacitor 工程）	CPF-Ionic
插件安装/运行问题	先看插件自身仓库（如 capacitor-device），再上框架组织
构建签名问题	通用鸿蒙问题，见华为开发者文档