시작하기

설치

        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.

적용하기 전에 시뮬레이션

사용 doctor 선택한 패치가 설치된 패키지 버전과 일치하는지 확인하려면:

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를 무시
`strict`	`boolean`	`false`	선택한 패치 ID가 불일치하거나 적용할 수 없을 때 예외 발생

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__ 패키지와 다음 @capacitor/cli명령어는 패치된 CLI __CAPGO_KEEP_1__를 사용합니다. cap Capacitor Patch 명령어는 패치된 CLI code을 사용합니다.

시작부터 계속

Capacitor-patch를 사용 중이라면 Getting Started 자연 플러그인 작업을 계획하려면 Capacitor-patch를 사용하여 @capgo/capacitor-patch와 연결하세요 Capacitor-patch에서 @capgo/capacitor-patch의 네이티브 기능을 위해 @Capgo Plugin Directory @Capgo Plugin Directory에서 제품 워크플로우를 위해 @Capacitor Plugins by @Capgo @Capacitor Plugins by @Capgo의 구현 세부 정보를 위해 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트하는 구현 세부 정보를 위해 Ionic Enterprise Plugin 대체 옵션 아이온틱 엔터프라이즈 플러그인 대체제의 제품 워크플로우에 대해.