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

설치

완료했습니다 온보딩. 이제 Capgo를 구성하세요 한 번. 그 후, 일일 작업은 단지 업로드 → 테스트 → 배포.

문제 해결 규칙:development, production채널은 릴리스 라인(

한 번의 설정 체크리스트

채널 생성: 최소한의 세트를 선택하세요 (아래 참조).
기본 업로드 채널 설정 in 앱 설정:
- Solo 앱 → production
- 팀 → development
생산 채널: 공개 on, 장치 자체 설정 off, 네이티브 업데이트 차단 on, 자동 업데이트 보호기 on 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 유효해야 합니다 Semantic 버전입니다. 유효성을 검사하세요.그것 SemVer 테스터 업로드하기 전에
프로덕션으로 배포 테스트 후에만, 대시보드 또는 CLI.
팀 & 보안: 팀 초대, 최소 권한, 2FA CI에서 1개의 API 키

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

사이즈를 선택하세요

간단: 1 앱, 1 채널: production

팀: development + productioncontext: Capgo 마케팅 웹사이트. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 페이지 sla.astro에서 볼 수 있음. 메시지 키 `team_plan` (팀 플랜)

업로드는 개발 환경에서, 배포는 운영 환경에서자연어 버전 production-9.0 + test-9.0: 채널을 추가할 때만 필요합니다. 예를 들어

애플리케이션모든 앱당 동일한 간단한 모델 (일반적으로 하나씩) production 대형 조직이기 때문에 채널을 여러 개만들지 마세요.

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

Bundle 이름 vs 설명

Bundle 이름은 필수 다음 항목을 따르십시오. 의미 버전 관리. Capgo은 호환성 확인, 채널 자동 업데이트 규칙 및 롤백을 위해 semver를 사용합니다. CI에서 이름을 검증하는 데 사용됩니다. SemVer 테스터 업로드하기 전에 이름을 검증하십시오.

이름 = CI에서 semver를 사용합니다. 1.8.0, 1.8.0-beta.1, 또는 1.8.0-20260629.42
설명 = 인간에게 읽을 수 있는 텍스트 → commit abc1234 run 28059070270

semver 사용 pre-release 버전 라벨 (빌드 이름 뒤에) -많은 빌드를 동일한 MAJOR.MINOR.PATCH예를 들어, 빌드 날짜 또는 빌드 카운터를 프리 리리즈에 추가하세요: 1.8.0 빌드 이름에 날짜나 빌드 카운터를 추가하지 마세요. 1.8.0-20260629.1, 1.8.0-beta.2예를 들어, 프리 리리즈 이름에 날짜나 빌드 카운터를 추가하세요. fix-login-bug or 2.5.2026062306예를 들어, 프리 리리즈 이름에 날짜나 빌드 카운터를 추가하세요.

예를 들어, 프리 리리즈 이름에 날짜나 빌드 카운터를 추가하세요. --comment예를 들어, 프리 리리즈 이름에 날짜나 빌드 카운터를 추가하세요.

델타 업로드

--delta 업로드 델타 파일 이러한 방법으로 장치가 매번 전체 버전을 다운로드하는 대신에 변경된 파일만 다운로드합니다. 체크섬은 항상 자동으로 계산됩니다. 체크섬 플래그를 전달하지 않습니다.

기본값: `--delta` (델타 파일 + zip 백업)

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

대부분의 앱에서 권장되는 기본값입니다. Capgo은 델타 파일을 저장합니다. 및 전체 zip을 백업으로 유지합니다. Delta 지원이 없는 구버전 플러그인으로 설치된 기기는 zip을 사용합니다. 저장 비용이 주요 관심사가 아니면 좋습니다.

저장 공간 절약: `--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 파일에 완전히 의존하고 구버전 플러그인으로 설치된 기기에서 Delta 지원이 없는 경우 업데이트를 할 수 없습니다. 건너뛰기

저장 공간 절약을 실제로 필요로 하는 경우에만 건너뛰세요. --delta-only storage 절약이 필요하지 않다면.

장치에 추가 플러그인 설정이 필요하지 않습니다. 업데이터는 델타 파일 목록을 읽고 변경된 파일만 다운로드합니다.

일일 작업 흐름

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

총세요 총세요

오류	수정
OTA 업데이트가 새로운 스토어 릴리스 전에 발생하는 경우	플러그인을 추가한 후 네이티브 앱을 재빌드하고 배포하는 경우
채널에 배포하지 않고 버ंडल을 업로드하는 경우	예를 들어, 기능, 티켓, 또는 개발자별로 채널을 할당하는 경우 `production`)
영구 릴리스 경로만 사용하는 경우	동적 CI 채널 이름
고정 이름:	단순한 앱에 채널이 너무 많을 경우 `development`, `production`
1-2개의 채널부터 시작하는 경우	context
제어 장치가 생산 모드에 자동 설정됩니다.	생산 모드에서 끕니다. 테스트 채널에서 켭니다.
스킵 `--delta`	추가 `--delta` 장치 자체가 생산 모드에 자동 설정됩니다. `--delta-only` 생산 모드에서 끕니다. 테스트 채널에서 켭니다.
스킵	업로드에 사용하세요. 저장 공간을 절약할 때만 사용하세요. 버전이 아닌 이름 따라하세요.
버전을 확인하세요. 버전 확인기에서 확인하세요. 버전 확인기 (SemVer tester).	버전 관리; 추가 빌드에 대한 프리 리리즈 레이블 사용`1.8.0-20260629.1`)
미디어 데이터 / 미리보기 사용	기본적으로 비활성화