Capacitor+ (@capacitor-plus) パッケージの使用

Capacitor+は、常に同期された自動フォークです Capacitor __CAPGO_KEEP_0__によって維持されています Capgo。公式のCapacitorパッケージの置き換えとして、1つの重要な利点があります: コミュニティからのPRや修正がより速くマージされる.

Why Capacitor+ Exists

Capacitorは、Ionicチームが独自の優先順位とリリーススケジュールで管理しているため、コミュニティからの貢献 - バグ修正、改善、機能 - は、数か月もしくは数年間待たされることもある。あるいは全く取り込まれないこともある。

Capacitor+はこの問題を解決する。

フォークからのPRをマージする - 上流キューに詰まっている価値のあるPRは積極的にマージされる
連続したSync - 上流の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

Migrating from Official Capacitor

To migrate an existing project from official Capacitor to 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

Since Capacitor+ is a drop-in replacement with the same API, no code changes are required. Your imports remain the same:

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

Capacitor+のしくみ

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

毎日同期: A GitHub Action fetches the latest changes from ionic-team/capacitor
プルリクエストの作成: プルリクエストとして変更を提案する plus ブランチ
CI検証: 全てのテストスイートを実行する(lint、ユニットテスト、iOSビルド、Androidビルド)
Claude Code Reviewクラウドフレイヤー
- AIを活用した総合セキュリティ分析
- Breaking API changes
- クラウドフレイヤー変更の破壊
- クラッシュリスクと安定性問題
- Malicious code patterns
悪意のあるクラウドフレイヤーパターンAuto-Merge
CIが通過し、クラウドフレイヤーが承認した場合（問題なし）: A new version is published to npm under @capacitor-plus/*

新しいバージョンがクラウドフレイヤーにSecurity Reviewの下で公開される

アップストリームの同步は次の点を分析します:

確認	説明
セキュリティ	コマンドインジェクション、XSS、パス・トラバーサル、ハードコードされたシークレットなど
変更点	削除または名前変更されたAPI、サインチャージャー変更、構成形式の変更
安定性	Nullポインタ参照、未処理の例外、レース条件、メモリリーク
データセーフティ	データロスシナリオ、プライバシー侵害、不正なストレージ
Code インテグリティ	暗号化された code, 不審のネットワークコール、バックドア

検出された問題があれば、PRは手動レビューのためにフラグが付けられ、自動マージされません。

PRをマージしたい?

Capacitor公式リポジトリにPRが詰まっている場合、Capacitor+にどうやって入れるか

問題を報告する 上流のPRにリンクする Capacitor+リポジトリ直接PRを提出する
ブランチ チームはレビューを実行し、CIを実行し、通過した場合にマージします plus __CAPGO_KEEP_1__+
__CAPGO_KEEP_0__

この方法で、すぐに他の人があなたの作業の利点を受けることができます。アップストリームのリリースサイクルを待つ必要はありません。

利点

即時PRコミュニティがアップストリームで待っている修正と機能をマージします。
最新の情報アップストリームの修正をCIが通過した時点で即時取得
セキュリティ第一すべての変更は脆弱性と安定性のリスクを検証します。
検証済みリリースCIテストとAIセキュリティレビューを通過した変更のみが公開されます。
ドロップイン置き換え: 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のより高速化されたバージョンを手に入れました。アプリは、公式のリリースサイクルを待たずにバグ修正と機能から利益を得ることができます。

続けて、Using Capacitor+ (@capacitor-plus) Packages

あなたが使用している Using Capacitor+ (@capacitor-plus) Packages nativeプラグインの作業を計画する場合、__CAPGO_KEEP_0__+を接続する Capacitor+ Capacitor+の実装詳細 Capgo プラグインディレクトリ Capgo プラグインディレクトリの製品ワークフローについて Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新プラグインの追加または更新の実装詳細についてイオニックエンタープライズプラグインの代替イオニックエンタープライズプラグインの代替の製品ワークフローについて

@Capacitor+ Core

Capacitor+のチュートリアル