Using Capacitor+ (@capacitor-plus) Packages

Capacitor+ is an automated, always-synced fork of Capacitor 由 Capgo. It provides a drop-in replacement for the official Capacitor packages with one key advantage: 社区PR和修复更快地合并.

为什么 Capacitor+ 存在

Capacitor 的 Ionic 团队维护着他们自己的优先级和发布计划。这意味着社区贡献 - bug 修复、改进和功能 - 可能需要几个月甚至几年才能被合并。有些从来没有被合并。

Capacitor+ 解决了这个问题:

__CAPGO_KEEP_0__+ 从分叉中合并 PR - 从上游队列中被卡住的有价值的 PR 被积极合并
持续同步 - 从上游 Capacitor 的每次更改都自动拉取、测试和验证
快速发布 - 当更改通过 CI 时，它们将自动发布到 npm 下的 @capacitor-plus 范围
社区优先 - 你的贡献很重要并且得到优先考虑
安全审查 每次变更都将由 AI 分析安全漏洞、破坏性变更和稳定性风险

可用包

包	描述
`@capacitor-plus/core`	核心运行时库
`@capacitor-plus/cli`	命令行接口
`@capacitor-plus/android`	Android 运行时
`@capacitor-plus/ios`	iOS 运行时

安装

新项目

对于新项目，只需使用 Capacitor+ 包代替官方包即可:

npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android  # for Android
npm install @capacitor-plus/ios      # for iOS

然后初始化您的项目：

npx cap init
npx cap add android
npx cap add ios

从官方Capacitor迁移

要将现有项目从官方Capacitor迁移到Capacitor+:

# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

# Install Capacitor+ packages
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android  # if using Android
npm install @capacitor-plus/ios      # if using iOS

由于Capacitor+是API的完全兼容替代品，因此无需code更改。您的导入保持不变:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

如何工作

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

每日同步: 一个GitHub动作从 ionic-team/capacitor
创建PR: 将更改提议为pull请求到 plus 分支
CI验证: 运行完整测试套件（lint、单元测试、iOS构建、Android构建）
Claude Code 评估: AI-powered 综合安全分析检查:
- : 注入、XSS 等安全漏洞
- : API 的破坏性变化
- : 应用程序崩溃风险和稳定性问题
- : 数据完整性和隐私问题
- : 恶意 code 模式
: 自动合并: 只有 CI 通过并 Claude 批准 (未检测到问题)
: 自动发布: 在 npm 下发布新版本 @capacitor-plus/*

: 安全审查

每次上游同步都会分析:

检查	描述
安全性	命令注入、XSS、路径遍历、硬编码密钥等
重大变更	删除或重命名的API、签名改变、配置格式变更
稳定性	空指针异常、未处理的异常、竞争条件、内存泄露
数据安全	数据丢失场景、隐私违规、不安全的存储
Code 完整性	被混淆的 code, 可疑的网络调用，后门

如果检测到任何问题，PR 将被标记为手动审查，并不会自动合并。

你的 PR 会被接受吗?

你有一个 PR 卡在官方 Capacitor 仓库里？以下是如何将其导入 Capacitor+:

打开一个问题 在 Capacitor+ 仓库链接到你的上游 PR
或者直接提交 PR 到 branch plus 团队将审查它，运行 CI，并将其合并到它通过测试
__CAPGO_KEEP_1__+

这样一来，你和其他人就可以立即从你的工作中受益，而不必等待上游的发布周期。

好处

获取当前PR: 社区修复和功能等待上游的合并
保持最新: 立即获取通过CI的上游修复
安全第一: 每个变更都经过了漏洞和稳定性风险的审查
已验证的发布: 只有通过CI测试和人工安全审查都通过的变更才会发布
无缝替换: Same API as Capacitor, just a different package scope
您的声音很重要: 提交您自己的 PR 或要求特定的上游 PR 被合并

示例：使用 Capacitor+ 与插件

所有官方 Capacitor 插件都可以与 Capacitor+ 无缝工作

import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

// Everything works exactly the same
const platform = Capacitor.getPlatform();

const photo = await Camera.getPhoto({
  resultType: CameraResultType.Uri
});

const position = await Geolocation.getCurrentPosition();

Capgo 插件也可以与 Capacitor+ 完美工作

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });

这就是全部！您现在有了一个速度更快的 Capacitor 版本，社区改进被合并得更快。您的应用将从 bug 修复和功能中受益，而不必等待官方发布周期

继续使用 Using Capacitor+ (@capacitor-plus) Packages

如果您正在使用 使用 Capacitor+ (@capacitor-plus) Packages 来规划原生插件工作，连接它与 Capacitor+ Capacitor+ 的实现细节 Capgo 插件目录为 Capgo 产品工作流程 Capacitor 由 Capgo 提供的插件 for the implementation detail in Capacitor Plugins by Capgo, 添加或更新插件为添加或更新插件的实现细节 Ionic 企业插件替代品为 Ionic 企业插件替代品的产品工作流程

@Capacitor+ Core

Tutorial on Capacitor+ Core