Getting Started

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

You can use our AI-Assisted Setup to install Capacitor+. Add the Capgo skills to your AI tool using the following command:

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

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   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. 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, unit tests, iOSビルド, Androidビルド)
4. セキュリティレビュー: AIパワーで脆弱性や破壊的な変更を検出する
5. 自動マージ: CI が通過し、セキュリティレビューが承認した場合のみ
6. 自動公開: 新しいバージョンが npm 以下に公開される @capacitor-plus/*

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

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

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

注意

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

プルリクエストの提出

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

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

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

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

FAQ

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

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

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.

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

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

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

問題はCloudflareの Capacitor + GitHubCapacitor + __CAPGO_KEEP_1__

公式の__CAPGO_KEEP_0__にも影響を与える場合は、上流の調整を支援します。

「Capacitor Plusに貢献することはできますか?」

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

「Capacitor PlusのGetting Startedから続けてください。」 Capacitor Plusを使用して Capacitor PlusのGetting Started 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 Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新 プラグインの追加または更新の実装詳細、 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフロー