スタートガイド

このプラグインのインストール手順と全マークダウンガイドを含むセットアップの質問をコピーする。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-patch`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/capacitor-patch/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

インストール

CapgoのAI-Assisted Setupを使用してプラグインをインストールできます。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 `@capgo/capacitor-patch` plugin in my project.

Manual Setupを使用する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

npm install @capgo/capacitor-patch
npx cap sync

パッケージは、Capacitor の設定でパッチを選択するまで、無効です。

パッチIDを選択

配信されているパッチの一覧:

npx capgo-capacitor-patch list --all

あなたのアプリに必要なパッチIDを追加してください。 capacitor.config.ts:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example',
  webDir: 'dist',
  plugins: {
    CapacitorPatch: {
      patches: ['upstream-pr-8418-android'],
      strict: true,
    },
  },
};

export default config;

再度syncを実行してください:

npx cap sync

パッケージのパッチは sync と update. sync ネイティブプロジェクトのパッチは update.

と

セクション doctor を使用して

npx capgo-capacitor-patch doctor --phase package --strict

クリップボードにコピー apply を使用して、選択したパッチを手動で実行したい場合:

npx capgo-capacitor-patch apply --phase package

設定オプション

オプション	タイプ	デフォルト	説明
`recommended`	`boolean`	`false`	推奨マークされたCapgoパッチを適用します。
`patches`	`string[]`	`[]`	指定されたパッチIDを適用します。
`disabled`	`string[]`	`[]`	選択したパッチIDをスキップします。推奨マークされた場合も。
`strict`	`boolean`	`false`	選択したパッチが不相応または適用できない場合に例外を投げます。

CLI コマンド

npx capgo-capacitor-patch list --all
npx capgo-capacitor-patch doctor
npx capgo-capacitor-patch apply

便利なオプション:

--root <dir> アプリケーションルートを設定します。
--phase package|native|all どのパッチフェーズが実行されるかを制限します。
--platform ios|android プラットフォームフィルタリングを Capacitor のハック外で適用します。
--strict エラーとして選択したパッチの失敗を処理します。

ワークフロー

セクション @capgo/capacitor-patch.
インストール npx capgo-capacitor-patch list --all.
実行 plugins.CapacitorPatch.patches.
選択したパッチのIDを追加します。 npx capgo-capacitor-patch doctor --strict.
実行 npx cap sync.

実行 @capacitor/cli選択したパッチがインストール済みのCLIパッケージと次の__CAPGO_KEEP_1__に適用される場合 cap command uses the patched CLI code.

続けてGetting Started

If you are using Getting Started を使用して Using @capgo/capacitor-patch Using @capgo/capacitor-patch Capgo Plugin Directory Capgo Plugin Directory Capacitor Plugins by Capgo Capacitor Plugins by Capgo 実装詳細 Adding or Updating Plugins Ionic Enterprise プラグインの代替 __CAPGO_KEEP_0__の製品ワークフロー