Getting Started

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

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+は公式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 アクションで最新の変更を取得します。 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. 問題を報告する 「 Capacitor+ リポジトリ アップストリームのPRにリンクする

2. Or 直接提出する アップストリームの plus ブランチ

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

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

FAQ

このプロダクション用?

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

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

はい、すべての @capacitor/* Capacitor+のプラグインは、箱の中から動作します。

アップストリームが破壊的な変更をリリースした場合に何が起こるでしょうか?

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

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

__CAPGO_KEEP_0__+ __CAPGO_KEEP_1__ リポジトリに Capacitor+ GitHub repo. For issues that also affect official Capacitor, we’ll help coordinate upstream.

Can I contribute?

ぜひ！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 実装詳細については Capacitor プラグインの Capgo を参照してください。 プラグインの追加または更新 実装詳細についてはプラグインの追加または更新、 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフローについては