メインコンテンツにジャンプします
@>capacitor-plus/core 開発者ツール オープンソース

Capacitor+ Core Capacitor プラグイン

Capacitor+ は、コミュニティからのPRをマージし、迅速なリリースを実施した自動化された、常に同期されたCapacitorのフォークです。

インストール

bun add @capacitor-plus/core bunx cap sync
npm、pnpm、またはyarn
  • npm install @capacitor-plus/core
  • pnpm add @capacitor-plus/core
  • yarn add @capacitor-plus/core

ガイド

Capacitor+ Coreを使用する方法は、Capacitorで

Using Capacitor+ (@capacitor-plus) Packages

Capacitor+は、常に同期された自動フォークです。 Capacitor Capacitor+ を維持するのは Capgo. It provides a drop-in replacement for the official Capacitor packages with one key advantage: Capacitor+ の存在の理由.

Why Capacitor+ Exists

The Ionic team maintains Capacitor with their own priorities and release schedule. This means community contributions - bug fixes, improvements, and features - can wait months or even years to be merged. Some never make it at all.

Capacitor+はこの問題を解決することで:

  1. - upstream キューに溜まっている価値のある PR が積極的にマージされます。 - 上流キューに溜まっている価値あるPRが積極的にマージされます。
  2. 連続Sync 上流のCapacitorから、すべての変更が自動的に取得、テスト、検証されます
  3. 迅速なリリース CIで変更が通過すると、npmに自動的に公開されます @capacitor-plus スコープ
  4. コミュニティ第一 コミュニティからの貢献は大切にされており、優先されます
  5. セキュリティレビュー すべての変更はAIによってセキュリティ脆弱性、破壊的変更、安定性リスクを分析されます

利用可能なパッケージ

パッケージ 説明
@capacitor-plus/core コアランタイムライブラリ
@capacitor-plus/cli CLI
@capacitor-plus/android Android ランタイム
@capacitor-plus/ios iOS ランタイム

インストール

新プロジェクト

新しいプロジェクトを作成するには、公式のパッケージの代わりにCapacitor+パッケージを使用してください。

npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android  # for Android
npm install @capacitor-plus/ios      # for iOS

プロジェクトを初期化してください。

npx cap init
npx cap add android
npx cap add ios

公式のCapacitorから__CAPGO_KEEP_1__+への移行

公式のCapacitorからCapacitor+への移行では、__CAPGO_KEEP_2__の変更は必要ありません。Capacitorが同じなので、インポートは同じままです:

# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

# 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

Since Capacitor+ is a drop-in replacement with the same API, no code changes are required. Your imports remain the same:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

Capgo Builder / ネイティブクラウドビルド製品ページのセクションまたはページヘッダー。ロール: セクションまたはページヘッダー。メッセージキー `native_build_how_it_works_title` (ネイティブビルドのしくみのタイトル)。 | ホームページの問題/解決セクション。ロール: 短いUIラベルまたはナビゲーションアイテム。ページ `premium-support.astro` で見られる。メッセージキー `ps_how_it_works` (PSのしくみ)。 | ライブアップデート製品ページのセクションまたはページヘッダー。ロール: セクションまたはページヘッダー。メッセージキー `live_update_how_it_works_title` (ライブアップデートのしくみのタイトル)。

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  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 作成: __CAPGO_KEEP_0__ の変更はプルリクエストとして提案されます。 plus ブランチ
  3. CI 検証: 全テストスイートが実行されます (lint、ユニットテスト、iOS ビルド、Android ビルド)
  4. クラウド Code レビュー: AI が駆使された包括的なセキュリティ分析が行われます。
    • セキュリティ脆弱性 (インジェクション、XSS など)
    • 破壊的な API 変更
    • クラッシュリスクと安定性の問題
    • データの整合性とプライバシーに関する懸念
    • 悪意のある code パターン
  5. Auto-Merge: CI が通過し、クレードが承認した場合 (問題なし)
  6. Auto-Publish: 新しいバージョンが npm 以下に公開される @capacitor-plus/*

セキュリティレビュー

アップストリームの各 Sync は次の要素を分析します:

チェック 説明
セキュリティ コマンドインジェクション、XSS、パス トラバーサル、ハードコードされたシークレットなど
変更点 削除/名前変更されたAPI、サインチャージェネレータ、構成フォーマットの変更
安定性 コンテキスト: Enterprise製品/価格ページ。役割: UIラベル。ページ: enterprise.astro
データセキュリティ データの安全性
Code の完全性 codeの完全性

__CAPGO_KEEP_0__のオブフュージング、疑わしいネットワークコール、バックドア

プルリクエストが検出された場合、プルリクエストは手動レビューのためにフラグが付けられ、自動マージされません。

Have a PR stuck in the official Capacitor repo? Here's how to get it into Capacitor+:

  1. 公式__CAPGO_KEEP_0__リポジトリにプルリクエストが詰まっている場合は、ここでどうやって__CAPGO_KEEP_1__+にプルリクエストを入れるかを知りたい。 日本語 Capacitor+ リポジトリ アップストリーム PR にリンクする
  2. または直接アップストリーム PR を提出する アップストリーム plus ブランチ
  3. チームはそれをレビューし、CIを実行し、通過した場合にマージする

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

メリット

  • 現在の PR を取得する: コミュニティがアップストリームで待っている修正と機能をマージする
  • 最新の状態を維持する: 最新修正をCIが通過した直後に取得
  • セキュリティファースト: セキュリティと安定性のリスクを検証する
  • 検証済みリリース: CIテストとAIセキュリティレビューを両方通過した変更のみが公開される
  • ドロップイン置き換え: API と Capacitor は同じですが、パッケージスコープが異なります。
  • あなたの声が聞こえる: 自分のPRを提出するか、特定のアップストリームPRをマージすることを要求する

例: Capacitor+をプラグインと組み合わせる

公式のCapacitorプラグインはすべて、Capacitor+と完全に互換性があります:

import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

// Everything works exactly the same
const platform = Capacitor.getPlatform();

const photo = await Camera.getPhoto({
  resultType: CameraResultType.Uri
});

const position = await Geolocation.getCurrentPosition();

CapgoプラグインもCapacitor+と完全に互換性があります:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });

それが終わりです! Capacitor のコミュニティ向けの改善がより速くマージされた、より高速に更新されたバージョンを手に入れました。アプリは、公式のリリースサイクルを待たずにバグ修正と機能の利益を受けることができます。

続けて、Capacitor+ (@capacitor-plus) パッケージを使用してください。

__CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) パッケージを使用している場合 Capacitor+ (@capacitor-plus) パッケージを使用している場合 native plugin work を計画するには、を接続する Capacitor+ Capacitor+ の実装詳細については、Capacitor+ を参照してください。 Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフローについては、Capgo プラグイン ディレクトリを参照してください。 Capacitor Capgoのプラグイン Capacitor Plusの実装詳細については、Capacitor プラグインによってCapgoで管理されます。 プラグインの追加または更新 Capacitor+ (@Capacitor-plus) パッケージの使用 Capacitor+ の存在の理由 利用可能なパッケージ

FAQ

Capacitor+ Core プラグインのFAQ

Capacitor+ Core プラグインを Capacitor アプリにインストールする方法は?

"bun add @capacitor-plus/core" (または "npm install @capacitor-plus/core" ) を実行し、次に "bunx cap sync" を実行して iOS と Android プロジェクトがネイティブ code を取得するようにします。次に、@capacitor-plus/core をアプリの code でインポートします。

@capacitor-plus/core は React、Vue、Angular とどのように動作するか?

はい。Capacitor+ Core は Capacitor パッケージなので、Capacitor 内で実行される任意の Web フレームワークと一緒に動作します。 例えば、Ionic、React、Vue、Angular、Svelte、または単純な JavaScript などです。

Capacitor-Plus の Capacitor バージョンは、@capacitor-plus/core がサポートしますか。

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capacitor-plus/core は無料でオープンソースですか?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-plus/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code を Capacitor+ Core を使用する場合、App Store のレビューなしでアップデートできますか?

code をインストールまたはアップグレードすると、ネイティブ code が変更されるため、新しいストアビルドが必要になります。その後、Capgo ライブアップデートを使用して、JavaScript、HTML、CSS の変更が即時で Capgo に配信できます。

Capacitor + コアの変更をアプリレビューの待たずに配信します。

プラグインがストアビルドに追加されたら、Capgo ライブアップデートは、JavaScript、HTML、CSS の変更をユーザーに 1 分間で反映します。

Capgo で始めましょう。