Getting Started

インストール

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[]	[]	__CAPGO_KEEP_0__ の明示的なパッチ ID を適用します。
disabled	string[]	[]	__CAPGO_KEEP_0__ の選択されたパッチ ID をスキップします。推奨されていても。
strict	boolean	false	__CAPGO_KEEP_0__ の選択されたパッチが不一致または適用できない場合に例外を投げます。

ヒント

明示的なものを好む patches code のレビューで適用された修正が表示されるように、code のプロダクション アプリケーション向けに推奨します。

CLI コマンド

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

便利なオプション:

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

ワークフロー

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

選択されたパッチが__CAPGO_KEEP_0__パッケージにインストールされている場合、パッチは__CAPGO_KEEP_0__パッケージと次の @capacitor/cliコマンドはパッチされたCLI __CAPGO_KEEP_1__を使用します。 cap command uses the patched CLI code.

Getting Startedから続けて

Getting Started Capacitorを使用してネイティブプラグインの作業を計画する場合、Capacitorを接続してください。 Getting Started Capgoの@capgo/capacitor-patchを使用 Capgoの@capgo/capacitor-patchのネイティブ機能 Capgo プラグインディレクトリ Capgo プラグインの製品ワークフロー Capacitor プラグイン ( Capgo による) Capacitor プラグイン ( Capgo による)の実装詳細 プラグインの追加または更新 プラグインの追加または更新の実装詳細 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフロー