채널

설치

Capgo이 채널을 선택하는 방법 (우선 순위)

Capgo이 업데이트 요청을 받을 때 사용할 채널은 다음 순서(우선 순위가 가장 높음)로 결정됩니다.:

강제 장치 매핑: 장치 ID가 명시적으로 강제로 채널에 매핑되면 (채널 설정 내의 강제 장치 리스트를 참조하십시오.), 그 채널은 항상 승리합니다.
Cloudflare override (생성된 setChannel() 또는 Webapp 액션): 호출) setChannel (또는 장치의 채널을 변경하는 데스크톱에서) 장치 ID와 관련된 클라우드에 영구적인_OVERRIDE를 기록합니다. 이 Override는 강제 매핑 후에 기본값보다 먼저 참조됩니다. 앱을 재설치하면 하지 않습니다. 을 삭제하면.
Capacitor config defaultChannel (테스트 빌드 기본값): 내부 / 베타 / 테스트 빌드의 경우 defaultChannel (기존 키 channel)에서 capacitor.config.* 테스트 장치가 프리 리리즈 채널에서 시작되도록 설정할 수 있습니다 (예: ). 이 설정이 없으면 장치는 클라우드 기본값으로 진행됩니다. 프로덕션 빌드는 일반적으로 이 설정을 비워둡니다. beta, pr-123(기존 키
CloudflareCloud Default Channel (primary strategy for ~99% of users) defaultChannel : The main production channel virtually all real users land on. Any new device without a force, without an override, and without a config

uses this. Changing it rolls out (or rolls back) for everyone in seconds—no new binary. Why the cloud default

is the main path:
Instant rollout or rollback without rebuilding or re‑publishing native binaries.
One place to manage iOS, Android, and Electron behavior.
Safer: you can confirm bundles exist and settings are correct before switching default. Auditable changes (team members can see who changed what in the UI / logs). Design principle: Layers above (force / override / config) are exceptions (debug single user, QA switching, test build defaults). Normal users flow to the cloud default.

클라우드 기본값을 클라우드 기본값 클라우드 기본값을 변경하면 새로운 일반 장치에 대해:

강제로 설치되지 않은
이미 클라우드 오버라이드가 설정된
앱 수준에서 defaultChannel 정의된

테스트 빌드가 defaultChannel: 'beta' 클라우드 기본값을 production변경한 후에 시작한 beta via config에서 설정된 채널은 __CAPGO_KEEP_0__ config example에서 설명한 대로 다음 조건이 만족될 때까지 유지됩니다: (a) 채널을 __CAPGO_KEEP_0__ config example에서 설명한 대로 override합니다. setChannel()(b) 강제로 채널을 변경하거나 (c) 기기 항목을 삭제합니다.

기기는 현재 채널에서 유지됩니다. 다음 조건이 만족될 때까지 유지됩니다:

강제로 다른 채널로 변경합니다.
Call setChannel() __CAPGO_KEEP_0__ config example
(cloud override를 생성/대체하거나) 또는 대시보드에서 수동으로 변경합니다.

현재 채널에서 제거/아카이브합니다. (다음 체크 시 다시 우선순위에 따라 선택됩니다.)

플랫폼별로 채널이 비활성화되어 있고, 일반적으로 선택되었을 경우, 선택은 이를 생략하고 다음 규칙으로 넘어갑니다. defaultChannel 주의:

Capacitor config example

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    Capgo: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

대시보드 기본값을 나중에 변경하면 production, 기존에 다른 채널을 통해 설정된 기기(설정, 오버라이드, 강제)가 자동으로 채널을 변경하지 않습니다. 새로운 기기(또는 오버라이드/강제를 취소한 기기)만 새 채널을 인식합니다.

채널 관리

먼저 채널 페이지를 살펴보겠습니다. 앱을 클릭하고 채널 탭을 클릭하여 채널 목록 채널 생성.

__CAPGO_KEEP_0__.config.ts

아래 오른쪽에 있는 플러스 버튼을 클릭하면1 이미지에서 보듯이,

새로운 채널 Add 그리고 클릭하면

채널 생성 후

채널 설정이 잘못된 경우가 있습니다. Misconfigured 잘못된 채널 설정이 있을 경우 큰 경고 메시지가 나타나고 Yes 한 개 이상의 채널이 잘못된 채널 설정을 가지고 있을 경우에 나타납니다. 더 알아보기 여기

채널 삭제

웹 앱에서 채널을 삭제하려면 앱의 채널 탭을 열고 채널 목록에서 채널을 찾습니다. 채널 채널 탭에서 앱의 채널 목록을 찾고 채널을 삭제하려면 채널 행을 클릭합니다. 액션 액션 삭제 삭제

채널 행의 액션 열에서 삭제 아이콘을 클릭하고 확인 대화 상자에서 삭제를 클릭합니다.

삭제 아이콘을 볼 수 없다면, 계정에 삭제 권한이 없습니다. channel.delete 해당 앱에 대한 권한을 요청하세요. 조직 또는 앱 관리자에게 역할을 부여하여 채널을 삭제할 수 있는 권한을 요청하거나, API 키가 권한이 있는 채널을 삭제하세요.

npx @capgo/cli@latest channel delete <channel-name> <app-id>

조직 및 앱에 결합된 앱 미리보기 키는 공개 미리보기 채널과 함께 생성된 비공개 미리보기 채널만 원자적으로 삭제할 수 있습니다. 기존 기본/주 채널, 다른 미리보기 키의 채널, 또는 다른 키의 배포를 변경하거나 삭제할 수 없습니다. 자세한 내용은 channel delete <preview-channel> <app-id> --delete-bundle__CAPGO_KEEP_0__ 키 API Keys 권한이 가장 적은 설정을 위해

채널 관리

채널 이름을 클릭하면 채널 설정을 관리할 수 있는 모달이 열립니다.3 __CAPGO_KEEP_0__

채널 설정 페이지에는 채널의 모든 구성 옵션이 포함되어 있습니다. 각 설정에 대해 설명해 보겠습니다.

첫 번째는 Default channel toggle입니다. 활성화되면 이 채널은 새로운 기기에 기본 채널이 됩니다. 기본 채널에 대한 자세한 설명과 iOS, Android 및 Electron에 대한 플랫폼별 기본 채널 설정 방법을 포함하여 기본 채널이 어떻게 작동하는지 알아보려면 기본 채널 구성 섹션을 참조하십시오.

두 번째는 IOS 설정입니다. 이 설정은 비교적 간단합니다. 이 값이 false라면 iOS 기기는 이 채널에서 업데이트를 다운로드할 수 없습니다.

세 번째는 Android 설정입니다. 이 설정은 IOS와 유사합니다. 이 값이 false라면 Android 기기는 이 채널에서 업데이트를 다운로드할 수 없습니다.

네 번째는 Electron 설정입니다. IOS 그리고 Android이 설정이 거짓이라면 Electron 앱은 이 채널에서 업데이트를 다운로드할 수 없습니다.

다섯 번째는 Disable auto downgrade under native 설정입니다. 1.2.0 이 설정이 참이라면 Native 버전으로부터 다운그레이드할 수 없습니다. 1.1.0 이것은 앱 스토어나 플레이 스토어에 업로드한

버전을 Disable auto update채널 버전으로 설정하고 업데이트(다운그레이드)를 시도할 때 업데이트가 실패하는 것을 의미합니다. 여섯 번째는

입니다. 이 설정은 매우 복잡하며 더 자세한 정보는 여기서 확인할 수 있습니다. Allow development build. 이 설정이 true이면 개발자용 빌드가 이 채널에서 업데이트를 다운로드할 수 있습니다. 그렇지 않으면 업데이트를 요청하는 모든 요청이 false로 설정된 경우 거부됩니다. prod 이 설정은 테스트 목적으로 주로 유용합니다.

일곱 번째는 false로 설정된 경우 __CAPGO_KEEP_0__가 에뮬레이터에서 오는 모든 업데이트를 요청을 거부합니다. 테스트 목적으로 주로 유용합니다. Allow Emulators여덟 번째는 true로 설정된 경우 Capgo가 에뮬레이터에서 오는 모든 업데이트를 요청을 허용합니다.

네 번째는 false로 설정된 경우 __CAPGO_KEEP_0__가 에뮬레이터에서 오는 모든 업데이트를 요청을 거부합니다. Allow devices to self associate채널을 설정하는 setChannel 메소드가 사용 가능합니다. 채널을 설정하는 setChannel 메소드를 호출할 때 false로 설정된 경우 호출이 실패합니다. 진보적인 롤아웃 진보적인 롤아웃 method with this channel then the call will fail.

Progressive rollouts

채널 정보 탭에는 진보적 배포 섹션입니다. 목표 배포를 설정하고 백분율과 결정 캐시 지속 시간을 선택한 다음 배포를 활성화합니다. 동일한 섹션에서 노출을 일시 중단하거나 재개하거나 목표를 안정화하거나 역전하거나 자동 일시 중단, 역전 또는 알림을 구성할 수 있습니다. 실패 신호가 임계값을 넘어갈 때.

채널의 정보 탭에 Capgo 채널에서 진보적 배포 제어 — 진보적 배포 제어는 채널 정보 탭의 상단에 나타납니다.

읽기 진보적 배포 배포를 활성화하기 전에 읽어보세요. 그것은 스틱이 코호트, 안전한 백분율 변경 및 자동 일시 중단 동작을 설명합니다.

채널에서 계속

Channels 기능을 사용 중이라면 채널 채널을 계획하고 단계별 롤아웃을 위해 연결하세요 채널 채널의 구현 세부 정보 채널 Beta 테스트 솔루션 Beta 테스트 솔루션의 제품 워크플로우 버전 대상 솔루션 버전 대상 솔루션의 제품 워크플로우 __CAPGO_KEEP_0__ 환경 최적화: 단계별 모바일 앱 ID Capgo 실제 환경에 대한 Capgo 컨텍스트에서 Best Practices: Staging with One Mobile App ID.