始めから始める

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

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

注記

codeの変更は必要ありません! Capacitor+は公式Capacitorと同じAPIを持ちます。インポートと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. 毎日Sync: GitHub Actionsは最新の変更を取得します。 ionic-team/capacitor
2. PR作成: __CAPGO_KEEP_0__ Actionsはプルリクエストとして提案します。 plus ブランチ
3. CI検証: __CAPGO_KEEP_0__ Actionsはlint、ユニットテスト、iOSビルド、Androidビルドのフルテストを実行します。
4. セキュリティレビュー: __CAPGO_KEEP_0__ Actionsは脆弱性や破壊的な変更を検知する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.

公式のプラグインは、正常に動作しますか?

はい。すべての @capacitor/* plugins work with Capacitor+ out of the box.

アップストリームから、破壊的な変更がリリースされました。どうすればいいですか?

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

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

問題はCloudflareの Capacitor + GitHub リポジトリCapacitor + __CAPGO_KEEP_1__ リポジトリ

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

「私たちに協力できますか?」

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

「Getting Startedから続けてください」 あなたが Getting Started Using Capacitor+ (@capacitor-plus) Packages for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Capgo Plugin Directory 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 プラグインの代替の製品ワークフロー