본문 바로가기
@capgo/capacitor-patch 업데이트 오픈 소스

Capacitor 패치 Capacitor 플러그인

cap sync 및 update 시 버전에 따라 Capacitor 코어, CLI, 플러그인, 네이티브 프로젝트 패치 적용

설치

bun add @capgo/capacitor-patch bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-patch
  • pnpm add @capgo/capacitor-patch
  • yarn add @capgo/capacitor-patch

가이드

Capacitor에서 Capacitor 패치를 사용하는 방법

@capgo/capacitor-patch 사용하기

버전 제한이 있는 패치 카탈로그에서 선택된 Capacitor 수정 사항을 적용하는 동안 cap sync 및 cap update.

설치

npm install @capgo/capacitor-patch
npx cap sync

사용 가능한 패치 목록

npx capgo-capacitor-patch list --all

카탈로그에는 패치 ID, 대상 패키지, 지원되는 Capacitor 버전, 업스트림 Capacitor PR 링크가 포함됩니다.

Capacitor 설정에서 패치 선택

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;

Dry-run 및 동기화

npx capgo-capacitor-patch doctor --phase package --strict
npx cap sync

패키지 패치가 먼저 실행됩니다 sync 및 update. 네이티브 프로젝트 패치가 나중에 실행됩니다 sync 및 update.

설정

  • patches - 적용할 패치 ID를 명시
  • recommended - Capgo에서 권장으로 표시한 패치 적용.
  • disabled - 선택한 패치 ID 건너뛰기.
  • strict - 선택한 패치가 호환되지 않거나 적용할 수 없는 경우 실패합니다.

전체 레퍼런스

@capgo/capacitor-patch 사용법에서 계속하기

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

자주 묻는 질문

Capacitor Patch 플러그인 FAQ

Capacitor 앱에 Capacitor Patch 플러그인을 어떻게 설치하나요?

"bun add @capgo/capacitor-patch"(또는 "npm install @capgo/capacitor-patch")를 실행한 다음 "bunx cap sync"를 실행해 iOS와 Android 프로젝트에 네이티브 code가 반영되도록 하세요. 그런 다음 앱 code에서 "@capgo/capacitor-patch"로 import 하세요.

@capgo/capacitor-patch는 React, Vue, Angular와 함께 사용할 수 있나요?

네. Capacitor Patch는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte, 일반 JavaScript를 포함해 Capacitor에서 실행되는 모든 웹 프레임워크에서 동작합니다.

@capgo/capacitor-patch은 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-patch은 무료 오픈 소스인가요?

네. code 소스는 GitHub의 https://github.com/Cap-go/capacitor-patch/에 공개되어 있고, 패키지는 npm에서 무료로 설치할 수 있습니다. 버그 리포트와 풀 리퀘스트를 환영합니다.

Capacitor Patch를 사용하는 code를 App Store 심사 없이 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 리뷰 대기 없이 Capacitor Patch 변경 사항 배포

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기