채널

설치 단계와 이 플러그인의 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Live Update 채널은 특정 JS 번들 빌드에 대한 링크를 제공하며, 이 채널을 듣기 위해 구성된 모든 장치에 업데이트를 공유합니다. Live Update를 __CAPGO_KEEP_0__에 __CAPGO_KEEP_1__로 설치하면, 앱을 실행할 때마다 native binary가 업데이트가 있는지 확인합니다. 채널이 가리키는 빌드를 언제든지 변경할 수 있고 이전 빌드로 롤백할 수도 있습니다. install the Capgo Live Updates SDK 채널은 업데이트를 제어하지만 번들을 보호하지 않습니다. 채널이 개인이거나 self-assignment이 비활성화되어도, __CAPGO_KEEP_0__에 업로드된 암호화되지 않은 번들은 여전히 클라이언트에게 공유된 자산으로 처리되어야 합니다. 암호화는 업데이트의 전달 경로와 진위성을 보호하지만, 배포된 앱을 충분한 노력으로 역공학할 수 있습니다. 클라이언트의 공개 키는 앱의 일부입니다. 자세한 내용은

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

장치가 업데이트 확인을 할 때, Capgo은 다음의 순서 (우선 순위가 높은 순)에서 채널을 선택합니다.

강제 장치 매핑 (대시보드) – 긴급 디버깅이나 단일 실제 사용자와 제어된 테스트를 위해 특정 장치 ID를 채널에 매핑합니다. 항상 승리합니다.
Cloudflare override (per-device) via Dashboard or API – 대시보드 또는 API에서 장치의 채널을 변경할 때 생성됩니다. QA 사용자가 기능/PR 채널 또는 사용자 문제를 재현하기 위해 switch할 때 사용합니다. 바이너리 재설치로 지워지지 않으며, 장치 항목 삭제로 지워집니다.
플러그인 setChannel() local channel – 앱이 호출할 때 생성됩니다. setChannel() __CAPGO_KEEP_0__ backend이 대상 채널이 자체 할당을 허용하는지 확인합니다. 선택된 채널은 해당 기기에서 지역 저장소에 저장되고 즉시 적용되며 Device Override UI에서 표시되지 않습니다.

__CAPGO_KEEP_0__ 플러그인 버전 5.34.0, 6.34.0, 7.34.0, 또는 8.0.0부터 시작하여 __CAPGO_KEEP_1__ setChannel() __CAPGO_KEEP_0__ 백엔드에 접촉하여 __CAPGO_KEEP_0__ 채널이 허용되는지 확인합니다 (해당 채널에 자체 할당이 가능한지 확인합니다), 그 다음 기기에서 채널을 __CAPGO_KEEP_0__ 지역 저장소에 저장합니다 __CAPGO_KEEP_0__ 이므로 새로운 채널은 즉시 적용됩니다. __CAPGO_KEEP_0__ defaultChannel__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ for the next update check—no waiting for replication.

이전에는 setChannel() API 백엔드 데이터베이스에 채널 오버라이드 저장 (대시보드나 API 변경과 같은)하고, 장치들은 데이터 복제 (최대 2분)가 완료될 때까지 새로운 채널이 인식되기까지 기다려야했습니다. 새로운 동작은 백엔드에서만 읽어 (유효성 검사)하고, 지역 저장소에 저장하여 채널 Switch가 즉시 발생합니다.

Because setChannel() __CAPGO_KEEP_0__는 지역 전용이므로, __CAPGO_KEEP_0__ 대시보드에 Device Override 항목을 생성하지 않습니다. Device Override UI는 대시보드나 Public __CAPGO_KEEP_1__에서만 오버라이드된 항목만 표시합니다. create a Device Override entry in the Capgo dashboard. The Device Override UI only shows overrides created from the dashboard or the Public API.

채널이 지역에서 설정된 후에 허용되지 않게 된 경우에도, 백엔드는 업데이트 확인 중에 채널을 유효성 검사하므로 보안은 유지됩니다. Important:

대시보드나 __CAPGO_KEEP_0__를 통해 채널 변경이 이루어질 경우에도, 모든 에지 서버가 변경을 반영하기까지 최대 2분의 복제 지연이 발생합니다. 즉시 채널 Switch를 사용하려면 API에서 앱에서 사용하세요—백엔드와 유효성 검사를 수행한 후, 지역에서 채널을 설정하여 즉시 효과를 발생시킵니다. setChannel() code는 지역 전용이므로, code 대시보드에 Device Override 항목을 생성하지 않습니다. Device Override UI는 대시보드나 Public __CAPGO_KEEP_1__에서만 오버라이드된 항목만 표시합니다.

Capacitor 설정 defaultChannel (테스트 빌드 기본값) – __CAPGO_KEEP_0__이 존재할 경우, capacitor.config.* 와 force/override/local 채널이 존재하지 않는 경우, 이 채널에서 앱이 시작됩니다 (예: ). 테스트 플라이트 / 내부 빌드용으로 설계되었습니다. 프로덕션 빌드는 일반적으로 이 설정을 비워둡니다. beta, qa, pr-123Cloud 기본 채널 (주요 경로 ~99%의 사용자)
– 대시보드에서 기본 채널을 표시하면 모든 일반 사용자 (force, 대시보드/__CAPGO_KEEP_0__ override, 플러그인 local 채널, config defaultChannel이 없는 경우) 이곳에 연결됩니다. 이 채널을 변경하면 즉시 배포 또는 롤백할 수 있습니다. 새로운 바이너리가 필요하지 않습니다. 플랫폼별 기본값을 설정한 경우 (예: iOS 전용, Android 전용, Electron 전용), 각 기기는 해당 플랫폼에 맞는 기본값으로 연결됩니다. Cloud 기본 채널을 비워두는 것은 허용되며, 이 경우 기기는 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 단계를 예외/테스트 계층으로 처리하십시오. Cloud 기본 채널을 설정하면 실제 사용자는 이 채널로 흐릅니다. Cloud 기본 채널을 설정하지 않으면, 사용자가 연결되는 방법에 대해 명확하게 결정하십시오 (일반적으로 config 또는 per-device override를 통해).

Only configure defaultChannel 테스터에게 직접 배포하는 바이너리에서만 __CAPGO_KEEP_0__을 구성하십시오. Cloud 기본 채널을 비워두면 프로덕션 로직이 중앙 집중식으로 대시보드에 유지됩니다.
__CAPGO_KEEP_0__ config defaultChannel (테스트 빌드 기본값)
사용 setChannel() 생산 환경에서 주로 QA 또는 특정 진단 목적으로 사용합니다.

플랫폼 (iOS/Android/Electron)에서 채널이 비활성화되어 선택될 경우, 목록에서 채널을 건너뛰고 계속 진행합니다.

강제 > 대시보드/API Override > 플러그인 setChannel() 지역 채널 > 설정 defaultChannel > Cloud 기본.

기본 채널 동작

섹션 defaultChannel 클라우드 기본값을 설정하는 것은 선택사항이지만, 일반적으로 새로운 장치의 기본 경로로 사용됩니다. 기본값이 없으면, 강제 매핑, 오버라이드 또는 Capacitor 설정에 맞는 장치만 업데이트를 받습니다. 기본값을 설정할 경우, 다음 패턴을 고려하세요.

단일 기본값 (가장 일반적인 경우) – iOS, Android, Electron이 모두 활성화된 채널이 단일 기본값이 됩니다. 오버라이드가 없는 장치들은 이 채널에 연결됩니다.
플랫폼별 기본값 – 플랫폼별 채널을 분리할 경우 (예를 들어, ios-production iOS만 활성화된 경우 android-production Android만 활성화된 경우 electron-production Electron만 활성화된 경우), 각 채널을 해당 플랫폼의 기본값으로 표시합니다. iOS 기기는 iOS 기본값으로, Android 기기는 Android 기본값으로, Electron 앱은 Electron 기본값으로 이동합니다.

기억하십시오. 클라우드 기본값과 defaultChannel 두 채널은 동일한 결정 층을 차지합니다. 클라우드 기본값을 설정하면 __CAPGO_KEEP_0__ 구성에서 값을 중복해서 입력할 필요가 없습니다.—생산 빌드에서는 빈 채널을 남겨두십시오. 테스터나 QA에게 배포할 때 의도적으로 비프로덕션 채널로 시작하도록 하려면 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 대시보드에서 언제든지 기본값을 변경할 수 있습니다. 기본값을 바꾸면 새로운 기기는 즉시 새로운 라우팅을 따르며 기존 기기는 다음에 체크인할 때 정상 순위 규칙을 따릅니다. defaultChannel 채널 설정을 위한 설정을 구성합니다.

__CAPGO_KEEP_0__

Setting up a Channel

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

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

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

Development - 로컬 장치나 에뮬레이터에서 실시간 업데이트를 테스트합니다.
QA - QA 팀이 더 넓은 릴리스 전에 업데이트를 확인합니다.
Staging - 실제 환경과 유사한 환경에서 최종 테스트를 수행합니다.
Production - 앱 스토어에서 사용자에게 제공되는 앱 버전

앱에서 채널 설정

__CAPGO_KEEP_0__ 채널을 생성한 후, 채널에 맞게 앱을 구성해야 합니다. 이 예에서는 Development 채널을 사용합니다. Open your

(또는 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.
    },
  },
};

__CAPGO_KEEP_1__ npx cap sync __CAPGO_KEEP_2__

채널 옵션 및 전략

Channels have several options that control who can receive updates and how updates are delivered. The most important ones are below. You can configure these from the web app, the CLI, or the Public API.

기본 채널: 새로운 장치가 연결될 때 채널 또는 플랫폼에 특정한 채널을 선택적으로 표시합니다. "기본 채널 동작"을 참조하여 라우팅 시나리오를 확인하세요.
플랫폼 필터: iOS, Android, Electron 장치당 채널당
네이티브 하위 버전 방지: 장치의 네이티브 앱 버전이 채널의 버전보다 새로운 경우 업데이트를 보내지 않습니다 (예를 들어, 장치 버전 1.2.3, 채널 버전 1.2.2).
개발 빌드 허용: 개발 빌드에 업데이트를 허용합니다 (테스트에 유용합니다).
에뮬레이터 장치 허용: 에뮬레이터/시뮬레이터에 업데이트를 허용합니다 (테스트에 유용합니다).
장치 자체 할당 허용: 런타임에 앱이 이 채널을 switch할 수 있도록 허용합니다. setChannel이 채널이 비활성화된 경우 setChannel 자동 업데이트 전략 비활성화

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

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

major: 기존 기기 기본선에 비해 주요 버전이 높은 대상 패키지를 차단합니다. (version_build) 예시: 1.2.3 -> 2.0.0 차단됨; 1.2.3 -> 1.9.0 허용됨.
minor: 대상 패키지의 주요 버전 또는 부 버전이 기존 기기 기본선과 다르면 차단합니다. 예시: version_build차단됨; 1.2.3 -> 1.3.0 허용됨. 1.2.3 -> 1.2.4 patch: 가장 엄격한 모드입니다. 주요, 부, 패치 번호의 변경을 차단합니다.
허용됨, MAJOR.MINOR.PATCH is allowed, 1.0.0-beta.1 -> 1.0.0-beta.2 is blocked; 1.0.0+build.1 -> 1.0.0+build.2 허용됩니다. 1.0.0 -> 1.0.1 차단됩니다.
메타데이터: 각 번들을 위한 최소 업데이트 버전 메타데이터가 필요합니다. CLI을 사용하여 구성합니다. --min-update-version 또는 --auto-min-update-version. 업데이트 채널이 미설정된 경우 채널이 미설정된 것으로 표시되고 업데이트가 거부될 것입니다.
모두: 업데이트를 __CAPGO_KEEP_0__에 따라 모두 허용합니다. semver 호환성: 업데이트를 __CAPGO_KEEP_0__에 따라 호환성에 따라 허용합니다..

이 전략은 채널의 목표 번들을 native baseline으로 비교합니다. __CAPGO_KEEP_0__으로 전달된 것이 아니라 __CAPGO_KEEP_0__으로 전달된 현재 다운로드 된 번들과는 다릅니다. version_buildDisable updates strategy에 대한 자세한 내용과 예제는 /docs/__CAPGO_KEEP_0__/commands/#disable-updates-strategy에서 확인할 수 있습니다. version_name.

예(cli):

Example (CLI):

# 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

앱에서 setChannel() 사용

이 setChannel() 메소드는 앱이 런타임에 채널을 프로그래밍적으로switch할 수 있게합니다. 이 기능은 특히 다음 경우에 유용합니다:

QA/테스트 메뉴에서 테스터가 채널을 switch할 수 있도록 해주는 경우
베타 프로그램 옵인 플로우
기능 플래그 구현
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_KEEP_0__ 백엔드에 요청을 보내 channel이 허용되는지 유효성 검사합니다 (자기 할당 권한 확인): A request is sent to the Capgo backend to validate the channel is allowed (checking self-assignment permissions)
: 유효성 검사 통과 시 channel은 장치의 로컬 스토리지에 저장됩니다즉시 효과 defaultChannel
: 다음 업데이트 체크에서는 즉시 새로운 채널을 사용합니다 (리플리케이션 기다리지 않음)왜 이것이 중요합니까?

오래된 버전에서 채널 오버라이드 저장을 백엔드 데이터베이스에 저장했습니다 (같은 Dashboard 또는 __CAPGO_KEEP_0__ 변경과 같습니다). 장치들은 백엔드 리플리케이션을 기다려야 하며 (2분까지) 채널 변경이 즉시 효과가 나타나지 않았습니다. 이제 setChannel() saved the channel override to the backend database (same as Dashboard or API changes). Devices had to wait for backend replication (up to 2 minutes) before the channel change took effect. Now, setChannel() is called:

대시보드 표시: Capgo UI에서 장치 오버라이드로 나타나지 않는다. 대시보드나 API에서 생성한 채널 assignments만 표시된다. 대시보드나 API를 사용하여 관리자가 볼 수 있는 오버라이드를 필요할 때 사용하십시오.

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

채널 변경 방법 비교:

방법	효과 시간	지속되는 곳	장치 오버라이드 UI에서 표시	사용 사례
`setChannel()` 플러그인에서	즉시	__CAPGO_KEEP_0__ 기기 전용 (로컬)	아니요	사용자 초기화 채널 Switching in-app
기기 대시보드 override	2분 이내	백엔드 데이터베이스	예	관리자 초기화 특정 기기 변경
API 채널 assignment	2분 이내	백엔드 데이터베이스	예	자동화된 백엔드 통합

채널-switching UI를 구축할 때 최상의 사용자 경험을 제공하려면 항상 플러그인의 setChannel() 메소드를 사용하세요.

지역 전용 채널 Switching을 위한 최소 버전: 5.34.0, 6.34.0, 7.34.0, 또는 8.0.0 (대형 버전에 따라) 대형 버전의 숫자는 모든 버전에서 동일한 기능 집합을 나타냅니다 (예: X.34.0은 X가 5, 6, 7, 또는 8이더라도 동일한 기능을 포함합니다). 버전 태그에 대한 플러그인 설치

채널에 번들을 할당하는 방법

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

이 작업은 빌드된 웹 자산을 업로드하고 새로운 번들을 활성 빌드로 설정합니다. 채널. 채널에 구성된 앱은 업데이트를 받을 때까지 업데이트를 받습니다. Development __CAPGO_KEEP_0__ 대시보드의 “번들” 섹션에서 빌드를 채널에 Assign 할 수 있습니다. 메뉴 아이콘을 클릭하고 Assign to Channel을 선택하여 빌드에 채널을 선택하세요.

You can also assign builds to channels from the “Bundles” section of the Capgo dashboard. Click the menu icon next to a build and select “Assign to Channel” to choose the channel for that build.

번들 버전 관리 및 채널

번들을 버전화할 때는 Capgo의 Semver Tester와 함께 의미적 버전 관리를 사용하는 것을 추천합니다. 예를 들어, 채널에 특정한 빌드에 대한 프리 리리즈 식별자를 사용할 수 있습니다. 예를 들어, 베타 릴리스는 버전 1.2.3-beta.1로 버전화할 수 있습니다.

이 접근 방식에는 여러 이점이 있습니다. semantic versioning with Capgo’s Semver Tester Semantic versioning with __CAPGO_KEEP_0__'s Semver Tester and pre-release identifiers for channel-specific builds. 1.2.3-beta.1.

This approach has several benefits: It clearly communicates the relationship between builds.

It’s important to note that bundles in __CAPGO_KEEP_0__ are global to your app, not specific to individual channels. The same bundle can be assigned to multiple channels. 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, etc.
QA 채널: 1.2.3-qa.1, 1.2.3-qa.2, etc.
Staging 채널: 1.2.3-rc.1, 1.2.3-rc.2, etc.
Production 채널: 1.2.3, 1.2.4, etc.

사용 pre-release 식별자와 함께 semver 사용하는 것은 권장되는 방법이지만, 엄격히 필요하지는 않습니다. 중요한 것은, 빌드 간의 관계를 명확하게 전달하고, 팀의 개발 프로세스와 일치하는 버전 관리 방식을 찾는 것입니다. 실시간 업데이트 롤백

제목: “실시간 업데이트 롤백”

롤백할 채널 이름을 클릭

롤백할 빌드를 찾고, 왕관 아이콘을 클릭
롤백 빌드
확인

The selected build will immediately become the active build for that channel again. Apps will receive the rolled back version the next time they check for an update.

자동 배포

For more advanced workflows, you can automate your live update deployments as part of your CI/CD pipeline. By integrating Capgo into your build process, you can automatically upload new bundles and assign them to channels whenever you push to certain branches or create new releases.

더 알아보기 CI/CD 통합 docs를 참조하여 Capgo live updates를 자동화하는 방법을 알아보세요.

장치에 배포

Now that you understand channels, you’re ready to start deploying live updates to real devices. The basic process is:

Capgo SDK을 앱에 설치합니다.
설정에서 __CAPGO_KEEP_0__ 채널을 듣도록 구성합니다.
채널에 빌드를 업로드하고 assign 해주세요.
앱을 실행하고 업데이트를 기다리세요!

상세한 walkthrough를 보려면 " 실시간 업데이트 배포 "를 참조하세요. 업데이트 하시길 바랍니다.

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

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

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

__CAPGO_KEEP_0__을 사용하여 이러한 고급 사용 사례를 구현하는 방법에 대한 안내서를 참조하십시오. __CAPGO_KEEP_1__을 사용하여 사용자를 플랜 및 채널에 따라 구분하고 기능 플래그 및 A/B 테스트를 위한 구분 방법을 알아보십시오..

__CAPGO_KEEP_0__에서 채널을 계속 진행하십시오.

__CAPGO_KEEP_0__을 사용하고 계신가요. __CAPGO_KEEP_3__을 사용하여 채널 라우팅 및 스테이지드 롤아웃을 계획하고 있습니다. __CAPGO_KEEP_3__을 __CAPGO_KEEP_3__과 연결하여 구현 세부 사항을 알아보십시오. __CAPGO_KEEP_3__을 사용하여 구현 세부 사항을 알아보십시오. __CAPGO_KEEP_3__을 사용하여 구현 세부 사항을 알아보십시오. __CAPGO_KEEP_4__ 테스트 솔루션을 사용하여 베타 테스트를 진행하십시오. __CAPGO_KEEP_0__ __CAPGO_KEEP_3__ __CAPGO_KEEP_3__ Beta 테스트 솔루션의 제품 워크플로우에 대해 버전 목표 솔루션 버전 목표 솔루션의 제품 워크플로우에 대해, 그리고 Capgo 환경 최적화: 단일 모바일 앱 ID로 스테이징 Capgo 환경 최적화: 단일 모바일 앱 ID로 스테이징의 실제 상황에 대해