ガイド
Capacitor+ Coreを使用する方法は、Capacitorで
Using Capacitor+ (@capacitor-plus) Packages
Capacitor+は、常に同期された自動フォークです。 Capacitor Capacitor+ を維持するのは Capgo. It provides a drop-in replacement for the official Capacitor packages with one key advantage: Capacitor+ の存在の理由.
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+はこの問題を解決することで:
- - upstream キューに溜まっている価値のある PR が積極的にマージされます。 - 上流キューに溜まっている価値あるPRが積極的にマージされます。
- 連続Sync 上流のCapacitorから、すべての変更が自動的に取得、テスト、検証されます
- 迅速なリリース CIで変更が通過すると、npmに自動的に公開されます
@capacitor-plusスコープ - コミュニティ第一 コミュニティからの貢献は大切にされており、優先されます
- セキュリティレビュー すべての変更はAIによってセキュリティ脆弱性、破壊的変更、安定性リスクを分析されます
利用可能なパッケージ
| パッケージ | 説明 |
|---|---|
@capacitor-plus/core |
コアランタイムライブラリ |
@capacitor-plus/cli |
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+への移行では、__CAPGO_KEEP_2__の変更は必要ありません。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';
Capgo Builder / ネイティブクラウドビルド製品ページのセクションまたはページヘッダー。ロール: セクションまたはページヘッダー。メッセージキー `native_build_how_it_works_title` (ネイティブビルドのしくみのタイトル)。 | ホームページの問題/解決セクション。ロール: 短いUIラベルまたはナビゲーションアイテム。ページ `premium-support.astro` で見られる。メッセージキー `ps_how_it_works` (PSのしくみ)。 | ライブアップデート製品ページのセクションまたはページヘッダー。ロール: セクションまたはページヘッダー。メッセージキー `live_update_how_it_works_title` (ライブアップデートのしくみのタイトル)。
┌─────────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ 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 作成: __CAPGO_KEEP_0__ の変更はプルリクエストとして提案されます。
plusブランチ - CI 検証: 全テストスイートが実行されます (lint、ユニットテスト、iOS ビルド、Android ビルド)
- クラウド Code レビュー: AI が駆使された包括的なセキュリティ分析が行われます。
- セキュリティ脆弱性 (インジェクション、XSS など)
- 破壊的な API 変更
- クラッシュリスクと安定性の問題
- データの整合性とプライバシーに関する懸念
- 悪意のある code パターン
- Auto-Merge: CI が通過し、クレードが承認した場合 (問題なし)
- Auto-Publish: 新しいバージョンが npm 以下に公開される
@capacitor-plus/*
セキュリティレビュー
アップストリームの各 Sync は次の要素を分析します:
| チェック | 説明 |
|---|---|
| セキュリティ | コマンドインジェクション、XSS、パス トラバーサル、ハードコードされたシークレットなど |
| 変更点 | 削除/名前変更されたAPI、サインチャージェネレータ、構成フォーマットの変更 |
| 安定性 | コンテキスト: Enterprise製品/価格ページ。役割: UIラベル。ページ: enterprise.astro |
| データセキュリティ | データの安全性 |
| Code の完全性 | codeの完全性 |
__CAPGO_KEEP_0__のオブフュージング、疑わしいネットワークコール、バックドア
プルリクエストが検出された場合、プルリクエストは手動レビューのためにフラグが付けられ、自動マージされません。
Have a PR stuck in the official Capacitor repo? Here's how to get it into Capacitor+:
- 公式__CAPGO_KEEP_0__リポジトリにプルリクエストが詰まっている場合は、ここでどうやって__CAPGO_KEEP_1__+にプルリクエストを入れるかを知りたい。 日本語 Capacitor+ リポジトリ アップストリーム PR にリンクする
- または直接アップストリーム PR を提出する アップストリーム
plusブランチ - チームはそれをレビューし、CIを実行し、通過した場合にマージする
このように、すぐにアップストリームのリリースサイクルを待たずに、自分の作業から他のユーザーがすぐに利益を得ることができる
メリット
- 現在の PR を取得する: コミュニティがアップストリームで待っている修正と機能をマージする
- 最新の状態を維持する: 最新修正をCIが通過した直後に取得
- セキュリティファースト: セキュリティと安定性のリスクを検証する
- 検証済みリリース: CIテストとAIセキュリティレビューを両方通過した変更のみが公開される
- ドロップイン置き換え: API と Capacitor は同じですが、パッケージスコープが異なります。
- あなたの声が聞こえる: 自分の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+ (@capacitor-plus) パッケージを使用してください。
__CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) パッケージを使用している場合 Capacitor+ (@capacitor-plus) パッケージを使用している場合 native plugin work を計画するには、を接続する Capacitor+ Capacitor+ の実装詳細については、Capacitor+ を参照してください。 Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフローについては、Capgo プラグイン ディレクトリを参照してください。 Capacitor Capgoのプラグイン Capacitor Plusの実装詳細については、Capacitor プラグインによってCapgoで管理されます。 プラグインの追加または更新 Capacitor+ (@Capacitor-plus) パッケージの使用 Capacitor+ の存在の理由 利用可能なパッケージ