スタートガイド

インストール

CapgoのAIアシスタントセットアップを使用してプラグインをインストールできます。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セットアップを使用する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

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	選択したパッチが不互換または適用できない場合に例外を投げます。

ヒント

プロダクション用アプリケーションでは明示的に指定することをお勧めします。修正が __CAPGO_KEEP_0__ のレビューで確認できるようになります。 patches code コマンド

「CLI コマンド」

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

アプリケーションルートを設定します。

• --root <dir> 修正フェーズの実行を制限します。
• --phase package|native|all プラットフォームフィルタリングを __CAPGO_KEEP_0__ のハック外で実行します。
• --platform ios|android applies platform filtering outside a Capacitor hook.
• --strict 選択したパッチのエラーとして扱います。

ワークフロー

1. インストール @capgo/capacitor-patch.
2. 実行 npx capgo-capacitor-patch list --all.
3. 選択したパッチ ID を追加します。 plugins.CapacitorPatch.patches.
4. 実行 npx capgo-capacitor-patch doctor --strict.
5. 実行 npx cap sync.

選択したパッチがインストールされている __CAPGO_KEEP_0__ パッケージと次の __CAPGO_KEEP_1__ に適用されます。 @capacitor/cli, the patch applies to the installed CLI package and the next cap command uses the patched CLI code.

ワークフロー

If you are using Getting Started を使用してネイティブプラグインの作業を計画する場合、以下の手順に従ってください。 Using @capgo/capacitor-patch for the native capability in Using @capgo/capacitor-patch, Capgo プラグインディレクトリ Capgo プラグイン Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新 __CAPGO_KEEP_0__はCapacitor Patchのプラグインです。__CAPGO_KEEP_1__はCapacitor Patchのプラグインです。 Ionic Enterprise プラグインの代替 __CAPGO_KEEP_0__の製品ワークフロー