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

한 번의 설정 체크리스트

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

규칙: __CAPGO_KEEP_0__development, production__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

  1. __CAPGO_KEEP_4____CAPGO_KEEP_5__

  2. __CAPGO_KEEP_6__ __CAPGO_KEEP_7__ __CAPGO_KEEP_8__:

    • __CAPGO_KEEP_9__ production
    • __CAPGO_KEEP_10__ development

  3. __CAPGO_KEEP_11__ 공개 모드: 켜짐, 장치 자체 설정: 꺼짐, 네이티브 모드: 업데이트 차단, 자동 업데이트 보호: 켜짐 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

    The --bundle 값 must be valid 버전 관리. 업로드하기 전에 SemVer 테스터 업로드하기 전에.

  6. 프로덕션에 배포 테스트 후에만, or __CAPGO_KEEP_0__. or CLI.

  7. 초기 권한 부여, 2FA 팀에 대해, CI에서 하나의 __CAPGO_KEEP_0__ 키. for the org, one API key in CI.

Leave __CAPGO_KEEP_0__ min_update_version, __CAPGO_KEEP_1__ 및 __CAPGO_KEEP_2__ off trừ __CAPGO_KEEP_3__이 명확한 이유가 있다면

사이즈를 선택하세요

사이즈를 선택하는 방법

간단한 방법: 1 개의 앱, 1 개의 채널: production

팀: development + production. 개발자 환경에 업로드하고 프로덕션 환경에 배포하세요.

원본 버전: 채널을 추가할 때만 필요합니다. 예를 들어, production-9.0 + test-9.0생산 채널에서 사용자들을 주 매인 스토어에 유지하세요.

많은 앱: 각 앱당 일반적인 모델 (일반적으로 하나씩) production 각 앱당 하나씩만 유지하세요. 단, 조직이 크다고 해서 추가 채널을 만들 필요는 없습니다.

릴리즈 트레인 (선택 사항): staging → rc → production주의

Bundle 이름 vs 설명

__CAPGO_KEEP_0__

Bundle 이름은 필수입니다 semantic versioning을 따르세요 . __CAPGO_KEEP_0__은 semver를 호환성 확인, 채널 자동 업데이트 규칙 및 롤백에 사용합니다. 모든 이름을 . Capgo uses semver for compatibility checks, channel auto-update rules, and rollbacks. Validate every name in the 업로드하기 전에 확인하세요. 이름

  • = semver CI에서, 예를 들어 또는 1.8.0, 1.8.0-beta.1설명 1.8.0-20260629.42
  • = 인간에게 읽을 수 있는 자유 텍스트 → protectedTokens commit abc1234 run 28059070270

세미버저를 사용하세요. 프리릴리즈 라벨 (빌드 여러 개를 동일한 버전으로 배포할 때 사용하는 부분) -예를 들어, 프리릴리즈에 날짜나 빌드 카운터를 추가하세요: MAJOR.MINOR.PATCH빌드 이름에 날짜나 빌드 카운터를 포함하지 마세요. 1.8.0 도움말 1.8.0-20260629.1, 1.8.0-beta.2도움말 fix-login-bug 도움말 2.5.2026062306도움말

도움말 --comment도움말

도움말 __CAPGO_KEEP_0__ 및 __CAPGO_KEEP_1__.

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

--delta __CAPGO_KEEP_4__ Delta 업로드 Delta 업로드

업로드 --delta 매니페스트

이러한 매니페스트
기본:
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

대부분의 앱에서 권장되는 기본 설정입니다. Capgo은 매ニ페스트를 저장합니다. 그리고 storage cost가 주요 관심사가 아닐 때는 전체 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 storage를 줄이고 싶을 때 Capgo만약 저장 공간이 비싼 경우에는 전체 zip을 저장하지 않습니다. delta/매니페스트 파일만 저장합니다. 저장 공간이 비싼 앱이나 업로드 볼륨이 높을 때 선택하세요.

서버에 zip 백업이 없으면, 매니페스트 경로에만 의존합니다. 건너뛰기 --delta-only 저장 공간 절약이 실제로 필요하지 않다면 건너뛰세요.

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

일일 워크플로우

클립보드에 복사
Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

일반적인 실수

일반적인 실수 섹션
오류수정
새로운 스토어 릴리스 전에 OTA를 기대하는 경우플러그인을 추가한 후 네이티브 앱을 다시 빌드하고 배포하는 경우
번들을 업로드하지만 채널에 배포하지 않는 경우번들을 채널에 assign( assign 예: 특정 기능, 티켓, 개발자 )하는 경우 production)
영구 릴리스 경로만 사용하는 경우동적 CI 채널 이름
고정 이름:__CAPGO_KEEP_0__ development, production
기본 앱에 너무 많은 채널이 있습니다.1-2 채널부터 시작하세요.
장치가 프로덕션 모드로 자동 설정됩니다.프로덕션 채널에서는 끄고 테스트 채널에서는 켭니다.
스키핑 --delta추가 --delta 업로드에 추가하세요; 저장 공간을 절약할 때만 사용하세요. --delta-only 비-세미버 버전 이름
세미버 버전링을 따르세요.밑에 유효성 검사하세요. semantic versioning and validate in the SemVer 테스터
버전 관리 방식 변경버전 관리 방식이 시간에 따라 변경되는 경우1.8.0-20260629.1)
버전 관리 방식은 유지하고, 추가 빌드에 대한 프리 리리즈 레이블을 사용하십시오.미디어 데이터 / 미리보기가 비정상적으로 활성화된 경우

기본적으로 비활성화

더 알아보기
Channels 기본 설정, 우선 순위 및 라우팅
델타 업데이트 델타 업데이트를 사용하는 이유와 방법
CI/CD 자동 업로드 및 배포를 자동화하세요.
패키지 체크섬, 의존성 및 메타데이터