Capacitor+ (@capacitor-plus) パッケージを使用する

Capacitor+ は自動化された、常に同期されたフォークです。 Capacitor __CAPGO_KEEP_0__ によって維持されています Capgo. これは公式のCapacitorパッケージの置き換えとして使用できます。 コミュニティのPRと修正は、より速く.

Why Capacitor+ Exists

The Ionic team maintains Capacitor with their own priorities and release schedule. This means community contributions - bug fixes, improvements, and features - can wait months or even years to be merged. Some never make it at all.

Capacitor+ solves this problem by:

フォークからのPRのマージ - 上流キューに詰まっている価値のあるPRは、積極的にマージされます
継続的な同期 - Every change from upstream Capacitor is automatically pulled, tested, and verified
迅速なリリース - When changes pass CI, they're automatically published to npm under the @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から__CAPGO_KEEP_1__+への移行

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+は公式の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
: 変更はプルリクエストとして提案されます公式の__CAPGO_KEEP_0__から__CAPGO_KEEP_1__+への移行 plus ブランチ
CI検証: フルテストスイートが実行されます (lint、ユニットテスト、iOSビルド、Androidビルド)
クラウド Code レビュー: AIパワードの包括的なセキュリティ分析が実行されます。
- セキュリティ脆弱性 (インジェクション、XSS、など)
- クラウド API の変更が破壊的
- クラッシュリスクと安定性の問題
- データの整合性とプライバシーに関する懸念
- クラウド code の悪意のあるパターン
Auto-Merge: CIが通過し、クラウドが承認した場合 (問題なし)
Auto-Publishnpmに新しいバージョンが公開されました @capacitor-plus/*

Security Review

Every upstream sync is analyzed for:

Check	Description
Security	Command injection, XSS, path traversal, hardcoded secrets, etc.
Breaking Changes	Removed/renamed APIs, changed signatures, config format changes
Stability	Null dereferences, unhandled exceptions, race conditions, memory leaks
データセキュリティ	データ喪失シナリオ、プライバシー侵害、不正確なデータストレージ
Code の完全性	code がオブスキュードされたり、疑わしいネットワークコールやバックドアが検出されたりする

__CAPGO_KEEP_0__ の問題が検出された場合、PR は手動レビュー用にフラグ付けされ、自動マージされません。

PR をマージしたい?

Capacitor の公式リポジトリにPRが詰まっている場合、Capacitor+ へのPRの流れ方を知りたい?

__CAPGO_KEEP_0__+ リポジトリで __CAPGO_KEEP_0__+ リポジトリで Capacitor+ リポジトリの __CAPGO_KEEP_0__+ リポジトリの
または直接__CAPGO_KEEP_1__+ にPRを提出する to the plus branch
チームはレビュー、CIを実行し、CIが通過した場合にマージします。

このように、すぐにアップストリームのリリースサイクルを待たずに、自分の作業から他のユーザーがすぐに利益を得ることができます。

Benefits

Get Stuck PRs Now: アップストリームで待っているコミュニティの修正と機能がマージされます。
Stay Current: アップストリームの修正がCIを通過したときにすぐに取得できます。
Security First: すべての変更は脆弱性と安定性のリスクを検証します。
Verified Releases: __CAPGO_KEEP_0__の変更はCIテストとAIセキュリティレビューの両方を通過したもののみが公開されます。
Drop-in Replacement: APIとCapacitorは同じですが、パッケージスコープが異なります。
Your Voice Matters: 自分でPRを提出するか、特定のアップストリームPRをマージすることをリクエストすることができます。

Example: 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 ネイティブプラグインの作業を計画するには、接続する Capacitor+ Capacitor+の実装詳細について Capgo プラグインディレクトリ Capgo プラグインディレクトリの製品ワークフローについて Capacitor プラグインズ by Capgo Capacitor プラグインズ by Capgoの実装詳細についてプラグインの追加または更新 __CAPGO_KEEP_0__ プラグインズ by __CAPGO_KEEP_1__の実装詳細について、イオニックエンタープライズプラグインの代替イオニックエンタープライズプラグインの代替の製品ワークフローについて

Capacitor+ Core

Capacitor+コアに関するチュートリアル