본문 바로가기

@capgo/capacitor-patch

동기화 및 업데이트 훅 시점에 검증된 수정 사항을 Capacitor 코어 패키지, CLI, 플러그인 및 네이티브 프로젝트에 적용합니다.

@capgo/capacitor-patch 는 Capacitor 실행 시 선택된 패치 파일을 적용하는 훅 전용 Capacitor 패키지입니다 sync 또는 update.

공식 Capacitor 릴리스 전에 유용한 수정 사항을 위해 만들어졌습니다. 번들된 카탈로그는 Capacitor+가 미러링한 외부 업스트림 Capacitor PR을 추적합니다 sync/upstream-pr-* 브랜치입니다.

플랫폼지원참고 사항
iOSHookcap sync patches
AndroidHookcap sync patches
웹해당 없음CLI 전용

Capacitor 패키지

패치 @capacitor/core, @capacitor/android, @capacitor/ios, 및 Capacitor 플러그인 하위의 서드파티 node_modules.

Capacitor CLI

배포된 CLI JavaScript 파일을 패치합니다. CLI 패치가 적용되면 다음 cap 명령이 패치된 code을 사용합니다.

네이티브 프로젝트

다음 이후 생성된 Android 또는 iOS 프로젝트 패치 적용 cap sync 또는 cap update.

안전한 선택

버전 범위, 멱등성 검사, 엄격 모드가 구식 패치가 조용히 적용되는 것을 방지합니다.

패치는 기본적으로 옵트인입니다. 제공되는 카탈로그를 확인하고 앱에 필요한 패치 ID를 선택한 후 다음에 추가하세요. plugins.CapacitorPatch.patches.

각 카탈로그 항목에는 다음이 포함됩니다:

  • 안정적인 패치 ID
  • 대상 패키지 또는 네이티브 프로젝트 단계
  • 지원되는 버전 범위
  • 상위 Capacitor PR
  • 해당하는 Capacitor+ 동기화 브랜치
  • 패키지와 함께 배포되는 패치 파일

사용 @capgo/capacitor-patch when:

  • Capacitor 수정이 업스트림에 존재하지만 아직 릴리스되지 않았습니다
  • 로컬 패치 스크립트를 관리하지 않고도 앱에 수정 사항을 적용해야 하는 경우
  • Capacitor 동기화/업데이트 후에도 패치가 다시 적용되기를 원합니다
  • 앱이 의존하는 수정 사항에 대한 팀이 읽을 수 있는 카탈로그가 필요합니다

전체 카탈로그 및 기여 가이드는 다음을 참고하세요 capacitor-patch 저장소.

@capgo/capacitor-patch에서 계속 진행

“@capgo/capacitor-patch”에서 계속하기

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