スタートガイド

クイックスタート

bun add @capgo/capacitor-plus
npx cap sync

よくある落とし穴

• すべての @capacitor/* 依存関係を置き換えてください。
• 移行後に Native Build プロジェクトを再生成します。
• バージョンを上げる前にリリースノートを確認してください。

新規プロジェクトへの導入

AIアシストによるセットアップを使用して 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.

手動でのセットアップを希望する場合は、以下のコマンドを実行してパッケージをインストールし、各プラットフォームごとの手順に従ってください：

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+ への移行は簡単です：

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+ は公式の Capacitor と同じ API を備えています。import も 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();

同期の仕組み

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

1. デイリー同期： GitHub Actions が最新の変更を取得します ionic-team/capacitor
2. PRの作成: 変更内容はプルリクエストとして〜へ提案されます plus ブランチ
3. CI検証: フルテストスイートを実行 (lint, ユニットテスト, iOSビルド, Androidビルド)
4. セキュリティレビュー: AIによる解析で脆弱性や破壊的変更をチェック
5. 自動マージ: CIが通り、かつセキュリティレビューが承認された場合のみ
6. 自動公開: 新しいバージョンが npm に〜の下で公開されます @capacitor-plus/*

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

アップストリーム同期ごとに以下を分析します：

確認	検知対象
セキュリティ	コマンドインジェクション、XSS、パス・トラバーサル、ハードコードされたシークレット
破壊的変更	削除/名称変更されたAPI、シグネチャの変更、設定の変更
安定性	Null参照、未処理の例外、レースコンディション、メモリリーク
データ セーフティ	データ損失のシナリオ、プライバシー侵害、安全でないストレージ
Code の完全性	難読化された code、不審なネットワーク通信、バックドア

注意

問題が検出されると、そのPRは手動レビュー対象としてフラグが立てられ、自動マージは行われません。これにより、常に安定した安全なリリースが保証されます。

PRの提出方法

公式の Capacitor リポジトリでPRが止まっていませんか？ Capacitor+ でマージしましょう：

1. Issueを作成する の Capacitor+ リポジトリ アップストリームのPRへのリンク

2. または直接提出する へのPRとして plus ブランチ

3. チームがレビューとCIを実行し、通過すればマージします

これにより、アップストリームのリリースサイクルを待たずに、あなたも他の人もあなたの作業の成果をすぐに活用できます。

よくある質問

本番環境で使えますか？

はい。Capacitor+ は本番アプリで使われています。すべてのリリースは公式の Capacitor と同じテストスイートに加え、追加のセキュリティ分析も通過しています。

公式プラグインは引き続き動作しますか？

はい。すべての @capacitor/* プラグインが Capacitor+ でそのまま動作します。

アップストリームで破壊的変更があった場合は？

AIセキュリティレビューが破壊的変更を検出し、手動レビューに回します。変更内容はマージ前にドキュメント化され、確認できます。

Issueの報告方法は？

Issueは Capacitor+ GitHub リポジトリで作成してください。公式の Capacitor にも影響するIssueについては、アップストリームとの調整を支援します。

コントリビュートできますか？

もちろんです！PRは大歓迎です。直接修正を提出していただくことも、特定のアップストリームPRのマージをリクエストしていただくことも可能です。

Getting Startedの続きを進める

使用している場合 スタートガイド ネイティブプラグインの作業を計画するには、次と連携してください： Capacitor+ (@capacitor-plus) パッケージの使用 Using Capacitor+ (@capacitor-plus) Packages でのネイティブ機能について Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。