시작하기

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

        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.

설치

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.

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

npm install @capgo/capacitor-patch
npx cap sync

Capacitor 설정에서 패치를 선택하기 전까지 이 패키지는 아무런 동작을 하지 않습니다.

빠른 시작

bun add @capgo/capacitor-patch
npx cap sync

자주 하는 실수

Capacitor 업그레이드 전 버전 게이트를 확인하세요.
cap sync를 실행하기 전 CI 환경에 설치하세요.
네이티브 코드를 수정한 후에는 sync를 다시 실행하세요.

패치 ID 선택

배포된 모든 패치 목록:

npx capgo-capacitor-patch list --all

그다음 앱에 필요한 patch 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 선택한 패치가 설치된 패키지 버전과 일치하는지 확인하려면:

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 실행할 patch phase를 제한합니다.
--platform ios|android Capacitor hook 외부에서 플랫폼 필터링을 적용합니다.
--strict 선택한 patch 실패를 에러로 처리합니다.

워크플로우

설치 @capgo/capacitor-patch.
실행 npx capgo-capacitor-patch list --all.
선택한 패치 ID를 다음에 추가: plugins.CapacitorPatch.patches.
실행 npx capgo-capacitor-patch doctor --strict.
실행 npx cap sync.

선택한 패치가 다음을 대상으로 할 때, @capacitor/cli해당 패치는 설치된 CLI 패키지에 적용되며, 다음 cap 명령어는 패치된 CLI code를 사용합니다.

시작하기 다음 단계

사용 중이라면 시작하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-patch 사용하기 @capgo/capacitor-patch 사용 시 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.