Getting Started

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

AI-Assisted セットアップを使用して、Capacitor+をインストールできます。次のコマンドを使用して、CapgoスキルをAIツールに追加します。

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 セットアップを使用する場合は、次のコマンドを実行してパッケージをインストールし、以下のプラットフォーム固有の指示に従ってください。

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. Initialize Capacitor

   npm

   npx cap init

   ユーストコンタートストロスト

   pnpm cap init

   pnpm

   yarn cap init

   bun

   bunx cap init

4. プラットフォームを追加

   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. Capacitor + パッケージをインストール

   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

注意

codeの変更は必要ありません! Capacitor+には公式のAPIと同じCapacitorが含まれており、インポートとcodeはすべて同じままです。

使用方法

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. Daily Sync: GitHub テストに当前を読んだ ionic-team/capacitor
2. PR バーターコンター: バーターコンターをバーターコンターに反たる plus バストログ
3. : バストログにコンタータイバログラビグを読んだアシアバーターコンター
4. : アシアバーターコンターにバストログを読んだアシアバーターコンターバーターコンタータイバログラビグを読んだ
5. アシアバーターコンターバーターコンタータイバログラビグを読んだアシアバーターコンターバーターコンタータイバログラビグを読んだ
6. アシアバーターコンターバーターコンタータイバログラビグを読んだnpmに新しいバージョンが公開されました。 @capacitor-plus/*

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

アップストリームの各Syncは、以下の内容を分析します。

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

注意

__CAPGO_KEEP_0__ リポジトリに問題が発生した場合、PRは手動レビューにフラグが付けられ、自動マージされません。この手順により、常に安定した、セキュアなリリースを取得できます。

PRを提出する

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

1. __CAPGO_KEEP_0__ リポジトリに問題が発生した場合、問題を報告する 公式__CAPGO_KEEP_0__ リポジトリに Capacitor+ リポジトリ __CAPGO_KEEP_0__+ のアップストリーム PR にリンク

2. または直接 PR を提出 アップストリームの plus ブランチ

3. チームは、CI を実行し、通過した場合にマージします。

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

FAQ

この製品は、実稼働用に適していますか?

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

公式のプラグインはまだ動くでしょうか?

はい。すべての @capacitor/* プラグインはCapacitor+で出荷されています。

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

AI セキュリティ レビューでは、破壊的な変更を手動でレビューします。変更はマージされる前にドキュメント化されます。

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

ファイルを Capacitor+ GitHubリポジトリに問題を報告してください。公式のCapacitorも影響を受ける問題については、上流の協力も受けます。

協力することはできますか？

もちろんです！PRは歓迎されています。直接修正を提出するか、特定のアップストリームPRをマージするように求めることができます。

始めから続けてください

あなたが 始めから ネイティブ プラグインの作業を計画する場合に接続する Using Capacitor+ (@capacitor-plus) Packages Using Capacitor+ (@capacitor-plus) Packages でネイティブ機能のCapgo+ (@__CAPGO_KEEP_1__-plus) Packages Capgo Plugin Directory Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, __CAPGO_KEEP_0__ プラグイン __CAPGO_KEEP_1__ によって プラグインの追加または更新 プラグインの追加または更新の実装詳細についても