채널

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 지시를 복사할 수 있습니다.

Live Update 채널은 특정 JS 번들 빌드에 대한 링크를 제공하며, 이 채널을 듣기 위해 구성된 모든 장치에 업데이트를 공유합니다. Live Updates __CAPGO_KEEP_1__를 __CAPGO_KEEP_0__에 설치하면, 채널에 구성된 모든 네이티브 바이너리는 앱이 시작될 때 업데이트가 있는지 확인합니다. 채널이 가리키는 빌드를 언제든지 변경할 수 있고 이전 빌드로 롤백할 수도 있습니다. install the Capgo Live Updates SDK __CAPGO_KEEP_0__

장치가 채널을 선택하는 방법 (순위)

When a device checks for an update, Capgo decides which channel to use in this strict order (highest priority first):

– 특정 장치 ID를 채널에 매핑하여 강제합니다. 긴급한 디버깅이나 단일 실제 사용자와 제어된 테스트에 사용합니다. 항상 승리합니다. __CAPGO_KEEP_0__은 마지막 override 쓰기 후 90일 후에 매핑을 제거합니다. 자세한 내용은 콘솔 및 Capgo override가 90일 후에 만료됩니다 Cloud override (장치별) 대시보드 또는 API.
– 대시보드 또는 API에서 장치의 채널을 변경할 때 생성됩니다. QA 사용자 간의 기능/PR 채널 또는 사용자 문제를 재현할 때 사용합니다. 바이너리 재설치로 제거되지 않습니다. 장치 override를 삭제하면 제거됩니다. 동일한 90일 보존 정책이 적용됩니다. – Created when you change the device’s channel in the dashboard or via API. Use for QA users switching between feature / PR channels or to reproduce a user issue. Reinstalling the binary does not clear it; deleting the device override does. The same 90-day retention applies.
플러그인 setChannel() 지역 채널 – 앱이 호출할 때 생성되며 setChannel() 백엔드가 대상 채널이 자체 할당을 허용하는지 확인하여 채널을 선택합니다. 선택한 채널은 해당 장치에 저장되어 즉시 적용되고 디바이스 오버라이드 UI에 표시되지 않습니다.

플러그인 버전 5.34.0, 6.34.0, 7.34.0, 또는 8.0.0부터 (당신의 메이저 버전에 따라) setChannel() 다르게 작동합니다: 백엔드에 접속하여 채널이 허용되는지 확인합니다. 자체 할당이 해당 채널에 대해 허용되는지 확인합니다. 그런 다음 장치에 채널을 저장합니다. Live Updates defaultChannelChannel Channel Channel

Channel setChannel() saved the channel override to the backend database (like Dashboard or API changes), and devices had to wait for data replication (up to 2 minutes) before the new channel was recognized. The new behavior only reads from the backend (for validation) and stores locally, making channel switches instant.

Channel setChannel() Channel Channel create a Device Override entry in the Capgo dashboard. The Device Override UI only shows overrides created from the dashboard or the Public API.

Channel Channel

중요: 대시보드 또는 API를 통해 채널 변경이 이루어질 때도, 모든 에지 서버가 변경을 반영하기까지 최대 2분의 복제 지연이 발생합니다. 즉시 채널 전환을 원한다면 setChannel() code에서 앱을 시작하세요. 이 방법은 백엔드와 유효성을 검사한 후, 즉시 효과를 내는 채널을 로컬로 설정합니다.

Capacitor 구성 defaultChannel (테스트 빌드 기본값) __CAPGO_KEEP_0__ 구성이 존재하고 강제/override/local 채널이 없다면, 앱은 이 채널에서 시작합니다. (예: capacitor.config.* 테스트 플라이트 / 내부 빌드에 사용하여 테스터가 자동으로 프리 리리즈 채널에 접속되도록 하기 위해 사용됩니다. 일반적인 프로덕션 빌드는 이 설정을 비워둡니다. beta, qa, pr-123클라우드 기본 채널 (99%의 사용자들이 사용하는 기본 경로)
__CAPGO_KEEP_0__를 통해 대시보드에서 기본 채널을 설정하면, 모든 일반 사용자(강제, 대시보드/ __CAPGO_KEEP_0__ override, 플러그인 로컬 채널, 구성 기본 채널이 없는 사용자)는 이 채널에 연결됩니다. 이 채널을 변경하여 즉시 배포하거나 롤백할 수 있습니다. 새로운 바이너리가 필요하지 않습니다. 플랫폼별 기본값을 설정할 경우(예: iOS 전용, Android 전용, Electron 전용), 각 기기는 해당 플랫폼에 맞는 기본값으로 연결됩니다. 클라우드 기본 채널을 비워두는 것은 허용되며, 이 경우 기기는 1-4 단계를 통해 업데이트를 받습니다. – If you mark a default channel in the dashboard, all normal end‑users (no force, no Dashboard/API override, no plugin local channel, no config defaultChannel) attach here. Change it to roll out or roll back instantly—no new binary. If you have platform-specific defaults (for example, one iOS-only, one Android-only, one Electron-only), each device lands on the default matching its platform. Leaving the cloud default unset is allowed; in that case the device must match on steps 1–4 to receive updates.

1-4 단계를 예외/테스트層으로 간주하세요. 클라우드 기본 채널을 설정하면 실제 사용자는 이 채널에 흐릅니다. 클라우드 기본 채널을 설정하지 않으면, 사용자가 어떻게 연결되는지에 대해 명확하게 생각하세요. (일반적으로

__CAPGO_KEEP_0__를 통해 대시보드에서 기본 채널을 설정하면, 모든 일반 사용자(강제, 대시보드/ __CAPGO_KEEP_0__ override, 플러그인 로컬 채널, 구성 기본 채널이 없는 사용자)는 이 채널에 연결됩니다. 이 채널을 변경하여 즉시 배포하거나 롤백할 수 있습니다. 새로운 바이너리가 필요하지 않습니다. 플랫폼별 기본값을 설정할 경우(예: iOS 전용, Android 전용, Electron 전용), 각 기기는 해당 플랫폼에 맞는 기본값으로 연결됩니다. 클라우드 기본 채널을 비워두는 것은 허용되며, 이 경우 기기는 1-4 단계를 통해 업데이트를 받습니다. defaultChannel 설정 또는 장치별 오버라이드에서 사용할 수 있습니다.
테스터에게만 배포하는 바이너리에서만 구성하십시오. defaultChannel 생산 로직을 중앙 집중식으로 유지하기 위해, 설정하지 않으면 유지됩니다.
생산에서 적극적으로 사용하지 마십시오. QA 또는 특정한 디버깅 목적으로만 사용하십시오. setChannel() 플랫폼(iOS/Android/Electron)에서 채널이 비활성화되어 선택되지 않으면, 목록에서 다음으로 넘어갑니다.

요약: 강제 > __CAPGO_KEEP_0__ 대시보드 오버라이드 > 플러그인

장치별로 API 채널을 로컬로 설정 > 설정 setChannel() > Cloud 기본값. defaultChannel 콘솔 및 __CAPGO_KEEP_0__ 오버라이드가 90일 후에 만료됩니다.

콘솔 및 API 오버라이드가 90일 후에 만료됩니다.

Forced mappings and Dashboard or Public API channel overrides are stored as per-device assignments in Capgo. A cleanup job deletes those assignments. 90일 동안 마지막 override 쓰기 후업데이트 확인 중에는 그 시계를 다시 시작하지 않습니다. 오버라이드 다시 쓰기(또는 삭제)만 timestamp를 변경합니다.

이것은 장치 인벤토리 보존. Inventory removes devices that have not connected to Capgo for 90 days. Override cleanup removes the mapping even if the device is still active.

이 할당이 이 청소로 제거되지 않는 경우:

설정 defaultChannel 에서 capacitor.config.* 설정
호출 setChannel() 앱에서. 플러그인 5.34.0 / 6.34.0 / 7.34.0 / 8.0.0 이상에서, 그 할당은 지역적이고 이 청소로 제거되지 않습니다. 앱을 다시 설치하면 제거되므로, 앱은 다시 setChannel() 호출해야 합니다. 만약 그 채널을 여전히 원한다면.

__CAPGO_KEEP_0__ 채널 __CAPGO_KEEP_0__ 기기 API tab과 기기 Override UI만 목록에 표시하며, 콘솔 및 Public API assignments만 표시합니다. 이들은 채널에 있는 모든 기기를 목록에 표시하지 않으며, 로컬 기기를 목록에 표시하지도 않습니다. setChannel() __CAPGO_KEEP_0__ assignments.

Capgo 채널 기기 tab에 보이는 Override 보존 팝오버: 콘솔 오버라이드는 90일 후에 만료됩니다. — __CAPGO_KEEP_0__ 채널 기기 tab에 표시되는 오버라이드 보존 알림.

기본 채널 동작

클라우드 기본값을 설정하는 것은 선택사항이지만, 새로운 기기에 대한 기본 경로로 사용됩니다. 기본값이 없으면, 강제 매핑, 오버라이드 또는 __CAPGO_KEEP_0__ config에 있는 기기만 업데이트를 받습니다. 기본값을 설정할 때는 다음 패턴을 기억하세요: defaultChannel in the Capacitor config will receive updates. When you do choose to mark defaults, keep these patterns in mind:

– 채널이 iOS, Android, Electron이 모두 활성화된 경우, 단일 기본값이 됩니다. 오버라이드가 없는 기기는 이 기본값에 연결됩니다. __CAPGO_KEEP_0__ 기기
플랫폼별 기본값 – 플랫폼별 채널을 나누면 (예를 들어, iOS만 활성화, Android만 활성화, Electron만 활성화), 각 플랫폼의 기본값으로 표시합니다. iOS 기기는 iOS 기본값으로, Android 기기는 Android 기본값으로, Electron 앱은 Electron 기본값으로 이동합니다. ios-production cloud 기본값과 android-production both electron-production 같은 결정层을 차지합니다. cloud 기본값을 설정하면 __CAPGO_KEEP_0__ 구성에서 값을 중복해서 입력할 필요가 없습니다—생산 빌드에서는 빈칸으로 남겨두세요. 테스터나 QA에게 배포할 때 비정상 채널을 시작하도록 하려면

빈칸을 예약하세요. defaultChannel 대시보드에서 언제든지 기본값을 변경할 수 있습니다. 채널을 열고 capacitor.config.* both occupy the same decision layer. If you set a cloud default, you don’t need to duplicate the value in your Capacitor config—leave defaultChannel Manage in App settings defaultChannel Manage

App settings Appwhich takes you to 앱 정보. 기본 설정은 더 이상 채널 페이지의 토글이 아닙니다. 기본 설정을 교체하면 새로운 장치들은 즉시 새로운 라우팅을 따르며 기존 장치는 다음에 체크인할 때 정상적인 우선순위 규칙을 따릅니다.

채널 설정

온보딩 중에 첫 번째 채널을 생성합니다(대부분의 팀은 '생산'이라고 이름을 지어줍니다). 그러나 아무것도 잠금 해제되지 않습니다. 채널 이름을 변경하거나 삭제할 수 있습니다. 추가 채널을 설정하려면:

Capgo 대시보드의 '채널' 섹션으로 이동하세요
새 채널 버튼을 클릭하세요
채널 이름을 입력하고 '생성' 버튼을 클릭하세요

채널 이름은 마음대로 지어줄 수 있습니다. 일반적인 전략은 개발 단계와 채널 이름을 일치시키는 것입니다. 예를 들어:

Development - 로컬 장치나 에뮬레이터에서 라이브 업데이트를 테스트하는 데 사용
QA - QA 팀이 더 넓은 릴리스 전에 업데이트를 확인하는 데 사용
Staging - 프로덕션 환경과 유사한 환경에서 최종 테스트를 위해
Production - 사용자가 앱 스토어에서 받는 앱의 버전을 위해

앱에서 채널을 구성하는 방법

채널이 생성되면, 앱을 구성하여 해당 채널을 듣도록 해야 합니다. 이 예에서는 채널을 사용합니다. Development 채널을 구성하기 위해,

(또는 capacitor.config.ts ) 파일을 열어, capacitor.config.json부분에서, optionally plugins 채널을 defaultChannel 테스트 빌드 을 위해 생산 빌드의 경우 Cloud Default를 사용하도록 하며, Cloud Default를 명시적으로 재정의하지 않는 한 장치가 Cloud Default를 사용하도록 하십시오.

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      // For a QA/TestFlight build – testers start on the Development channel automatically.
      defaultChannel: 'Development',
      // Production builds usually omit this so users attach to the Cloud Default channel.
    },
  },
};

다음으로 웹 앱을 빌드하고 npx cap sync 업데이트된 config 파일을 iOS, Android, Electron 프로젝트에 복사하세요. 이 동기화 단계를 생략하면 이전에 구성된 채널을 계속 사용하는 native 프로젝트가 계속 사용됩니다.

채널 옵션 및 전략

채널은 업데이트를 받을 수 있는 사람과 업데이트를 전달하는 방법을 제어하는 여러 옵션을 가지고 있습니다. 가장 중요한 것은 아래에 나열되어 있습니다. 이 옵션은 웹 앱, CLI, 또는 Public API에서 구성할 수 있습니다.

기본 채널: 새로운 장치가 연결될 때 채널 또는 플랫폼에 특정한 채널을 선택할 수 있습니다. 콘솔에서 이 옵션은 App Information(앱 설정에서 관리 채널 페이지에서 확인할 수 있습니다. 기본 채널 동작
채널 라우팅 시나리오를 참조하십시오. iOS, Android플랫폼 필터: __CAPGO_KEEP_0__ 또는 __CAPGO_KEEP_1__ Electron 채널에 대한 장치 수
자동 다운그레이드 비활성화: 장치의 네이티브 앱 버전이 채널의 배포본 버전보다 새로운 경우 업데이트를 보내지 않습니다. (예: 장치 버전 1.2.3, 채널 버전 1.2.2)
개발자 빌드 허용: 개발자 빌드를 업데이트할 수 있습니다. (테스트에 유용합니다.) CLI: --dev / --no-dev.
생산 빌드 허용: 프로덕션 (스토어) 빌드에 업데이트를 허용합니다. 실제 사용자에게 서비스를 제공하는 채널의 경우 이 옵션을 유지하세요. CLI: --prod / --no-prod.
에뮬레이터 장치 허용: 에뮬레이터/시뮬레이터 (테스트에 유용)에 업데이트를 허용합니다. CLI: --emulator / --no-emulator.
물리 장치 허용: 실제 스마트폰 및 태블릿에 업데이트를 허용합니다. 프로덕션 채널의 경우 이 옵션을 유지하세요. CLI: --device / --no-device.
장치 자체 할당 허용: 앱이 런타임에 이 채널로switch할 수 있도록합니다. 비활성화된 경우, __CAPGO_KEEP_0__: setChannelwill fail for this channel. setChannel 업데이트 패키지: 장치가 전체 zip, 변경된 파일의 델타, 또는 둘 다 다운로드할지 선택합니다. (CLI)를 참조하세요. See CLI for the console dropdown and when each mode is useful. --self-assign / --no-self-assign.
Progressive rolloutsall, zip, delta, zip_from_builtin, delta_from_builtinProgressive rollouts Progressive rollouts Progressive rollouts

Progressive rollouts

A 채널은 안정적인 번들을 유지하면서 점진적으로 고정 장치 그룹에 별도의 롤아웃 대상으로 노출할 수 있습니다. 모든 사용자에게 채널을 전환하지 않고도 일시 중단, 재개, 승격, 롤백 및 자동 실패 응답을 구성할 수 있습니다. 자세히 보기 점진적 롤아웃 배포 모델, 대시보드 워크플로우, API field, 및 CLI 명령에 대한

자동 업데이트 전략 비활성화

이 옵션을 사용하여 채널이 자동으로 전달할 업데이트의 종류를 제한할 수 있습니다. 옵션:

major: 장치의 원래 기준보다 높은 메이저 버전을 가진 대상 번들이 차단됩니다. 예시:version_build차단됩니다. 1.2.3 -> 2.0.0 허용됩니다. 1.2.3 -> 1.9.0 minor: 대상 번들이 메이저 또는 미니 버전이 달라진 경우 차단됩니다. 예시:
차단됩니다. version_buildmajor: 장치의 원래 기준보다 높은 메이저 버전을 가진 대상 번들이 차단됩니다. 예시: 차단됩니다. 허용됩니다. 1.2.3 -> 1.3.0 차단되었습니다; 1.2.3 -> 1.2.4 허용됩니다.
patch: 가장 엄격한 모드입니다. 메이저, 마이너, 패치 번호의 변경은 모두 차단되며, 접미사만 변경할 수 있습니다. 접미사 변경은 허용됩니다. 예시: MAJOR.MINOR.PATCH 변경되지 않습니다. 1.0.0-beta.1 -> 1.0.0-beta.2 변경되지 않습니다. 1.0.0+build.1 -> 1.0.0+build.2 차단됩니다. 1.0.0 -> 1.0.1 메타데이터: 각 번들을 위한 최소 업데이트 버전 메타데이터가 필요합니다. __CAPGO_KEEP_0__을 사용하여 구성합니다.
metadata: Require a minimum update version metadata on each bundle. Configure via CLI using --min-update-version 변경되지 않습니다. --auto-min-update-version업데이트에 대한 호환성에 따라 모든 업데이트를 허용합니다.
업데이트가 거부될 때까지 설정되지 않은 채로 남아있는 채널은 오류로 간주됩니다. 호환성에 따라 모든 업데이트를 허용합니다..

이 전략은 채널의 목표 번들을 원시 기본값과 비교합니다. 이는 다운로드 된 현재 번들을 의미하는 것이 아닙니다. version_build현재 다운로드 된 번들을 의미하는 것이 아닙니다. version_name.

Disable updates strategy에 대한 자세한 내용과 예제는 /docs/cli/commands/#disable-updates-strategy에서 확인할 수 있습니다.

예시 (CLI). 채널이 이미 존재해야 합니다 (이미 존재하지 않으면 생성하지 않습니다):channel set 터미널 창

# Block major updates on the Production channel
npx @capgo/cli@latest channel set production com.example.app \
  --disable-auto-update major

# Allow devices to self-assign to the Beta channel
npx @capgo/cli@latest channel set beta com.example.app --self-assign

# Production channel: store builds on real devices, no emulators
npx @capgo/cli@latest channel set production com.example.app --prod --device --no-emulator

Your App에서 setChannel() 사용

QA/디버그 메뉴에서 테스터가 채널을 전환할 수 있도록 해줍니다. setChannel() The method allows your app to programmatically switch channels at runtime.

This is particularly useful for QA/debug menus where testers can switch between channels.
Beta 프로그램 옵인 흐름
기능 플래그 구현
A/B 테스트 시나리오

import { CapacitorUpdater } from '@capgo/capacitor-updater';

// Switch to the beta channel
await CapacitorUpdater.setChannel({ channel: 'beta' });

// Optionally trigger an immediate update check after switching
await CapacitorUpdater.setChannel({
  channel: 'beta',
  triggerAutoUpdate: true
});

언제 setChannel() 호출되는 경우:

백엔드 유효성 검사 (읽기 전용): Capgo 백엔드에 요청을 보내서 채널이 허용되는지 확인 (자기 할당 권한 확인)
로컬 스토리지 업데이트: 유효성 검사가 통과되면 채널은 장치의 로컬 스토리지에 저장된다 defaultChannel
즉시 효과: 다음 업데이트 확인은 새로운 채널을 즉시 사용합니다 (replication 대기 없음)

왜 이것이 중요합니까? 오래된 버전에서 setChannel() 채널 오버라이드 저장은 API UI와 동일한 백엔드 데이터베이스에 저장되었습니다 (Dashboard 또는 API 변경과 같습니다). 장치들은 백엔드 복제 대기 (2분 이내) 후 채널 변경이 적용되었습니다. 이제 setChannel() 채널 Switch는 백엔드에서만 읽고 로컬에서만 저장되므로 즉시 적용됩니다.

Dashboard 가시성: 플러그인으로 설정된 채널은 Capgo UI에서 장치 오버라이드로 나타나지 않습니다. 채널 assignments는 Dashboard 또는 Public API에서만 목록화됩니다. Dashboard 또는 API를 사용하여 관리자가 볼 수 있는 오버라이드를 필요로 할 때 사용하세요.

보안 주의: 채널의 권한이 로컬에서 변경되더라도 (예: 자체 할당이 비활성화된 경우), 백엔드는 업데이트 확인 중 채널을 검증하여 보안을 유지합니다.

채널 변경 방법 비교:

방법	효과 시간	저장된 위치	디바이스 오버라이드 UI에서 표시	만료	사용 사례
`setChannel()` 플러그인에서	즉시	디바이스만 (로컬)	아니오	아니오 (변경하거나 재설치할 때까지)	앱 내에서 사용자 동의한 채널 Switching
디바이스 오버라이드 대시보드	2분 이내	백엔드 데이터베이스	예	마지막 override 쓰기 후 90일	특정 장치에 대한 관리자가 시작한 변경
API 채널 할당	2분 이내	백엔드 데이터베이스	예	마지막 override 쓰기 후 90일	자동화된 백엔드 통합

채널-switching UI를 빌드할 때 최상의 사용자 경험을 제공하기 위해, 항상 플러그인의 setChannel() 기법.

지역 전용 채널 Switching을 위한 최소 버전: 5.34.0, 6.34.0, 7.34.0, 또는 8.0.0 (대부분의 버전에 따라). 각 소수 버전 번호는 모든 주요 버전에서 동일한 기능 집합을 나타냅니다 (예: X.34.0은 X가 5, 6, 7, 또는 8이면 동일한 기능을 포함합니다). 플러그인 설치 버전 태그를 참조하십시오.

채널에 번들을 Assign하는 방법

To deploy a live update, you need to upload a new JS bundle build and assign it to a channel. You can do this in one step with the Capgo CLI:

npx @capgo/cli@latest bundle upload --channel=Development

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Development 채널. 그 채널을 듣기 위해 구성된 모든 앱은 다음에 업데이트를 확인할 때 업데이트를 받을 것입니다.

또한 “번들” 섹션의 Capgo 대시보드에서 빌드를 채널에 할당할 수 있습니다. 메뉴 아이콘을 클릭하고 빌드에 할당할 채널을 선택하여 빌드를 채널에 할당하세요.

번들 버전 관리 및 채널

Capgo의 번들은 앱에 전역적이지만, 채널에 특정적이지 않습니다. 동일한 번들이 여러 채널에 할당될 수 있습니다.

번들을 버전화할 때, __CAPGO_KEEP_0__의 Semver Tester를 사용하여 의미 있는 버전을 사용하고, 채널에 특정한 빌드에 대해 prerelease 식별자를 사용하는 것을 추천합니다. 예를 들어, 베타 릴리스는 버전으로 다음과 같이 식별될 수 있습니다. CI에서, 로컬 버전이 업로드된 경우, (optionally), 또는 )를 사용하여 Capgo가 채널의 연결된 번들에서 버전을 올려서 무료 이름을 찾을 때까지 버전을 올립니다. 채널 1.2.3-beta.1.

번들 npx @capgo/cli@latest bundle upload --auto-bump 채널 major, minor, patch/fix, metadata번들 ai) so the CLI bumps from the channel’s linked bundle until a free name is found. With aiWorkers AI는 지역 vs 이전 delta 매니페스트에서 수준을 추론합니다 (이전 버전이 없으면) patch Capgo 버전이 없으면 사용할 수 없습니다. Capgo --bundleCI/CD 통합 __CAPGO_KEEP_0__ 참조 이 접근 방식에는 여러 이점이 있습니다: CLI reference.

__CAPGO_KEEP_0__는 __CAPGO_KEEP_0__의 사전 릴리스입니다.

버전 번호를 여러 채널에서 재사용할 수 있으므로 혼란을 줄입니다. 1.2.3-beta.1 역할백 경로를 명확하게 제공합니다. __CAPGO_KEEP_0__에서 역할백해야 하는 경우 __CAPGO_KEEP_0__를 알 수 있습니다. 1.2.3.
__CAPGO_KEEP_0__를 알 수 있습니다.
__CAPGO_KEEP_0__를 알 수 있습니다. 1.2.3__CAPGO_KEEP_0__를 알 수 있습니다. 1.2.2 이전 안정 버전입니다.

채널 설정의 일반적인 예를 들어 보겠습니다.

Development 채널: 1.2.3-dev.1, 1.2.3-dev.2등
QA 채널: 1.2.3-qa.1, 1.2.3-qa.2등
Staging 채널: 1.2.3-rc.1, 1.2.3-rc.2등
Production 채널: 1.2.3, 1.2.4등

Using semver와 prerelease 식별자 Capgo는 권장하는 방법이지만 엄격히 필요하지는 않습니다. 중요한 것은 빌드 간의 관계를 명확하게 전달하고 팀의 개발 프로세스와 일치하는 버전 관리 방식을 찾는 것입니다.

실시간 업데이트 롤백

버그나 롤백이 필요한 경우에 실시간 업데이트를 배포한 후, 이전 빌드로 쉽게 롤백할 수 있습니다. 대시보드의 '채널' 섹션에서:

롤백할 채널의 이름을 클릭합니다.
롤백할 빌드를 찾고 crown 아이콘을 클릭합니다.
확인

선택한 빌드는 즉시 해당 채널의 활성 빌드로 다시 설정됩니다. 앱은 업데이트를 확인할 때 다음 빌드로 업데이트됩니다.

자동 배포

더 복잡한 워크플로우를 위해, 실시간 업데이트 배포를 CI/CD pipeline의 일부로 자동화할 수 있습니다. Capgo을 빌드 프로세스에 통합하면, 특정 branch로 푸시하거나 새로운 릴리즈를 만들 때마다 새로운 번들을 자동으로 업로드하고 채널에 Assign할 수 있습니다.

Check out the CI/CD 통합 docs to learn more about automating Capgo live updates.

권한이 제한된 PR 미리보기

CI/CD 통합에 사용하는 앱 미리보기 API key when CI needs one temporary channel per pull request but must not manage existing main/default channels. The key remains bound to the owning organization and selected app; it simply has no organization-wide role. Each non-public preview channel it creates receives its own automatic, channel-scoped lifecycle permission.

조직 관리자가 미리보기 앱에 제한된 API 키를 생성하고 선택하세요. __CAPGO_KEEP_0__ Keys__CAPGO_KEEP_0__ API.
유니크하고 비공개 채널을 사용하세요. pr-123다음과 같은 옵션을 전달하지 마세요. --default, --self-assign. --delete-linked-bundle-on-upload.
PR 번들이 업로드되고 승인되면, PR이 닫히면 소유한 채널과 번들이 삭제됩니다:

APP_ID="com.example.app"
PREVIEW_CHANNEL="pr-123"
BUNDLE_VERSION="1.2.3-pr.123"

npx @capgo/cli@latest bundle upload "$APP_ID" \
  --apikey "$CAPGO_PREVIEW_KEY" \
  --path ./dist \
  --channel "$PREVIEW_CHANNEL" \
  --bundle "$BUNDLE_VERSION"

npx @capgo/cli@latest channel delete "$PREVIEW_CHANNEL" "$APP_ID" \
  --apikey "$CAPGO_PREVIEW_KEY" \
  --delete-bundle \
  --success-if-not-found

bundle upload --channel 터미널 창에서 채널이 생성되지 않은 채로 번들이 업로드되고 승인되며, 정리도 원자적이고 소유권이 확인됩니다. 키는 자신이 생성한 채널과 연결된, 공유되지 않은 번들을 삭제할 수 있지만, 기존의 메인/기본 채널, 다른 미리보기 키의 채널, 다른 키의 번들을 변경, 승인, 삭제할 수 없습니다.

리뷰어들이 QR code 또는 미리보기 URL이 필요하다면, 앱 관리자가 앱에 미리보기 기능을 활성화해야 합니다:

npx @capgo/cli@latest app set "$APP_ID" --preview
npx @capgo/cli@latest get-qr "$APP_ID" --channel "$PREVIEW_CHANNEL" --apikey "$CAPGO_PREVIEW_KEY" --url

App Preview 키는 앱 설정 권한이 없기 때문에 미리보기 기능을 활성화할 수 없습니다. GitHub Actions에서, 비밀번호가 포함된 미리보기 작업을 pull_request에서 실행하세요. pull_request_target그리고 동일한 저장소의 PR에 제한합니다. github.event.pull_request.head.repo.full_name == github.repository.

장치에 배포

이제 채널에 대해 이해했으므로 실제 장치에 라이브 업데이트를 배포하기 시작할 준비가 되었습니다. 기본 프로세스는 다음과 같습니다.

앱에 Capgo SDK을 설치합니다.
앱을 사용자 지정 채널에 수신하도록 구성합니다.
빌드를 업로드하고 해당 채널에 할당합니다.
앱을 실행하고 업데이트를 기다립니다!

세부 정보를 위해 더 자세한 walkthrough를 보려면 라이브 업데이트를 배포하는 방법을 참조하십시오. 업데이트를 즐기십시오!

고급 채널 사용: 사용자 구분

채널은 개발 단계만을 위한 것이 아닙니다. 사용자 구분을 위한 강력한 도구로, 다음과 같은 기능을 제공합니다.

다양한 사용자 계층에 대한 기능 플래그
A/B 테스트
기능 출시를 위한 점진적 출시
베타 테스트 프로그램

이 고급 사용 사례를 구현하는 방법에 대한 안내를 참조하세요: 기능 플래그 및 A/B 테스트를 위한 사용자 구분 방법.

채널에서 계속

채널을 사용하고 있다면 채널 채널 라우팅과 스테이지 롤아웃을 계획하고 채널 채널 채널 채널 베타 테스트 솔루션 채널 버전 대상 솔루션 채널 Capgo 환경 최적화: 단일 모바일 앱 ID로 스테이징 Capgo 환경 최적화: 단일 모바일 앱 ID로 스테이징