Using Capacitor+ (@capacitor-plus) Packages

Capacitor+ is an automated, always-synced fork of Capacitor Capacitor+によって Capgo. It provides a drop-in replacement for the official Capacitor packages with one key advantage: __CAPGO_KEEP_0__の公式パッケージの置き換えとして.

Why Capacitor+ Exists

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

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

フォークからのPRをマージする - 上流キューに溜まっている価値のあるPRが積極的にマージされる
連続した同期 - 上流のCapacitorから毎回の変更が自動的に取得され、テストされ、検証される
迅速なリリース - 変更がCIを通過すると、npmの下のスコープで自動的に公開される @capacitor-plus コミュニティ第一
- あなたの貢献は重要であり優先される scope
セキュリティレビュー済み セキュリティ脆弱性、変更点、安定性リスクを分析する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ビルド)
クラウドの Code レビュー: AIが駆使する包括的なセキュリティ分析
- セキュリティの脆弱性 (インジェクション、XSSなど)
- API の破壊的な変更
- クラッシュリスクと安定性の問題
- データの整合性とプライバシーに関する懸念
- 悪意のある code のパターン
Auto-Merge: CIが通過し、クラウドが承認 (問題なし) の場合
Auto-Publish: 新しいバージョンが npm の下のセキュリティレビューに公開される @capacitor-plus/*

セキュリティレビュー

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

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

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

あなたのPRをマージされる?

Capacitor公式リポジトリにPRが詰まっている場合、Capacitor+にどうやって入れるかこちらをご覧ください。

問題を報告する 公式 Capacitor+リポジトリあなたのアップストリームPRへのリンク
または直接 ブランチ plus チームがレビューし、CIを実行し、通過した場合にマージします。
Want Your PR Merged?

このように、すぐにアップストリームのリリースサイクルを待たずに、他のユーザーもあなたの作業の利益を受けることができます。

利点

現在の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のコミュニティ改善がマージされるのが速くなり、Capacitorの更新が速くなります。アプリはバグ修正と機能の恩恵を受けることができます。オフィシャルリリースサイクルを待つ必要はありません。

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

あなたが Using Capacitor+ (@capacitor-plus) Packages を使用して、ネイティブプラグインの作業を計画する場合、 Capacitor+ Capacitor+の実装詳細と組み合わせてください Capgo プラグインディレクトリ for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新プラグインの追加または更新の実装詳細 Ionic Enterprise プラグインの代替 Capacitor Plus製品ワークフロー用のIonic Enterprise プラグインの代替

Capacitor+ Core

Tutorial on Capacitor+ Core