한 번의 설정 체크리스트

설치

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

규칙: 채널은 릴리스 라인 (development, production), 티켓, 기능, 또는 개발자 이름이 아닙니다.

한 번의 설정 체크리스트

채널 만들기: 가장 적합한 세트를 선택하세요 (아래 참조).
기본 업로드 채널 설정 in 앱 설정:
- Solo 앱 → production
- 팀 → development
프로덕션 채널: 공개 모드 켜기, 장치 자체 설정 끄기, 네이티브 모드 켜기 하위 업데이트 차단, 자동 업데이트 보호기 켜기 major.
테스트 채널 (development / staging): 공개 모드 끄기, 장치 자체 설정 켜기 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 값 must be valid 버전 관리. 업로드하기 전에 SemVer 테스터 업로드하기 전에 확인하세요.
테스트 후에만 프로덕션으로 배포하세요. 또는 __CAPGO_KEEP_0__. or CLI.
팀 초대하기, 최소 권한 부여, 2FA 팀에 대해 2FA를 활성화하고 CI에서 하나의 __CAPGO_KEEP_0__ 키만 사용하세요. for the org, one API key in CI.

암호화 min_update_version, 메타데이터 및 미리보기 끄기 명확한 이유가 없으면

사이즈 선택

간단: 1 앱, 1 채널: production

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

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

많은 앱: 앱당 하나의 단순한 모델 (일반적으로 하나씩) production 각 앱당 하나씩). 큰 조직이기 때문에 채널을 추가로 생성하지 마세요.

릴리즈 트레인 (선택사항): staging → rc → production. 모든 앱에 필요할 때마다 동일한 템플릿을 사용하세요.

Bundle 이름 vs 댓글

__CAPGO_KEEP_0__ 버전 번호를 따르는 이름은 필수입니다. 버전 번호를 따르는 규칙을 따라야 합니다.. Capgo uses semver for compatibility checks, channel auto-update rules, and rollbacks. Validate every name in the __CAPGO_KEEP_0__은 호환성 확인, 채널 자동 업데이트 규칙 및 롤백을 위해 semver를 사용합니다. 버전 번호를 따르는 규칙을 따르는 이름을 모두 확인하세요.

버전 번호를 따르는 규칙을 따르는 이름 = CI에서 semver를 사용합니다. 예를 들어, 1.8.0, 1.8.0-beta.1또는 1.8.0-20260629.42
설명 = 사람들에게 보이는 자유 텍스트 → commit abc1234 run 28059070270

Use semver pre-release labels (the part after -) when you ship many builds under the same MAJOR.MINOR.PATCH. For example, keep 1.8.0 and add the date or build counter in the pre-release: 1.8.0-20260629.1, 1.8.0-beta.2. Do not invent custom formats like fix-login-bug or 2.5.2026062306See also

Use semver --commentpre-release

labels (the part after ) when you ship many builds under the same . For example, keep and add the date or build counter in the pre-release: . Do not invent custom formats like or . They are not valid semver and uploads will fail or behave unpredictably. 버전 목표 그리고 번들 버전 관리.

델타 업로드

--delta 업로드한다 매니페스트 이러한 매니페스트

이러한 매니페스트를 통해 `--delta` 기본 설정:

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

대부분의 앱에서 권장되는 기본 설정입니다. Capgo은 매니페스트를 저장합니다 그리고 스토리지 비용이 주요 관심사가 아니면 좋은 선택입니다.

저장 공간 절약: `--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 백업이 없으면, 매니페스트 경로에만 의존합니다. 건너뛰기 --delta-only 실제로 저장 공간 절약이 필요하지 않다면 건너뛰세요.

장치에 추가 플러그인 설정이 필요하지 않습니다. 업데이터는 매니페스트를 읽고 변경된 파일만 다운로드합니다.

일일 워크플로우

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

일반적인 실수

오류	수정
새로운 스토어 릴리스 전에 OTA를 기대하는 것	플러그인을 추가한 후 네이티브 앱을 다시 빌드하고 배포하는 것
채널에 업로드 한 배ंडल이 배포되지 않은 경우	채널 assignment (예: 기능, 티켓, 개발자별) `production`)
영구 릴리스 경로만 사용	동적 CI 채널 이름
고정 이름:	__CAPGO_KEEP_0__ `development`, `production`
단순 앱에 너무 많은 채널	1-2 채널부터 시작하세요
장치 자체가 프로덕션 모드로 설정되어 있습니다	프로덕션 모드에서는 끄고 테스트 채널에서는 켜세요
스키핑 `--delta`	추가 `--delta` 업로드에 추가하세요; 저장 공간을 절약할 때만 사용하세요 `--delta-only` 비-세미버저 버전 이름
세미버저 버전링을 따르세요	및 유효성 검사 validating SemVer 테스터
버전 관리 방식 변경	추가 빌드에 대한 프리 리리즈 레이블 사용`1.8.0-20260629.1`)
미리 보기 활성화	기본적으로 비활성화

더 알아보기

기본 설정, 우선 순위 및 라우팅 델타 업데이트

델타 업데이트의 사용 방법 CI/CD

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

패키지 체크섬, 의존성 및 메타데이터

한 번의 설정 체크리스트