시작하기

설치

Capgo AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요:

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

컨텍스트: Capgo 마케팅 웹사이트. 역할: UI 레이블. 표시되는 곳: 페이지 에이전트/[슬러그].astro. 메시지 키 `agents_page_copy_label` (에이전트 페이지 복사 레이블).

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-patch` plugin in my project.

그런 다음 다음 프롬프트를 사용하세요:

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설치된 패키지 버전과 일치하는지 확인하려면: sync 및 update.

터미널 창

Use doctor 수동으로 적용하기 전에 확인해 보세요.

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

Use apply 수동으로 적용하기 전에 확인해 보세요.

npx capgo-capacitor-patch apply --phase package

설정 옵션

옵션	타입	기본	설명
recommended	boolean	false	권장된 Capgo 패치 표시
patches	string[]	[]	explicit 패치 ID 적용
disabled	string[]	[]	권장된 패치 ID를 무시
strict	boolean	false	선택한 패치 ID가 불일치하거나 적용할 수 없을 때 예외 발생

Tip

프로덕션 앱에서 명시적으로 사용하세요. patches 이러한 수정 사항은 code 리뷰에서 확인할 수 있습니다.

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 선택한 패치 실패를 오류로 처리합니다.

워크플로우

1. 설치 @capgo/capacitor-patch.
2. 실행 npx capgo-capacitor-patch list --all.
3. 선택한 패치 ID를 추가하여 plugins.CapacitorPatch.patches.
4. 실행 npx capgo-capacitor-patch doctor --strict.
5. 실행 npx cap sync.

선택한 패치가 설치된 __CAPGO_KEEP_0__ 패키지와 다음 @capacitor/cli명령어는 패치된 CLI __CAPGO_KEEP_1__를 사용합니다. cap command은 patched CLI code을 사용합니다.

시작부터 계속

Capacitor Patch를 사용 중이라면 Getting Started 자연 플러그인 작업을 계획하려면 Capacitor Patch를 사용하여 @capgo/capacitor-patch와 연결하세요 Capacitor Patch를 사용하여 @capgo/capacitor-patch의 자연 기능을 사용하세요 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우를 사용하세요 Capacitor Capgo 플러그인 Capacitor 플러그인에서 Capgo 구현 세부 정보를 사용하세요 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트하는 구현 세부 정보를 사용하세요 Ionic Enterprise 플러그인 대체품 아이오닉 엔터프라이즈 플러그인 대체품의 제품 워크플로우에 대해.