내용으로 건너뛰기
Capgo - Live Updates for Capacitor 앱 Capgo

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

완료되었습니다 온보딩. 이제 Capgo을 구성하세요. 한 번. 그 다음, 일일 작업은 업로드 → 테스트 → 배포.

Rule: 채널은 릴리스 레인입니다.development, production)하지 말고, 티켓, 기능, 개발자 이름이 아닌 것.

설치 후 일회성 설정 체크리스트

일회성 설정 확인 목록

  1. 채널 생성: 가장 적합한 세트를 선택하세요 (아래를 참조하세요).

  2. 기본 업로드 채널 설정 in 애플리케이션 설정:

    • Solo 앱 → production
    • 팀 → development

  3. 제작 채널: 공개 모드 켜기, 장치 자체 설정 끄기, 네이티브 모드 켜기, 업데이트 차단, 자동 업데이트 보호 켜기 major.

  4. 테스트 채널 (development / staging장치 자체 설정 켜기, QA 모드 케기

  5. 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

    이것은 --bundle 값 해야 유효해야 Semantic versioningSemantic versioning을 SemVer 테스터 업로드하기 전에

  6. 테스트 후에 대시보드 dashboard or CLI.

  7. 팀 & 보안: 조직에 초대하여 최소한의 권한을 부여하십시오. 2단계 인증 CI에서 조직에 대한 단일 API 키를 사용하십시오.

파일 암호화 min_update_version, 메타데이터 및 미리보기 끄십시오. 특정 이유가 없다면

크기 선택

크기 선택

간단: 1 앱, 1 채널: production

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

자연어 버전: 필요한 경우에만 채널을 추가하세요. 예를 들어, production-9.0 + test-9.0. 메인 프로덕션 채널에 사용자들을 유지하세요.

많은 앱: 일반적으로 하나의 앱당 단순한 모델을 사용하세요. 조직이 크다고 해서 추가 채널을 만들 필요는 없습니다. production 릴리스 트레인

(선택사항): (optional): staging → rc → production주의

Bundle 이름 vs 설명

Bundle 이름은

필수입니다. 따라야 합니다. 설치 후 확인 목록 . __CAPGO_KEEP_0__은 호환성 확인, 채널 자동 업데이트 규칙 및 롤백을 위해 semver를 사용합니다. 모든 이름을Capgo은 semver를 호환성 확인, 채널 자동 업데이트 규칙 및 롤백에 사용합니다. 이름의 모든 항목을 확인하세요. 업로드하기 전에 확인하십시오. 이름

  • bundle = CI에서 semver 1.8.0, 1.8.0-beta.1, or 1.8.0-20260629.42
  • Comment Capgo commit abc1234 run 28059070270

semver pre-release 라벨 (이름 뒤에 있는 부분) -) 여러 빌드가 동일한 버전일 때 MAJOR.MINOR.PATCH예를 들어, Capgo의 Live Update 기능을 사용하여 앱을 최신 버전으로 유지하세요. 1.8.0 and add the date or build counter in the pre-release: 1.8.0-20260629.1, 1.8.0-beta.2Capgo를 사용한 설정 확인 목록 fix-login-bug or 2.5.2026062306They are not valid semver and uploads will fail or behave unpredictably.

릴리스 노트를 넣어야 합니다. --comment, 이름에 넣지 마십시오.

참고 버전 목표 그리고 번들 버전 관리.

델타 업로드

델타 업로드

--delta 업로드 델타 파일 이러한 방식으로 장치들은 변경된 파일만 다운로드 하기 때문에 매번 전체 번들을 다운로드하지 않습니다. 체크섬은 항상 자동으로 계산됩니다. 체크섬 플래그를 전달하지 마십시오.

기본 설정: --delta (델타 파일 + zip 백업)

기본 설정: --델타 (델타 파일 + zip 백업)
터미널 창
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

대부분의 앱에 대해 권장되는 기본 설정입니다. Capgo은 델타 파일을 저장하고 그리고 zip을 백업합니다. 구 버전의 플러그인으로 델타 지원이 없는 기기에서는 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이 저장되지 않습니다. 대형 앱 또는 업로드 볼륨이 높아 storage가 쌓일 때 선택하세요.

대용량 앱 또는 업로드 볼륨이 높아 storage가 쌓일 때 선택하세요. --delta-only storage 절약이 필요하지 않다면.

storage 절약이 필요하지 않으면 Skip

일상 작업

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

일반적인 오류

일반적인 오류
오류수정
새로운 스토어 릴리스 전에 OTA를 기대하는 경우플러그인을 추가한 후 네이티브 앱을 다시 빌드하고 배포하는 경우
번들을 업로드하지만 채널에 배포하지 않는 경우번들을 채널에 Assign(예: production)
기능, 티켓, 또는 개발자별 채널영구 릴리스 경로만 사용하세요
동적 CI 채널 이름고정 이름: development, production
단순 앱에 너무 많은 채널1-2 채널부터 시작하세요
장치 자체가 프로덕션에 설정되어 있습니다프로덕션에서 끄고 테스트 채널에서 켜세요
스키핑 --delta추가 --delta 업로드에 사용하세요; 저장 공간을 절약할 때만 사용하세요 --delta-only 저장 공간을 절약할 때만 사용하세요
버전 번호가 아닌 패키지 이름따라하십시오 세미버전을 따르며, 세미버 버전 검증기에서 세미버 버전 검증기
시간에 따라 버전 번호 체계를 변경하는 것세미버 버전을 유지하십시오; 추가 빌드에 대해 프리 릴리즈 레이블을 사용하십시오 (1.8.0-20260629.1)
메타데이터 / 미리보기가 비정상적으로 활성화된 경우기본적으로 비활성화되어야 합니다

더 알아보기

제목이 "더 알아보기"인 섹션
채널 기본값, 우선순위 및 라우팅.
델타 업데이트 델타 업데이트를 사용하는 이유와 방법
CI/CD 자동 업로드 및 배포
번들 체크섬, 의존성 및 메타데이터