Getting Started

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

        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 설치를 사용하여 플러그인을 설치할 수 있습니다. 다음 명령어를 사용하여 AI 도구에 Capgo 기능을 추가하세요.

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음 명령어를 사용하여 __CAPGO_KEEP_0__ 기능을 추가하세요.

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. Native 프로젝트 패치가 나중에 실행됩니다. 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[]`	`[]`	명시적 패치 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 패치 단계 실행을 제한합니다.
--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 command uses the patched CLI code.

Getting Started에서 계속하세요.

Getting Started __CAPGO_KEEP_0__ 패키지를 사용하는 경우, 다음 명령어를 실행하세요. native 플러그인 작업을 계획하기 위해, 그것을 연결하세요. @capgo/capacitor-patch를 사용하여 @capgo/capacitor-patch @capgo/capacitor-patch의 native 기능을 위해 @capgo/capacitor-patch를 사용하여 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리의 제품 워크플로우를 위해 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 정보를 위해 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트하는 구현 세부 정보를 위해, Ionic Enterprise 플러그인 대체품 Ionic Enterprise 플러그인 대체품의 제품 워크플로우를 위해