한 번 설정한 체크리스트

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

완료되었습니다 온보딩. 이제 Capgo를 구성하세요 그것을 한 번만. 그 후 일일 작업은 업로드 → 테스트 → 배포만입니다 첫 번째 스토어 빌드를 배포하세요.

Installing the Capgo plugin in your project is not enough. OTA 업데이트는 이미 플러그인을 포함한 네이티브 앱을 실행하는 기기에서만 작동합니다.

플러그인을 추가한 후 Capgo을 호출하면 CapacitorUpdater.notifyAppReady():

실행 npx cap sync
새로운 iOS / Android 바이너리를 빌드합니다.
애플 스토어, 플레이 스토어, 테스트 플라이트, 또는 내부 배포에 제출합니다.

이전 버전의 스토어 빌드에 있는 사용자 플러그인이 없으면 the plugin will never receive live updates. Uploading bundles to Capgo only affects devices on a Capgo-enabled binary.

__CAPGO_KEEP_0__에 업로드하는 번들을 __CAPGO_KEEP_1__-활성화된 바이너리에만 영향을 미칩니다. 참고.

문제 해결 규칙: 채널은 릴리스 라인입니다.development, production), not tickets, features, 또는 개발자 이름.

한 번의 설정을 위한 체크리스트

채널 만들기: 가장 적절한 세트를 선택하세요 (아래 참조).
기본 업로드 채널 설정 설정 Solo 앱 →:
- 팀 → production
- 제작 채널: development
공개 on, 장치 자체 설정 off, 네이티브 업데이트 차단 on, 자동 업데이트 보호 on public on, device self-set off, block updates under native on, auto-update guard on major.
Test 채널 (development / staging: 보호 모드 off, 장치 자체 설정 on QA.
CI에서 업로드 with --delta (체크섬 및 네이티브 의존성은 자동입니다):
터미널 창
```
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta
```
The --bundle 값 해야 유효한 Semantic 버전. __CAPGO_KEEP_0__을 검증하세요. SemVer 테스터 업로드하기 전에.
프로덕션으로 배포 테스트를 마친 후에만, 대시보드 또는 CLI.
팀 및 보안: 한 번만 초대, 최소한의 권한, 2단계 인증 조직에 대해 2단계 인증을 활성화하고 CI에서 API 키를 하나만 사용.

파일 암호화, min_update_version데이터, 메타데이터, 미리보기 off 명확한 이유가 없다면.

사이즈를 선택하세요

간단: 1 앱, 1 채널: production

팀: development + production. 개발 버전으로 업로드, 프로덕션 버전으로 배포.

자연스러운 버전: 필요할 때만 채널을 추가하세요, 예를 들어. production-9.0 + test-9.0. 메인 프로덕션 채널에서 스토어 사용자를 유지하세요.

많은 앱: 각 앱당 동일한 간단한 모델 (일반적으로 하나씩) production 대형 조직이기 때문에 추가 채널을 만들지 마십시오.

릴리즈 트레인 (선택 사항): staging → rc → production. 모든 앱에 동일한 템플릿을 사용합니다.

번들 이름 vs 설명

번들 이름은 required __CAPGO_KEEP_0__를 따라야 합니다. semantic versioning. Capgo은 semver를 호환성 확인, 채널 자동 업데이트 규칙 및 롤백을 위해 사용합니다. CI에서 가져온 모든 이름을 SemVer 테스터 업로드하기 전에 확인합니다.

이름 = semver from CI, 예를 들어 1.8.0, 1.8.0-beta.1, or 1.8.0-20260629.42
설명 = 인간에게 자유롭게 텍스트 → commit abc1234 run 28059070270

Use semver 미리 출시 __CAPGO_KEEP_0__ (빌드) -__CAPGO_KEEP_0__ (버전)입니다. MAJOR.MINOR.PATCH여러 빌드를 동일한 1.8.0 예를 들어, 미리 출시: 1.8.0-20260629.1, 1.8.0-beta.2날짜 또는 빌드 카운터를 미리 출시에 추가하세요. fix-login-bug 유효하지 않은 semver 형식인 2.5.2026062306은 유효하지 않습니다. 올바르지 않은 semver 형식으로 업로드하면 업로드가 실패하거나 예기치 않은 동작을 하게 됩니다.

릴리즈 노트는 --comment에 넣어야 합니다.

도움말 버전 대상 and bundle 버전 관리.

델타 업로드

--delta 업로드하여 매니페스트 그래서 장치들은 매번 전체 배포 대신에 변경된 파일만 다운로드합니다. 체크섬은 항상 자동으로 계산됩니다. 체크섬 플래그를 전달하지 않습니다.

기본값: `--delta` (매니페스트 + zip 백업)

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

이것은 대부분의 앱에 대한 권장 기본값입니다. Capgo은 매니페스트를 저장합니다 및 서버에 zip 백업이 없으면 매니페스트 경로에 완전히 의존합니다. Skip

저장 공간 절약: `--delta-only`

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

사용 --delta-only 저장 공간을 줄이고 싶을 때 Capgo 저장 공간을 줄입니다.만 delta/매니페스트 파일만 저장되고, 전체 zip은 저장되지 않습니다. 큰 앱 또는 업로드 볼륨이 높을 때 저장 공간이 누적되는 경우에 선택하세요.

대안: 서버에 zip 백업이 없으면 매니페스트 경로에 완전히 의존합니다. Skip --delta-only __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_6__

Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

__CAPGO_KEEP_9__

__CAPGO_KEEP_1__	__CAPGO_KEEP_2__
__CAPGO_KEEP_3__	__CAPGO_KEEP_4__
__CAPGO_KEEP_5__	__CAPGO_KEEP_6__ `production`)
__CAPGO_KEEP_7__	__CAPGO_KEEP_8__
__CAPGO_KEEP_9__	__CAPGO_KEEP_10__ `development`, `production`
__CAPGO_KEEP_11__	1-2 채널부터 시작하세요
장치가 프로덕션 모드로 설정됩니다	테스트 채널일 때만 프로덕션 모드가 꺼져 있습니다
스키핑 `--delta`	추가 `--delta` 업로드에 추가하세요; 저장 공간을 절약할 때만 사용하세요 `--delta-only` 버전 번호가 아닌 이름
버전 번호를 따르세요	버전 번호를 확인하세요 버전 번호를 확인하는 SemVer 테스터 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__
버전 관리 방식이 시간에 따라 변경되는 경우	__CAPGO_KEEP_0__; 추가 빌드에 대해 프리 리리즈 레이블을 사용하세요.`1.8.0-20260629.1`)
미리보기가 활성화된 이유 없이	기본적으로 끄세요.

더 알아보기

채널 기본값, 우선순위 및 라우팅에 대한 설명.

델타 업데이트의 이유와 방법. --delta 옵션을 사용하는 방법.

CI/CD 자동 업로드 및 배포를 자동화하세요.

[Bundle] 체크섬, 의존성, 메타데이터.