开始

新项目安装

1. 安装核心包

   npm install @capacitor-plus/core @capacitor-plus/cli

2. 添加平台包

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

3. 初始化 Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. 添加平台

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

从官方 Capacitor 迁移

如果您有一个现有的 Capacitor 项目，迁移到 Capacitor+ 很简单：

1. 移除官方包

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. 安装 Capacitor+ 包

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

3. 同步您的项目

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

注意

code+ 不需要任何修改！Capacitor+ 与官方 Capacitor 具有相同的 API。您的导入和 code 保持完全相同。

使用

由于 Capacitor+ 兼容 API，您的现有 code 不需要修改：

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

使用官方Capacitor插件

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

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

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

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

使用Capgo插件

Capgo插件与Capacitor+完全兼容：

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

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

同步原理

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

1. 每日同步: GitHub 动作从 ionic-team/capacitor
2. PR 创建: 将更改提议为向 plus branch
3. CI 验证: 全套测试运行 (lint, 单元测试, iOS 构建, Android 构建)
4. 安全审查: AI 驱动的分析检查漏洞和破坏性更改
5. 自动合并: 只有 CI 通过 AND 安全审查通过
6. 自动发布: 新版本发布到 npm 下 @capacitor-plus/*

安全审查详细信息

每次上游同步都会分析:

检查	它捕获了什么
安全	命令注入、XSS、路径遍历、硬编码密钥
更改	删除/重命名的API、签名改变、配置更改
稳定性	空指针引用、未处理的异常、竞争条件、内存泄漏
数据安全	数据丢失场景、隐私泄露、不安全的存储
Code完整性	code被混淆，疑似网络调用、后门

注意

如果检测到任何问题，PR将被标记为手动审查，并不会自动合并。这确保您始终获得稳定、安全的版本。

提交您的PR

您的PR在官方Capacitor仓库中卡住了？在Capacitor+中获取它合并

1. 打开一个问题 在 Capacitor+仓库 链接到您的上游 PR

2. 或者直接提交 作为上游的 plus branch

3. 团队会对其进行审查，运行 CI，并在通过测试后合并

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

FAQ

这是否是生产就绪?

Yes. Capacitor+ is used in production apps. Every release passes the same test suite as official Capacitor, plus additional security analysis.

我的官方插件是否仍然有效?

是。所有 @capacitor/* 插件都可以直接使用Capacitor+。

如果上游发布了一个破坏性更新?

人工审查AI安全评估标记了破坏性更新。您将在合并之前看到这些更改的文档。

如何报告问题?

在 Capacitor+ GitHub中提交问题。对于影响官方Capacitor的问题，我们将协助上游。

我可以贡献吗?

当然！欢迎 PR。您可以直接提交修复或要求特定上游 PR 进行合并。

继续 Getting Started

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