시작하기

설치

        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.

그리고

dry-run을 사용하여 적용하기 전에 doctor dry-run을 적용하기 전에

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

클립보드에 복사 apply 선택한 패치들을 수동으로 실행하고 싶을 때

npx capgo-capacitor-patch apply --phase package

설정 옵션

옵션	타입	기본값	설명
`recommended`	`boolean`	`false`	Capgo 마크된 패치들을 권장 패치로 적용합니다.
`patches`	`string[]`	`[]`	explicit 패치 ID를 적용합니다.
`disabled`	`string[]`	`[]`	권장 패치 ID를 제외하고 선택한 패치 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.
선택한 패치 ID를 추가합니다. plugins.CapacitorPatch.patches.
실행 npx capgo-capacitor-patch doctor --strict.
실행 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.

__CAPGO_KEEP_1__

Capacitor-Patch를 사용 중이라면 Getting Started Capacitor-Patch를 사용하여 네이티브 플러그인 작업을 계획하고자 한다면 Using @capgo/capacitor-patch for the native capability in Using @capgo/capacitor-patch, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, __CAPGO_KEEP_1__ __CAPGO_KEEP_0__ Ionic Enterprise Plugin 대체 옵션 Ionic Enterprise Plugin 대체 옵션에 대한 제품 워크플로입니다.