시작하기

설치

        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.

설치

Capacitor-Patch 플러그인을 설치하기 위해 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를 선택할 때까지 아무런 동작도 하지 않습니다.

패치 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 before applying

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를 제외하고 선택한 패치 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.

Getting Started

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, 플러그인을 추가하거나 업데이트 하세요 플러그인을 추가하거나 업데이트 하는 방법 Ionic Enterprise Plugin 대체 옵션 Ionic Enterprise Plugin 대체 옵션에 대한 제품 워크플로입니다.