시작하기

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

        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.

설치

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.

dry-run을 적용하기 전에

사용 doctor __CAPGO_KEEP_0__을 확인하여 선택한 패치가 설치된 패키지 버전과 일치하는지 확인합니다.

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`	선택한 패치가 불일치하거나 적용할 수 없는 경우 예외를 발생시킵니다.

제목이 “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.
Run npx capgo-capacitor-patch doctor --strict.
Run npx cap sync.

__targetLanguage__에서 선택된 패치가 __CAPGO_KEEP_0__ 패키지를 설치하고 다음 @capacitor/cli명령어는 패치된 CLI __CAPGO_KEEP_1__를 사용합니다. cap command uses the patched CLI code.

Getting Started에서 계속하기

Getting Started __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__를 연결하여 Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-patch Using @capgo/capacitor-patch capgo/capacitor-patch를 사용하여 __targetLanguage__의 네이티브 기능을 연결합니다. Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우를 위해 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 사항을 위해 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항을 위해, 그리고 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체의 제품 워크플로우를 위해