はじめ方

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

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. プラットフォームを追加

   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

Capacitorから公式Capacitorへの移行

既存のCapacitorプロジェクトがある場合は、Capacitor+への移行は簡単です:

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

メモ

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. 毎日同期: GitHub アクションで最新の変更を取得 ionic-team/capacitor
2. プルリクエストの作成: __CAPGO_KEEP_0__ に変更を提案する plus ブランチ
3. CI検証: 全テストスイートを実行 (lint、ユニットテスト、iOSビルド、Androidビルド)
4. セキュリティレビュー: AIパワー分析で脆弱性や破壊的な変更を検知
5. 自動マージ: CIが通過し、セキュリティレビューが承認した場合のみ
6. Auto-Publish: npm に新しいバージョンが公開されました。 @capacitor-plus/*

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

Section titled “Security Review Details”

Check	Every upstream sync is analyzed for:
チェック	What It Catches
検知されるもの	Security
セキュリティ	Null ポインタ参照、未処理の例外、レース条件、メモリリーク
データセキュリティ	データ損失シナリオ、プライバシー侵害、不正確なストレージ
Code の完全性	不明瞭な code、疑わしいネットワークコール、バックドア

注意

問題が検出された場合、PR は手動レビュー用にフラグ付けされ、自動マージされません。このようにすることで、常に安定した、セキュアなリリースを取得できます。

プルリクエストの提出

公式 Capacitor リポジトリにプルリクエストが詰まっている場合、Capacitor+ で解決してください:

1. 問題を開く Capacitor Plus Capacitor+ repo アップストリーム PR にリンクする

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

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

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

FAQ

このプロダクション用?

はい。 Capacitor+ は実稼働アプリケーションで使用されています。 すべてのリリースは、公式の Capacitor と同じテストスイートに加えて、追加のセキュリティ分析を通過します。

公式プラグインは機能しますか?

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

アップストリームが破壊的な変更をリリースした場合どうしますか?

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

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

Section titled “How do I report issues?” is not translated as it is a heading and should be kept short. It is translated as Capacitor+ GitHub repo.公式のCapacitorにも影響を与える問題については、上流の調整を支援します。

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

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

「Getting Started」から続けてください。

「Getting Started」を使用して ネイティブ プラグインの作業を計画する場合、 「Using __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages」 「Using Capacitor+ (@capacitor-plus) Packages」 for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Capgo+ (@__CAPGO_KEEP_1__-plus) Packages Capgo プラグイン ディレクトリの製品ワークフローについて Capacitor プラグインは Capgo によって提供されます Capacitor Plusの実装詳細については、Capacitor プラグインによってCapgoで管理されます。 プラグインの追加または更新 プラグインの追加または更新の実装詳細について イオニック エンタープライズ プラグインの代替 __CAPGO_KEEP_0__ プラグインの製品ワークフローについて