__CAPGO_KEEP_10__

__CAPGO_KEEP_0__를 설치하는 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

__CAPGO_KEEP_0__가 완료되었습니다. 온보딩. 이제 Capgo를 구성하세요 한 번만. 그 후에는 일상적인 일만 업로드 → 테스트 → 배포.

Capgo 플러그인을 프로젝트에 설치하는 것만으로는 충분하지 않습니다. OTA 업데이트는 이미 플러그인을 포함한 네이티브 앱을 실행하는 기기에서만 작동합니다.

Capgo를 추가하고 호출한 후 CapacitorUpdater.notifyAppReady():

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

__CAPGO_KEEP_0__에서 업로드하는 번들만 __CAPGO_KEEP_1__-활성화된 기기에만 영향을 미칩니다. __CAPGO_KEEP_0__에 업로드하는 번들은 __CAPGO_KEEP_1__-활성화된 기기에만 영향을 미칩니다. the plugin will never receive live updates. Uploading bundles to Capgo only affects devices on a Capgo-enabled binary.

문제 해결 규칙:.

__CAPGO_KEEP_2__은 릴리스 라인( )이 아닌 티켓, 기능, 또는 개발자 이름입니다. 한 번만 설정하는 체크리스트development, production__CAPGO_KEEP_3__

__CAPGO_KEEP_4__를 선택하세요. 가능한 한 작은 세트를 선택하세요 (아래를 참조하십시오).

__CAPGO_KEEP_6____CAPGO_KEEP_7__
기본 업로드 채널 설정 in 앱 설정:
- Solo 앱 → production
- 팀 → development
제품 채널: 공개 설정: 기기 자체 설정 OFF, 네이티브 업데이트 차단 ON, 자동 업데이트 보호 ON major.
테스트 채널: (development / stagingCI에서 업로드
with (체크섬 및 네이티브 의존성은 자동): --delta __CAPGO_KEEP_0__
터미널 창
```
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 값 must be valid semantic versioning. 올바른지 확인하기 위해 SemVer 테스터 업로드하기 전에 확인하세요.
프로덕션에 배포하기 전에 테스트하세요. only after testing, from the 대시보드 or CLI.
팀 및 보안: 최소 권한으로 초대하십시오. 2단계 인증 CI에서 1개의 API 키만 필요합니다.

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

사이즈 선택

간단: 1 앱, 1 채널: production

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

네이티브 버전: 필요할 때만 채널 추가, 예를 들어. production-9.0 + test-9.0. 메인 프로덕션 채널에 스토어 사용자 유지.

많은 앱: 동일한 간단 모델 (일반적으로 하나씩). 조직이 크기만큼 채널 추가하지 마세요. production 릴리스 트레인

(선택사항): Capgo staging → rc → production. 모든 앱에 동일한 템플릿이 필요합니다.

번들 이름 vs 설명

번들 이름은 필수적 버전 번호 체계를 따르 버전 번호 체계를 따르 Capgo은 호환성 확인, 채널 자동 업데이트 규칙 및 롤백을 위해 semver를 사용합니다. 모든 이름을 SemVer 테스터 업로드하기 전에.

이름 = CI에서 semver를 사용하세요. 예를 들어 1.8.0, 1.8.0-beta.1, 또는 1.8.0-20260629.42
설명 = 인간이 이해할 수 있는 자유 텍스트 → commit abc1234 run 28059070270

semver 사용 이전 릴리스 레이블 (릴리스 이름 뒤에 오는 부분) - 같은 이름의 여러 빌드를 배포할 때 사용합니다. -예를 들어, MAJOR.MINOR.PATCH날짜 또는 빌드 카운터를 이전 릴리스에 추가하세요. 1.8.0 __CAPGO_KEEP_0__ 1.8.0-20260629.1, 1.8.0-beta.2.는 유효하지 않은 semver 이고 업로드는 실패하거나 예상치 못한 동작을 하게 될 것입니다. fix-login-bug 릴리즈 노트는 2.5.2026062306,에 넣어야 합니다.

도 참조하세요. --comment버전 타겟팅

및 번들 버전 관리 델타 업로드 제목이 '델타 업로드'인 섹션.

델타 업로드

--delta 업로드 manifest so devices download only changed files instead of the full bundle every time. Checksum is always computed automatically. You do not pass a checksum flag.

기본값: `--delta` (manifest + zip 백업)

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

대부분의 앱에 대해 권장되는 기본값입니다. Capgo은 manifest를 저장하고 전체 zip을 백업합니다. 저장 공간 비용이 주요 고려 사항이 아닐 때 좋습니다. 저장 공간 절약:

기본값: --delta-only `--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_KEEP_0__ 저장을 줄이려면 reduce Capgo storageTrade-off: without the zip backup on the server, you rely fully on the manifest path.

unless you actually need the storage savings. --delta-only No extra plugin config is required on the device. The updater reads the manifest and fetches changed files only.

Tip

일상 작업 흐름

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

일반적인 실수

실수	수정
OTA 업데이트 이전에 새로운 스토어 릴리즈를 기대하는 경우	원시 앱을 재구축하고 배포 후 플러그인을 추가합니다.
__CAPGO_KEEP_0__ 업로드 하지만 채널에 배포하지 않음	__CAPGO_KEEP_0__ 채널 assign (예: `production`)
__CAPGO_KEEP_0__ 기능, 티켓, 또는 개발자당 채널 하나씩	__CAPGO_KEEP_0__ 영구 릴리스 경로만 사용
__CAPGO_KEEP_0__ 동적 CI 채널 이름	__CAPGO_KEEP_0__ 고정 이름: `development`, `production`
__CAPGO_KEEP_0__ 간단한 앱에 채널이 너무 많음	__CAPGO_KEEP_0__ 1-2 채널부터 시작
__CAPGO_KEEP_0__ 프로덕션에서 디바이스 자체 설정	__CAPGO_KEEP_0__ 프로덕션에서는 off, 테스트 채널에서는 on
__CAPGO_KEEP_0__ 건너뛰기 `--delta`	__CAPGO_KEEP_0__ 추가 `--delta` 업로드를 위해 사용하세요. `--delta-only` 저장 공간을 절약할 필요가 있을 때만 사용하세요.
Non-semver 버전 이름	따라하세요. semantic versioning 버전을 확인하세요. SemVer 테스터
시간에 따라 버전 관리 방식을 변경하지 마세요.	pre-release 레이블을 사용하여 추가 빌드를 위해 (`1.8.0-20260629.1`)
미리보기가 활성화된 메타데이터/예시로 사용하지 마세요.	기본적으로 끄세요.

더 알아보기

채널 기본값, 우선순위 및 라우팅.

델타 업데이트 --delta를 사용하는 이유와 방법.

CI/CD 자동 업로드 및 배포.

번들 체크섬, 의존성 및 메타데이터.