채널
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Live Update 채널은 앱의 특정 JS 번들 빌드를 가리키며, 해당 채널의 업데이트를 수신하도록 설정된 모든 기기에 공유됩니다. ~을(를) 설치하면 Capgo Live Updates SDK 앱에 설치하면, 해당 채널에 설정된 네이티브 바이너리는 앱이 실행될 때마다 사용 가능한 업데이트를 확인합니다. 채널이 가리키는 빌드는 언제든지 변경할 수 있으며, 필요 시 이전 빌드로 롤백할 수도 있습니다.
간단한 답변: Capacitor 앱의 스테이징 및 프로덕션을 위해 채널을 생성하고 staging 및 production Capgo에서 채널을 만들고 각 번들을 먼저 staging 업로드한 후 테스트하고, 같은 번들을 production.
Channel 활용 사례
“Channels in action” 섹션채널을 업데이트를 가리키는 이름이 지정된 포인터로 생각하세요: production 릴리스된 앱을 서빙할 수 있으며 beta 테스터에게 서빙합니다. 이 짧은 세 가지 영상은 디바이스가 채널에 어떻게 배치되는지 보여줍니다. 각 영상에는 선택적 배경 음악이 있고 내레이션은 없으며, 아래 설명이 동일한 단계를 다룹니다.
1. 기본 Channel 사용
“1. 기본 채널 사용” 섹션실행 중인 디바이스가 v1.1.0 가 Capgo에 업데이트를 요청합니다. 디바이스 할당이나 앱 설정 채널이 없으면 Capgo은 클라우드 기본값을 확인합니다. production, 그리고 이를 반환합니다 v1.2.0 bundle. dev 및 staging 채널은 이 기기에 영향을 주지 않고 자체 bundle을 유지합니다.
다음에서 production 기본값을 설정하세요: 앱 정보. 일반적인 production build는 defaultChannel 설정하지 않은 상태로 둘 수 있으며, Capgo에서 해당 라우팅을 관리할 수 있습니다.
2. 기기에서 Channel 선택
“2. 기기가 채널을 선택하도록 하기” 섹션이 가이드는 setChannel() 및 unsetChannel() 과 @capgo/capacitor-updater Android와 iOS에서 동작하며, 브라우저에서는 지원되지 않습니다. updater에서 사용할 수 있는 local-channel 동작을 사용합니다. 5.34.0+, 6.34.0+, 7.34.0+, 또는 8.0.0+ 플러그인의 메이저 버전에 대해. 이전 버전은 대신 백엔드 오버라이드를 작성했으며, 해당 할당은 다음을 따릅니다 콘솔 및 API 오버라이드 유지 규칙.
테스터가 앱 내에서 베타 업데이트를 활성화합니다. 앱은 다음을 호출합니다 CapacitorUpdater.setChannel({ channel: 'beta', triggerAutoUpdate: true }). Capgo가 다음을 확인합니다 beta 기기의 자체 할당을 허용하고, 플러그인은 향후 업데이트 확인을 위해 선택 사항을 로컬에 저장합니다. 다른 기기는 기존 라우팅을 유지합니다.
활성화 기기가 스스로 연결 해제/연결할 수 있도록 허용 사용하기 전에 대상 채널에서 setChannel(). 이 로컬 설정은 콘솔 오버라이드를 생성하지 않습니다. updater 8.51.0 이상의 Android 및 iOS에서는, persistDefaultChannelOnReinstall 기본값은 true, 따라서 OS가 앱 데이터를 복구할 때만 재설치 후에도 설정이 유지되며, persistDefaultChannelOnReinstall 유지됩니다 true. unsetChannel() 를 호출하여 로컬 설정을 초기화하세요. 콘솔 및 API 오버라이드는 여전히 아래 우선순위를 따릅니다.
3. 콘솔에서 기기 하나 할당하기
“3. 콘솔에서 기기 하나 할당하기” 섹션Capgo 콘솔에서 앱을(를) 열고 앱을 선택한 후 기기을(를) 열고 장치를 선택하세요. 해당 장치의 채널 오버라이드 대상 dev. Capgo가 해당 기기를 다음 채널로 라우팅합니다 dev, 앱의 클라우드 기본값은 그대로 유지됩니다 production.
타겟 테스트나 지원을 위해 오버라이드를 사용하세요. 강제 매핑이 없는 한, 기기의 로컬 채널과 클라우드 기본값보다 우선합니다. 콘솔 및 API 오버라이드 마지막 오버라이드 작성 후 90일이 지나면 만료됩니다.
지금 바로 사용해 보세요? 콘솔에서 채널 생성, 그 다음 번들 업로드 서빙되도록 합니다.
디바이스가 채널을 선택하는 방식 (우선순위)
“디바이스가 채널을 선택하는 방법(우선순위)” 섹션디바이스가 업데이트를 확인하면 Capgo가 다음 엄격한 순서(우선순위 높은 순)에 따라 어떤 채널을 사용할지 결정합니다:
- 강제 디바이스 매핑 (Dashboard) – 특정 디바이스 ID를 채널에 수동으로 고정합니다. 긴급 디버깅이나 실사용자 한 명을 대상으로 한 통제된 테스트에 사용하세요. 이 설정이 항상 우선합니다. Capgo는 마지막 오버라이드 기록 후 90일이 지나면 매핑을 제거합니다. 자세한 내용은 Console 및 API override는 90일 후 만료됩니다.
- Dashboard 또는 API를 통한 클라우드 오버라이드 (디바이스별) – Dashboard나 API에서 디바이스 채널을 변경할 때 생성됩니다. feature/PR 채널을 전환하는 QA 사용자나 사용자 이슈 재현 시 사용하세요. 바이너리를 재설치해도 유지되며, 디바이스 오버라이드를 삭제해야만 해제됩니다. 동일한 90일 보존 기간이 적용됩니다.
- 플러그인
setChannel()로컬 채널 – 앱이 다음을 호출할 때 생성됩니다:setChannel()그리고 백엔드에서 대상 채널이 셀프 할당을 허용하는지 확인합니다. 선택된 채널은 해당 디바이스에 로컬로 저장되어 즉시 적용되며, Device Override UI에는 표시되지 않습니다.
- Capacitor 설정
defaultChannel(테스트 빌드 기본값) – 포함되어 있고capacitor.config.*force/override/local 채널이 없으면, 앱은 이 채널로 시작됩니다 (예:beta,qa,pr-123). TestFlight 또는 내부 빌드용으로, 테스터가 자동으로 프리릴리스 채널에 들어가도록 하기 위한 설정입니다. 프로덕션 빌드에서는 보통 이 값을 설정하지 않습니다. - Cloud Default Channel (사용자의 약 99%가 이용하는 기본 경로) – 대시보드에서 기본 채널을 지정하면, 모든 일반 사용자(force, Dashboard/API override, 플러그인 local 채널, config defaultChannel이 없는 경우)가 이 채널에 연결됩니다. 새로운 바이너리 배포 없이 이 설정을 변경해 즉시 롤아웃하거나 롤백할 수 있습니다. 플랫폼별 기본 채널(예: iOS 전용, Android 전용, Electron 전용)이 있는 경우, 각 기기는 해당 플랫폼에 맞는 기본 채널로 연결됩니다. Cloud default를 설정하지 않아도 되며, 이 경우 기기가 업데이트를 받으려면 1~4단계 조건을 모두 충족해야 합니다.
권장 사항:
- 1~4단계를 예외/테스트 레이어로 취급하세요. Cloud default를 설정하면 실제 사용자들이 이 채널로 유입됩니다. 설정하지 않기로 했다면, 사용자가 어떻게 연결될지 신중하게 결정해야 합니다(보통
defaultChannelconfig 또는 기기별 override를 통해). - 테스터에게 명시적으로 배포하는 바이너리에서만
defaultChannel구성하세요. 설정을 비워두면 프로덕션 로직을 대시보드에서 중앙 집중식으로 관리할 수 있습니다. - 사용
setChannel()운영 환경에서는 제한적으로, 주로 QA나 특정 진단 목적으로만 사용하세요.
특정 플랫폼(iOS/Android/Electron 토글)에서 채널이 비활성화된 경우, 선택 대상이더라도 선택 프로세스에서 제외하고 다음 채널로 넘어갑니다.
요약: Force > Dashboard/API Override > Plugin
setChannel()로컬 채널 > ConfigdefaultChannel> Cloud 기본값.
Console 및 API override는 90일 후 만료됩니다
“Console 및 API override는 90일 후 만료됩니다” 섹션Forced mapping과 Dashboard 또는 Public API 채널 override는 Capgo에 디바이스별 할당으로 저장됩니다. cleanup job이 해당 할당을 삭제합니다. 마지막 오버라이드 쓰기 후 90일. 업데이트 확인(check-in)을 해도 그 기한은 초기화되지 않습니다. override를 다시 작성하거나 직접 삭제해야만 타임스탬프가 바뀝니다.
이는 다음과 다릅니다: 디바이스 인벤토리 보관 주기. Inventory는 Capgo에 90일 동안 연결되지 않은 기기를 제거합니다. Override cleanup은 기기가 여전히 활성 상태여도 매핑을 제거합니다.
이 cleanup에 의해 제거되지 않는 할당의 경우:
- 설정
defaultChannel에서capacitor.config.*(재설치 후에도 유지되며, 나중에 변경하려면 새로운 네이티브 바이너리가 필요합니다). - 호출하세요
setChannel()앱에서. 플러그인 5.34.0 / 6.34.0 / 7.34.0 / 8.0.0 이상에서는 해당 할당이 로컬에 저장되며 이 정리 작업으로 제거되지 않습니다. Android 및 iOS에서 업데이트기 8.51.0 이상인 경우,persistDefaultChannelOnReinstall기본값은true따라서 운영 체제가 앱 데이터를 복원할 때에만 재설치 후에도 할당이 유지될 수 있으며persistDefaultChannelOnReinstall유지됩니다true. 사용하세요unsetChannel()명시적으로 지우기 위해.
채널 기기 탭과 디바이스 Override UI에는 console 및 Public API 할당만 나열됩니다. 채널의 모든 디바이스를 나열하지 않으며, 로컬 setChannel() 할당도 나열하지 않습니다.

기본 채널 동작 방식
“Default Channel Behavior” 섹션클라우드 기본값 설정은 선택 사항이지만, 일반적으로 새 기기의 catch-all 경로로 사용됩니다. 설정하지 않으면 강제 매핑, 오버라이드 또는 defaultChannel 의 Capacitor 설정에 일치하는 기기만 업데이트를 받습니다. 기본값을 지정할 때 다음 패턴을 참고하세요:
- 단일 기본값 (가장 일반적) – 채널에 iOS, Android, Electron이 모두 활성화되어 있으면 유일한 기본값이 되며, 오버라이드가 없는 모든 기기가 여기에 연결됩니다.
- 플랫폼별 기본값 – 플랫폼별로 채널을 분리한 경우 (예:
ios-production에 iOS만 활성화,android-production에 Android만 활성화,electron-production에 Electron만 활성화), 각 채널을 해당 플랫폼의 기본값으로 지정합니다. iOS 기기는 iOS 기본값으로, Android 기기는 Android 기본값으로, Electron 앱은 Electron 기본값으로 연결됩니다.
클라우드 기본값과 defaultChannel 에서 capacitor.config.* 둘은 동일한 결정 계층을 차지합니다. 클라우드 기본값을 설정했다면 Capacitor 설정에서 값을 중복할 필요가 없으며, defaultChannel 프로덕션 빌드에는 비워 두세요. defaultChannel 클라우드 기본값과 상관없이 테스트어나 QA에게 비프로덕션 채널에서 시작하도록 의도적으로 바이너리를 배포할 때에만 사용하세요.
대시보드에서 언제든지 기본값을 변경할 수 있습니다. 채널을 연 다음 App 설정에서 관리을(를) 클릭하면 앱 정보으로 이동합니다. 기본값은 더 이상 채널 페이지의 토글이 아닙니다. 기본값을 전환하면 새 디바이스는 즉시 새로운 라우팅을 따르고, 기존 디바이스는 다음 체크인 시 정상 우선순위 규칙을 따릅니다.
채널 설정하기
“채널 설정” 섹션onboarding 중 첫 번째 채널을 생성합니다(대부분의 팀은 “Production”으로 이름 붙입니다). 하지만 아무것도 고정되지 않아 언제든 채널을 이름 변경하거나 삭제할 수 있습니다. 나중에 추가 채널을 만들려면:
- Capgo dashboard의 “Channels” 섹션으로 이동합니다
- “New Channel” 버튼을 클릭합니다
- 채널 이름을 입력하고 “Create”를 클릭합니다
채널 이름은 원하는 대로 지정할 수 있습니다. 일반적인 전략은 개발 단계에 맞춰 채널을 설정하는 것입니다. 예:
Development- 로컬 기기나 에뮬레이터에서 Live Update를 테스트할 때QA- QA 팀이 광범위한 릴리스 전에 업데이트를 검증할 때Staging- 프로덕션과 유사한 환경에서 최종 테스트를 할 때Production- 앱 스토어에서 최종 사용자가 받는 앱 버전을 배포할 때
앱에서 채널 구성하기
“앱에서 채널 설정” 섹션채널 생성이 완료되면, 앱이 적절한 채널을 수신하도록 설정해야 합니다. 이 예제에서는 Development 채널.
다음 capacitor.config.ts (또는 capacitor.config.json) 파일. 아래 plugins 섹션에서 선택적으로 설정 defaultChannel 위해 테스트 빌드 (내부/QA용). 프로덕션 빌드에서는 명시적으로 오버라이드하지 않는 한 디바이스가 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 업데이트된 설정 파일을 iOS, Android, Electron 프로젝트로 복사합니다. 이 동기화 단계를 건너뛰면 네이티브 프로젝트는 이전에 설정된 채널을 계속 사용합니다.
채널 옵션 및 전략
“채널 옵션 및 전략” 섹션채널에는 업데이트 수신 대상과 전달 방식을 제어하는 여러 옵션이 있습니다. 가장 중요한 옵션은 다음과 같습니다. 웹 앱, CLI 또는 Public API에서 설정할 수 있습니다.
- 기본 채널: 새 기기가 연결될 채널 또는 플랫폼별 채널을 선택적으로 지정합니다. 콘솔에서는 App Information(App 설정에서 관리 채널 페이지에서 설정합니다. 라우팅 시나리오는 “기본 채널 동작”을 참고하세요.
- 플랫폼 필터: 채널별
iOS,Android, 또는Electron기기 전달을 활성화하거나 비활성화합니다. - 네이티브에서 자동 다운그레이드 비활성화: 기기의 네이티브 앱 버전이 채널의 bundle보다 최신일 때 업데이트 전송을 방지합니다(예: 기기가 1.2.3이고 채널이 1.2.2인 경우).
- 개발 빌드 허용: 개발 빌드에 대한 업데이트를 허용합니다(테스트에 유용). CLI:
--dev/--no-dev. - 프로덕션 빌드 허용: 프로덕션(스토어) 빌드에 대한 업데이트를 허용합니다. 실제 사용자에게 제공되는 채널에서는 켜 두세요. CLI:
--prod/--no-prod. - 에뮬레이터 기기 허용: 에뮬레이터/시뮬레이터에 대한 업데이트를 허용합니다(테스트에 유용). CLI:
--emulator/--no-emulator. - 실기기 허용: 실제 스마트폰 및 태블릿에 대한 업데이트를 허용합니다. 프로덕션 채널에서는 켜 두세요. CLI:
--device/--no-device. - 기기 자체 할당 허용: 앱이 런타임에 자체 할당으로 이 채널로 전환할 수 있게 합니다
setChannel. 비활성화 시,setChannel이 채널에 대해 실패합니다. CLI:--self-assign/--no-self-assign. - 다운로드 형식: 디바이스가 전체 zip, 변경된 delta 파일만, 또는 두 가지의 최적 조합(
all,zip,delta,zip_from_builtin,delta_from_builtin"). 규칙은 다운로드 형식 콘솔 드롭다운 및 각 모드가 유용한 시점에 대해.
채널은 안정적인 bundle을 유지하면서 별도 rollout 대상에 대해 고정된 디바이스 코호트를 점진적으로 노출할 수 있습니다. 모든 사용자에게 채널을 전환하지 않고도 일시 중지, 재개, 승격, 롤백 및 자동 실패 응답을 구성할 수 있습니다. 참고 단계적 배포 전달 모델, 대시보드 워크플로, API 필드 및 CLI 명령에 대해.
Auto Update 전략 비활성화
“Disable Auto Update strategies” 섹션채널이 자동으로 전달할 업데이트 유형을 제한하려면 이 설정을 사용하세요. 옵션:
- major: 디바이스 네이티브 베이스라인보다 major 버전이 높은 대상 bundle을 차단합니다 (
version_build). 예:1.2.3 -> 2.0.0차단됨;1.2.3 -> 1.9.0허용됨. - minor: major 또는 minor 버전이
version_build. Example:1.2.3 -> 1.3.0차단됨;1.2.3 -> 1.2.4허용됨. - patch: 가장 엄격한 모드입니다. major, minor, 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차단됨. - metadata: 각 bundle에 최소 업데이트 버전 메타데이터를 요구합니다. CLI을 사용해 설정하세요.
--min-update-version또는--auto-min-update-version누락되면 채널이 설정 오류로 표시되며, 설정 전까지 업데이트가 거부됩니다. - none: 모든 업데이트를 허용합니다. 기준은 semver 호환성.
이 전략들은 채널의 대상 번들을 전송된 네이티브 베이스라인과 비교하며, version_build현재 다운로드된 번들을 전송한 것과는 비교하지 않습니다. version_name.
자세한 내용과 예시는 /docs/cli/commands/#disable-updates-strategy의 Disable updates strategy를 참조하세요.
예시 (CLI). 채널은 이미 존재해야 합니다 (channel set 자동으로 생성하지는 않습니다):
# Block major updates on the Production channelnpx @capgo/cli@latest channel set production com.example.app \ --disable-auto-update major
# Allow devices to self-assign to the Beta channelnpx @capgo/cli@latest channel set beta com.example.app --self-assign
# Production channel: store builds on real devices, no emulatorsnpx @capgo/cli@latest channel set production com.example.app --prod --device --no-emulator앱에서 setChannel() 사용하기
“Using setChannel() from Your App” 섹션이 @capgo/capacitor-updater 메서드 setChannel() Android 또는 iOS 앱에서 런타임에 프로그래밍 방식으로 채널을 전환할 수 있습니다. 다음 상황에서 특히 유용합니다:
- 테스터가 채널을 전환할 수 있는 QA/디버그 메뉴
- 베타 프로그램 가입 플로우
- 피처 플래그 구현
- A/B 테스트 시나리오
import { CapacitorUpdater } from '@capgo/capacitor-updater';
// Switch to the beta channelawait CapacitorUpdater.setChannel({ channel: 'beta' });
// Optionally trigger an immediate update check after switchingawait CapacitorUpdater.setChannel({ channel: 'beta', triggerAutoUpdate: true});채널에 Bundle 할당하기
“Bundle을 채널에 할당” 섹션live update를 배포하려면 새 JS bundle 빌드를 업로드하고 채널에 할당해야 합니다. Capgo CLI를 사용하면 이 과정을 한 번에 처리할 수 있습니다:
npx @capgo/cli@latest bundle upload --channel=Development이 명령은 빌드된 웹 에셋을 업로드하고, 해당 채널의 활성 빌드로 새 번들을 설정합니다. Development 해당 채널을 수신하도록 설정된 앱은 다음 업데이트 확인 시 이 업데이트를 받게 됩니다.
Capgo 대시보드의 “Bundles” 섹션에서도 빌드를 채널에 할당할 수 있습니다. 빌드 옆의 메뉴 아이콘을 클릭한 후 “Assign to Channel”을 선택하여 해당 빌드에 할당할 채널을 지정하세요.
Bundle 버전 관리와 Channel
“Bundle Versioning and Channels” 섹션Capgo의 bundle은 개별 채널이 아닌 앱 전체에 적용되는 글로벌 단위라는 점을 유의하세요. 동일한 bundle을 여러 채널에 할당할 수 있습니다.
Bundle 버전 관리 시 Capgo의 Semver Tester를 활용한 semantic versioning과 채널별 빌드를 위한 pre-release identifier 사용을 권장합니다. 예를 들어, beta 릴리스는 다음과 같이 버전 관리할 수 있습니다. 1.2.3-beta.1.
CI에서 로컬 버전이 이미 업로드된 경우 npx @capgo/cli@latest bundle upload --auto-bump (선택적으로 major, minor, patch/fix, metadata, 또는 ai)를 사용하여 CLI가 채널에 연결된 bundle에서 시작해 사용 가능한 이름이 나올 때까지 버전을 올립니다. ai, Workers AI는 로컬과 이전 버전의 delta manifest 차이를 분석하여 레벨을 추론합니다(실패 시 patch 이전 Capgo 버전이 없는 경우). 이 기능과 함께 사용할 수 --bundle. 참조 CI/CD 통합 및 CLI 레퍼런스.
이 방식에는 여러 가지 장점이 있습니다:
- 빌드 간의 관계를 명확하게 보여줍니다.
1.2.3-beta.1은(는) 분명히 ...의 프리릴리스입니다1.2.3. - 채널 간 버전 번호를 재사용할 수 있어 혼란을 줄입니다.
- 명확한 롤백 경로를 제공합니다. ...에서 롤백해야 하는 경우
1.2.3, 아시다시피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등의 에셋을 첨부합니다.
사용하기 pre-release 식별자를 포함한 semver 권장되는 방식이지만 필수 사항은 아닙니다. 핵심은 빌드 간의 관계를 명확히 전달하고 팀의 개발 프로세스와 일치하는 버전 관리 체계를 찾는 것입니다.
Live Update 롤백하기
“Live Update 롤백하기” 섹션버그가 포함된 live update를 배포했거나 이전 상태로 되돌려야 하는 경우, 이전 빌드로 쉽게 롤백할 수 있습니다. 대시보드의 “Channels” 섹션에서 다음을 수행하세요:
- 롤백하려는 채널의 이름을 클릭합니다
- 되돌리려는 빌드를 찾아 왕관 아이콘을 클릭합니다

- 작업 확인
선택한 빌드가 해당 채널의 활성 빌드로 즉시 다시 설정됩니다. 앱은 다음 업데이트 확인 시 롤백된 버전을 받게 됩니다.
배포 자동화
“배포 자동화” 섹션더 고급 워크플로우를 위해 CI/CD 파이프라인의 일부로 live update 배포를 자동화할 수 있습니다. 빌드 프로세스에 Capgo을 통합하면 특정 브랜치에 push하거나 새 릴리스를 생성할 때마다 새 번들을 자동으로 업로드하고 채널에 할당할 수 있습니다.
문서를 확인해 보세요 CI/CD 통합 Capgo 라이브 업데이트 자동화에 대해 자세히 알아보려면 문서를 참고하세요.
최소 권한 PR 프리뷰
“최소 권한 PR 미리보기” 섹션을(를) 사용하세요 앱 미리보기 CI가 풀 리퀘스트마다 임시 채널 하나만 필요하지만 기존 main/default 채널을 관리해서는 안 되는 경우 API 키를 사용하세요. 이 키는 소유 조직과 선택된 앱에만 바인딩되며, 조직 전체 역할을 갖지 않습니다. 이 키가 생성하는 각 비공개 미리보기 채널에는 채널 범위로 제한된 자동 라이프사이클 권한이 부여됩니다.
- 조직 관리자가 미리보기 앱으로만 제한된 안전한 API 키를 생성하고 선택하세요 앱 미리보기. 참조 API 키.
- 다음과 같은 고유한 비공개 채널을 사용하세요:
pr-123. 다음을 전달하지 마세요:--default,--self-assign롤아웃 옵션이나--delete-linked-bundle-on-upload. - 한 번의 명령으로 PR 번들을 upload하고 promote한 뒤, 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-foundbundle upload --channel 없는 채널을 생성하고 번들을 upload한 뒤 한 번의 흐름으로 promote합니다. 정리 작업은 원자적이며 소유권 검사를 거칩니다. 즉, 키는 자신이 생성한 채널과 연결된 비공유 번들만 삭제할 수 있습니다. 기존 main/default 채널, 다른 preview 키의 채널, 다른 키의 번들은 변경하거나 promote하거나 삭제할 수 없습니다.
리뷰어에게 QR code 또는 미리보기 URL이 필요한 경우, 관리자가 앱에 대해 미리보기를 한 번 활성화해야 합니다:
npx @capgo/cli@latest app set "$APP_ID" --previewnpx @capgo/cli@latest get-qr "$APP_ID" --channel "$PREVIEW_CHANNEL" --apikey "$CAPGO_PREVIEW_KEY" --urlApp Preview 키는 app-settings 권한이 없으므로 스스로 프리뷰를 활성화할 수 없습니다. GitHub Actions에서 시크릿을 사용하는 프리뷰 작업을 실행하고, pull_request, 아니라 pull_request_target동일 저장소의 PR로만 제한하세요. github.event.pull_request.head.repo.full_name == github.repository.
기기에 배포하기
“기기에 배포하기” 섹션이제 채널을 이해했으니, 실제 기기에 라이브 업데이트를 배포할 준비가 되었습니다. 기본 프로세스는 다음과 같습니다:
- 앱에 Capgo SDK 설치
- 원하는 채널을 수신하도록 앱 설정
- 빌드를 업로드하고 해당 채널에 할당
- 앱을 실행하고 업데이트를 기다리세요!
더 자세한 단계별 가이드는 다음을 참조하세요: Live Updates 배포하기 가이드. 즐거운 업데이트 하세요!
고급 Channel 활용: 사용자 세그먼트
“고급 채널 활용: 사용자 세그먼테이션” 섹션채널은 개발 단계에만 쓰이는 게 아닙니다. 다음과 같은 기능을 가능하게 하는 강력한 사용자 세그먼테이션 도구입니다:
- 사용자 등급별 기능 플래그
- A/B 테스트
- 점진적 기능 롤아웃
- 베타 테스트 프로그램
이러한 고급 활용 사례를 구현하는 방법은 가이드에서 확인하세요: 기능 플래그와 A/B 테스트를 위한 요금제·채널별 사용자 세그먼테이션 방법.
Channels에서 계속하기
“Channels에서 계속하기” 섹션사용 중이라면 채널 채널 라우팅과 단계적 배포를 계획하려면, 다음을 연결하세요: 채널 Channels의 구현 세부 사항은 다음을 참고하세요: 채널 Channels의 구현 세부 사항은 다음을 참고하세요: Beta Testing 솔루션 Beta Testing Solution의 제품 워크플로우에서 버전 타겟팅 솔루션 Version Targeting Solution의 제품 워크플로우에서, 그리고 Capgo 환경 베스트 프랙티스: 하나의 Mobile App ID로 스테이징하기 Capgo 환경 모범 사례: 모바일 앱 ID 하나로 스테이징의 실무 맥락에서