Getting Started

新プロジェクトのインストール

AI-Assisted Setupを使用して、Capacitor+をインストールできます。AIツールにCapgoスキルを追加するには、以下のコマンドを実行してください。

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次に、以下のプロンプトを使用してください:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capacitor-plus/core`, `@capacitor-plus/cli`, `@capacitor-plus/android`, and `@capacitor-plus/ios` packages in my project.

Manual Setup を使用する場合は、以下のコマンドを実行して、下記のプラットフォーム固有の手順に従ってください:

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. __CAPGO_KEEP_0__

   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

Migrating from Official Capacitor

If you have an existing Capacitor project, migrating to Capacitor+ is simple:

1. 公式のパッケージを削除

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

2. 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

3. プロジェクトを同期

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

注記

No code changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

使用方法

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();

Syncのしくみ

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

1. 毎日Sync: GitHub Actions 最新の変更を取得 ionic-team/capacitor
2. PRの作成: __CAPGO_KEEP_0__ に変更を提案する plus branch
3. CI検証: lint、ユニットテスト、iOSビルド、Androidビルドのフルテスト
4. セキュリティレビュー: AIパワーで脆弱性と破壊的な変更を検証
5. 自動マージ: CI が通過し、セキュリティレビューが承認した場合
6. 自動公開: 新しいバージョンが npm 以下に公開される @capacitor-plus/*

セキュリティレビュー詳細

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

チェック	検出対象
セキュリティ	コマンドインジェクション、XSS、パス トラバーサル、ハードコードされたシークレット
変更点	APIの削除/変更、サインチャーの変更、構成の変更
安定性	Nullポインタの参照、未処理の例外、競合条件、メモリリーク
データの安全性	データの喪失シナリオ、プライバシー侵害、不正確なストレージ
Codeの完全性	codeのオブフュージング、疑わしいネットワークコール、バックドア

注意

プルリクエストに問題が検出された場合、手動レビューが行われ、自動マージは行われません。このようにすると、常に安定した、安全なリリースを取得できます。

プルリクエストの提出

公式のCapacitorリポジトリにPRが詰まっている場合、Capacitor+でマージしてください:

1. 問題を開く 公式の Capacitor+リポジトリ アップストリームのPRへのリンク

2. または直接 ブランチとして plus チームはレビュー、CIを実行し、通過した場合にマージします

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

FAQ

コンテキスト: Capgo Builder / ネイティブクラウドビルド製品ページ。役割: セクションサブタイトルまたはキャッチコピー。見られる場所: page native-build.astro。メッセージキー `native_build_builder_faq_eyebrow` (Native Build Builder FAQ Eyebrow)。 | コンテキスト: Capgo ソリューションズマーケティングページ。役割: セクションまたはページヘッダー。見られる場所: page solutions/cordova-to-capacitor.astro。メッセージキー `solutions_cordova_to_capacitor_faq_title` (Solutions Cordova To Capacitor FAQ Title)。

この製品は、実用的な環境で使用できるか?

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

公式のプラグインは機能するでしょうか?

はい。すべてのプラグインはCapgo+と組み合わせて使用できます。 @capacitor/* plugins work with Capacitor+ out of the box.

「アップストリームが破壊的な変更をリリースした場合どうすればよいですか?」

問題を報告するにはどうすればよいですか?

「問題を報告するにはどうすればよいですか?」

問題点をファイルに記録する Capacitor + GitHub リポジトリCapacitor + __CAPGO_KEEP_1__ リポジトリに問題点を記録する。公式の Capacitor に影響する問題点についても、上流の調整を支援します。

コントリビュートすることはできますか?

もちろんです! プルリクエストは歓迎されています。直接修正を提出するか、特定の上流のプルリクエストをマージするよう要求することができます。

Getting Started から続けてください

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