@capgo/capacitor-patch

sync 및 업데이트를 위한 검증된 수정 사항을 Capacitor의 핵심 패키지, CLI, 플러그인 및 네이티브 프로젝트에 적용합니다.

@capgo/capacitor-patch is a hook-only Capacitor package that applies selected patch files whenever Capacitor runs sync or update.

It is built for fixes that are useful before they land in an official Capacitor release. The bundled catalog tracks external upstream Capacitor PRs mirrored by Capacitor+ sync/upstream-pr-* branches.

이 패키지는 네이티브 런타임 __CAPGO_KEEP_0을 가지고 있지 않습니다. CAPGO_KEEP_1 hook, CAPGO_KEEP_2__ 패키지 파일 및 생성된 네이티브 프로젝트 파일을 통해 작동합니다.

Capacitor 패키지들

패치 @capacitor/core, @capacitor/android, @capacitor/ios, 그리고 세 번째-party Capacitor 플러그인들 node_modules.

Capacitor CLI

CLI 자바스크립트 파일들을 패치 shipped. CLI 패치가 적용되었을 때, 다음 명령어는 패치된 CLI를 사용합니다. cap command은 패치된 code을 사용합니다.

자연스러운 프로젝트

생성된 안드로이드 또는 iOS 프로젝트 패치들을 적용합니다. cap sync 또는 cap update.

안전한 선택

버전 범위, 중복 적용 방지, 엄격 모드 등이 스테일 패치가 조용히 적용되는 것을 방지합니다.

패치 카탈로그

패치는 기본적으로 옵트인입니다. shipped 카탈로그 목록을 나열하고, 앱이 필요로 하는 패치 ID를 선택하고, 그 패치 ID를 추가하여 plugins.CapacitorPatch.patches.

각 카탈로그 항목은 다음과 같습니다:

안정적인 패치 ID
대상 패키지 또는 네이티브 프로젝트 단계
지원되는 버전 범위
Capacitor PR
Capacitor+ sync branch
패치 파일

이유

사용 @capgo/capacitor-patch 다음 경우에:

Capacitor의 업스트림 고치는 아직 배포되지 않았지만 존재할 때
앱이 고치기를 필요로 하면서 로컬 패치 스크립트 유지 관리를 원하지 않을 때
패치가 매번 Capacitor Sync/Update 후 재적용되길 원할 때
앱이 의존하는 고치기 목록이 팀-readable catalog로 필요할 때

전체 목록과 기여 가이드를 보려면 __CAPGO_KEEP_0__-patch 저장소로 이동하세요 capacitor-patch 저장소로 이동하세요.