Getting Started

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

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

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

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

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

__CAPGO_KEEP_0__ リポジトリの公式リポジトリでPRが取り付けられている場合、問題が検出された場合、PRは手動レビューにフラグが付けられ、自動マージされません。このようにして、常に安定した、セキュアなリリースを保証します。

PRの提出

セクション「PRの提出」

公式 Capacitor リポジトリでPRが取り付けられている場合、問題が検出された場合、PRは手動レビューにフラグが付けられ、自動マージされません。このようにして、常に安定した、セキュアなリリースを保証します。 Capacitor+: でPRをマージしてください。

1. 問題が発生しているPRを開く in the Capacitor+ リポジトリ アップストリーム PR にリンクする

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

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

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

FAQ

このプロダクション用に適しているか?

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

公式プラグインはまだ動作するでしょうか。

はい。すべてのプラグインは__CAPGO_KEEP_0__+で出荷されています。 @capacitor/* plugins work with Capacitor+ out of the box.

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

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

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

__CAPGO_KEEP_0__+ __CAPGO_KEEP_1__ Capacitor+ GitHub repo. 公式の Capacitor に影響を与える問題についても、上流の調整を支援します。

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

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

Getting Started から続けてください

Capacitor を使用している場合 Getting Started Capacitor プラグインの作業を計画する場合、Capacitor プラグインと接続します。 Using Capacitor+ (@capacitor-plus) Packages for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Capgo Plugin Directory 製品ワークフローについては、Capgo プラグインディレクトリで確認してください。 Capacitor プラグインは、Capgo によって提供されています。 実装詳細については、Capacitor プラグインの Capgo を確認してください。 プラグインの追加または更新 実装詳細については、プラグインの追加または更新の __CAPGO_KEEP_0__ を確認してください。 Ionic Enterprise プラグインの代替 製品ワークフローについては、Ionic Enterprise プラグインの代替を確認してください。