채널

설치

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

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

강제 장치 매핑: 장치 ID가 명시적으로 강제로 채널에 매핑되면 (채널 페이지의 장치 tab on the channel page), that channel always wins. Forced mappings are console/API overrides. Capgo removes them 90 days after the last override write. See 콘솔 및 API 오버라이드가 만료됩니다..
Cloudflare override (Dashboard or Public API): 기기 채널을 대시보드 또는 Public API를 통해 변경하면 기기 ID에 대한 override가 기록됩니다. 앱을 재설치하면 override가 지워지지 않습니다. override를 삭제하면 지워집니다. 동일한 90일 보존 정책이 적용됩니다. Plugin (local)
: 현재 플러그인 버전에서, setChannel() 스토어는 백엔드 검증 후 기기에서 채널을 저장합니다. 대시보드 override가 아닙니다. 앱을 재설치하면 지워집니다. 앱이 다시 채널을 호출해야 합니다.__CAPGO_KEEP_0__ config setChannel() (test build default) setChannel() : 내부 / 베타 / 테스트 빌드의 경우 __CAPGO_KEEP_0__ 설정을 통해
Capacitor defaultChannel __CAPGO_KEEP_0____CAPGO_KEEP_0__ defaultChannel 기존 키 (legacy key) channel) in capacitor.config.* 이러한 테스트 장치가 프리 리리즈 채널 (예: )에서 시작되므로 absent일 경우 장치가 클라우드 기본값으로 진행됩니다. 일반적으로 프로덕션 빌드는 이 설정을 비워둡니다. beta, pr-123클라우드 기본 채널 (99%의 사용자에게 주된 전략)
: 모든 실제 사용자가 접속하는 주된 프로덕션 채널입니다. 새로운 장치가 강제, 오버라이드, 로컬 설정, 또는 config 없이 접속하는 경우 이 채널을 사용합니다. 이 채널을 변경하면 즉시 모든 사용자에게 새로운 바이너리가 배포되거나 롤백됩니다.클라우드 기본 채널이 주된 경로인 이유: setChannel()원격 배포 또는 롤백이 재빌드나 재배포 없이 즉시 수행됩니다. defaultChannel __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__: 더 안전합니다. 사용자가 기본 설정을 변경하기 전에 패키지와 설정이 올바른지 확인할 수 있습니다.
__CAPGO_KEEP_0__: 변경 사항을 추적할 수 있습니다(팀원은 UI 및 로그에서 변경 사항을 확인할 수 있습니다). Layer 위의 원칙(강제, 오버라이드, 구성)은 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__: 디버그 단일 사용자, QA Switching, 테스트 빌드 기본값입니다. 일반 사용자는 클라우드 기본값으로 흐릅니다.

__CAPGO_KEEP_0__: 클라우드 기본값을 변경하면 __CAPGO_KEEP_0__: 새로운 __CAPGO_KEEP_0__: 강제되지 않은 __CAPGO_KEEP_0__: 이미 클라우드 오버라이드가 있는 __CAPGO_KEEP_0__

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
앱 수준이 없는 경우 defaultChannel 정의되지 않습니다.

테스트 빌드가 클라우드 기본값과 함께 배포되면 defaultChannel: 'beta' 그리고 나중에 클라우드 기본값을 변경하면 production시작한 기기들이 beta config를 통해 클라우드 기본값을 변경한 기기들은 defaultChannelconfig 값이 삭제되지 않습니다. 그 값은 새로운 바이너리가 배포될 때까지 유지됩니다. setChannel() 기기들은 현재 채널에서 유지됩니다. 다음의 경우에만 변경됩니다.

콘솔 또는 Public __CAPGO_KEEP_0__에서 강제로 다른 채널로 변경합니다.

클라우드 오버라이드 값을 클라우드 대시보드 또는 Public API에서 변경합니다.
Change the cloud override in the dashboard or Public API.
appflow_migration_step2 setChannel() 현재 플러그인 버전에서 지역 할당.
채널에서 제거/아카이브 (다음 체크 시 우선순위 다시 적용).
콘솔/API override 90일 후 만료까지 기다려보세요.
앱을 재설치하면 지역 할당이 초기화되지만 콘솔/__CAPGO_KEEP_0__ override는 초기화되지 않습니다. setChannel() assignment but not a console/API override.

주의: 설정을 변경하면 새로운 바이너리가 필요합니다. 테스트/QA 용으로만 사용하고 일반적인 프로덕션 제어로 사용하지 마세요.

__CAPGO_KEEP_0__ config 예시 defaultChannel __CAPGO_KEEP_0__ config 예시

Capacitor.config.ts

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

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

채널 관리

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

채널 목록의 하단 오른쪽에 있는 플러스 버튼을 확인할 수 있습니다.

__CAPGO_KEEP_0__1 이미지를 클릭하면 모달 창이 열리고 새로운 채널을 만들 수 있습니다.

그 다음에 클릭하면 Add 새로운 채널이 목록에 나타납니다.

채널이 잘못 설정된다는 것은 무엇을 의미합니까?

채널의 설정이 유효하지 않을 때가 있습니다. 그 경우 큰 경고가 나타나고 채널의 열은 Misconfigured 채널 중 하나 이상이 잘못 설정되어 있습니다. 이것에 대해 더 알아보려면 Yes 여기 채널 삭제

잘못 설정된 채널이란 무엇인가요?

웹 앱에서 채널을 삭제하려면 채널을 삭제하는 방법을 참조하세요. 채널 채널을 삭제하려면 앱의 채널 탭을 열고 채널 목록에서 채널을 찾습니다. 채널 목록에서 채널을 선택한 후 액션 열에서 삭제 아이콘을 클릭하고 삭제를 확인합니다. 액션 삭제 채널을 삭제하려면 앱의 채널 탭을 열고 채널 목록에서 채널을 찾습니다. 채널 목록에서 채널을 선택한 후 액션 열에서 삭제 아이콘을 클릭하고 삭제를 확인합니다. 채널 삭제 아이콘

삭제 아이콘을 보이지 않으면 앱에 대한 삭제 권한이 없습니다. 권한이 있는 사용자에게 삭제 권한을 부여하거나 삭제할 수 있는 키가 있는 채널을 삭제하세요.

터미널 창 channel.delete API

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

회사 및 앱에 바인딩된 앱 미리보기 키는 공개되지 않은 미리보기 채널과 함께 생성된 채널과 번들을 원자적으로 삭제할 수만 있습니다. existing default/main 채널, 다른 미리보기 키의 채널, 또는 다른 키의 번들을 변경하거나 삭제할 수 없습니다. __CAPGO_KEEP_0__ 키 channel delete <preview-channel> <app-id> --delete-bundle에 대한 최소 권한 설정을 참조하십시오. API Keys 채널 관리

채널 이름을 클릭하여 채널 페이지를 열 수 있습니다. 탭이 있는 전체 페이지입니다. 모달이 아닙니다.

채널 탭

for the least-privilege setup.

대시보드현재 채널의 채널 버전과 설치 통계
정보: Channel settings listed below, plus progressive rollout and Test Update API.
채널 설정, 점진적 배포 및 테스트 업데이트: Forced mappings created from the console or Public API only. It does not list every device currently on the channel, and it does not list devices that used setChannel()콘솔 또는 Public에서만 생성된 강제 매핑만 표시합니다. 채널에 현재 등록된 모든 장치나, 이 채널을 사용한 장치 목록은 표시하지 않습니다. Console and API overrides expire.
이력채널 설정 및 버전 변경
미리보기: 웹 애플리케이션 내에서 및 네이티브로 연결된 번들을 미리보는 기능입니다. 번들 미리보기 기능을 앱 정보 처음에

정보 설정

이 탭에 머물러 있습니다. 설정은 이 순서로 나타납니다: 첫째, 다운로드 채널의 기본 설정

다운로드 채널의 기본 설정은 상태 표시줄입니다. 설정을 끄는 스위치가 아닙니다. 활성화 Active first. 이 채널은 새로운 기기에서 기본적으로 클라우드 기본 채널입니다. 클릭 앱 설정에서 관리 기본 채널을 변경하려면 앱 정보. 플랫폼별 기본값(iOS, Android, Electron)을 보려면 같은 섹션을 참조하세요.

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

네 번째 설정입니다. 이 설정이 false라면 Electron 앱은 이 채널에서 업데이트를 다운로드할 수 없습니다. Android 다섯 번째 설정입니다.

__CAPGO_KEEP_0__ Electron __CAPGO_KEEP_1__

__CAPGO_KEEP_2__ Disable auto downgrade under native 설정. 만약 이 값이 true라면 Native 버전으로부터 다운그레이드하는 것이 불가능합니다. 이는 앱 스토어나 플레이 스토어에 업로드한 버전을 가지고 channel 버전을 설정하려고 할 때 업데이트가 실패하는 것을 의미합니다. 1.2.0 버전을 앱 스토어나 플레이 스토어에 업로드한 경우 1.1.0 then

여섯 번째는 Disable auto update설정입니다. 이 설정은 매우 복잡하며 더 자세한 정보는 여기

일곱 번째는 Update package 설정입니다. 이 설정은 장치가 전체 zip, 변경된 파일의 델타, 또는 두 가지를 다운로드할지 선택합니다. 업데이트 패키지.

여덟 번째는 Allow development build설정입니다. 만약 이 값이 true라면 개발자 빌드가 이 채널에서 업데이트를 다운로드할 수 있습니다. 만약 false라면 업데이트 요청이 거절됩니다. 이 설정은 주로 테스트 목적으로 사용됩니다. prod __CAPGO_KEEP_0__

9 번째는 Allow production build. 이 값이 false 이면 이 채널에서 업데이트를 받지 못하는 프로덕션(스토어) 빌드는 생성되지 않습니다. 실제 사용자에게 서비스를 제공하는 채널의 경우 이 값을 유지하세요.

10 번째는 Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

11 번째는 Allow physical devices. If this is false then Capgo will reject update requests from real phones and tablets. Leave this on for production channels.

12 번째는 Allow devices to self dissociate/associate. 이 값이 true 이면 메소드가 사용 가능합니다. 이 값을 false 로 설정하고 이 채널에서 메소드를 호출하면 호출이 실패합니다. setChannel setChannel

업데이트 테스트 API

하단에 위치한 정보 탭을 확장 업데이트 테스트 API. Capgo은 이 채널의 샘플 기기에서 curl 명령어를 보여줍니다. /updates 변경 사항은 캐싱으로 인해 최대 60초가 걸릴 수 있습니다. 채널이 테스트되지 못하는 경우 콘솔에서 경고가 표시됩니다: 채널은 최소한 iOS 또는 Android 중 하나의 플랫폼, 프로덕션 빌드, 물리적 기기, 또는 기본 다운로드 채널 또는 기기 자체 할당을 허용해야 합니다.

Changes can take up to 60 seconds to show in the API because of caching. If the channel cannot be tested, the console warns you: the channel needs at least one platform (iOS or Android), production builds, physical devices, and either to be the default download channel or to allow device self-assignment.

업데이트 알림 전송

__CAPGO_KEEP_0__ 업데이트 알림 전송. 이로써 채널에 있는 기기들이 새로운 패키지를 확인하기 위해 현재 상태를 확인합니다. Android 및 iOS 푸시 인증서를 앱 알림 탭에서 먼저 설정해야 합니다.

콘솔 및 API override가 만료됩니다.

강제 매핑 및 Dashboard/Public API 채널 override가 삭제됩니다. 90일 마지막 override 쓰기 후에 만료됩니다. 마지막 기기 체크인도 그 시계를 초기화하지 않습니다. cleanup이 생존하는 assignment을 위해, __CAPGO_KEEP_0__ config (재설치 시 생존, 새로운 바이너리 변경을 위해 필요) 또는 앱에서 호출하세요 (90일 cleanup을 피하지만 재설치 시 지워지므로 앱은 다시 호출해야 합니다). defaultChannel Capacitor 채널 기기 탭에 오버라이드 보관 기간 팝오버: 콘솔 오버라이드가 90일 후에 만료됩니다. setChannel() 채널 기기 탭의 오버라이드 보관 기간. 동일한 알림이 채널에 기기 ID를 강제로 할당할 때 나타납니다. setChannel() __CAPGO_KEEP_0__ 채널 기기 탭에 오버라이드 보관 기간 팝오버: 콘솔 오버라이드가 90일 후에 만료됩니다.

Capgo 채널 기기 탭에 오버라이드 보관 기간 팝오버: 콘솔 오버라이드가 90일 후에 만료됩니다. — __CAPGO_KEEP_0__ 채널 기기 탭에 오버라이드 보관 기간 팝오버: 콘솔 오버라이드가 90일 후에 만료됩니다.

이것은 장치 재고 보존에서 분리됩니다. 재고는 장치가 90일 동안 Capgo에 연결하지 않은 경우 장치를 제거합니다. 오버라이드 클린업은 장치가 여전히 활성화되어도 매핑을 제거합니다. 자세한 내용은 다음과 같습니다: 콘솔 및 API 오버라이드가 90일 후에 만료됩니다.

패키지 업데이트

__CAPGO_KEEP_0__ 채널을 열고 "정보" 탭에 머물러 있습니다. 패키지 업데이트 는 "자동 업데이트 비활성화" 아래 설정 목록에 있습니다. __CAPGO_KEEP_0__ 채널의 패키지 업데이트 드롭다운 메뉴는 Zip 및 delta, Zip만, Delta만, Zip만 빌트인, Delta만 빌트인으로 표시됩니다. 업데이트

Update package dropdown on a Capgo channel showing Zip and delta, Zip only, Delta only, Zip only from builtin, and Delta only from builtin — 채널 정보 탭에서 패키지 업데이트를 업데이트하세요. 새로운 채널은 기본적으로 Zip 및 delta입니다.

Capgo이 이 채널의 장치가 업데이트를 확인할 때 어떤 것을 보낼지 결정하는 설정입니다. 이 채널의 장치가 업데이트를 확인할 때 Capgo이 보낼 것을 변경하지 마세요. Zip 및 delta 이 채널의 장치가 업데이트를 확인할 때 __CAPGO_KEEP_0__이 보낼 것을 변경하지 마세요.

콘솔에 표시되는 레이블	CLI / API 값	장치가 다운로드하는 것
Zip 및 delta	`all`	Zip과 delta가 모두 존재할 때 전체 zip과 delta를 다운로드합니다. 이게 기본 설정입니다.
Zip만	`zip`	전체 zip만 다운로드합니다.
delta만	`delta`	변경된 파일만. 빌드에 적용할 수 없는 플러그인은 여전히 zip을 받습니다.
스토어 빌드 내에서만 zip만	`zip_from_builtin`	디바이스가 아직 스토어 빌드에 남아 있는 동안에만 zip만. 첫 번째 라이브 업데이트 후, Capgo은 다시 zip과 델타를 제공합니다.
스토어 빌드 내에서만 델타만	`delta_from_builtin`	디바이스가 아직 스토어 빌드에 남아 있는 동안에만 델타만. 첫 번째 라이브 업데이트 후, Capgo은 다시 zip과 델타를 제공합니다.

빌트인 앱 스토어 또는 플레이 스토어 빌드 내에 포함된 웹 자산입니다. Capgo 업데이트 전에 빌드된 것입니다. 첫 번째 업데이트가 스토어 빌드에서 나올 때 zip-only 또는 delta-only 모드를 사용할 수 있습니다. 이후 업데이트에서는 두 가지 모두 사용할 수 있습니다. from builtin __CAPGO_KEEP_0__은 zip-only 채널과 delta-only 배포를 pair하지 않습니다. 콘솔, __CAPGO_KEEP_1__, 및 채널 __CAPGO_KEEP_0__은 저장을 거부하고 업로드해야 할 패키지를 업로드하거나 모드를 변경하라고 알려줍니다.

Capgo will not pair a zip-only channel with a delta-only bundle, or the reverse. The console, CLI, and 콘솔, __CAPGO_KEEP_1__, 및 채널 API은 저장을 거부하고 업로드해야 할 패키지를 업로드하거나 모드를 변경하라고 알려줍니다. 이 값을 __CAPGO_KEEP_0__에서 동일한 값으로 설정할 수 있습니다. 채널은 이미 존재해야 합니다:

CLI

npx @capgo/cli@latest channel set production com.example.app --update-package zip

허용되는 값: all, zip, delta, zip_from_builtin, delta_from_builtin.

진보적 롤아웃

채널 정보 채널 정보 탭에는 진보적 롤아웃 진보적 롤아웃을 설정하려면 목표 버전을 선택하고 퍼센티지와 결정 캐시 지속 시간을 선택한 다음 롤아웃을 활성화하세요. 동일한 섹션에서 노출을 일시 중단하거나 다시 시작하거나 목표 버전을 안정 버전으로 승격하거나 롤백하거나 자동 일시 중단, 롤백 또는 알림을 구성할 수 있습니다. 실패 신호가 임계값을 넘어갈 때 알림이 발생합니다.

읽기 진보적인 롤아웃 Channels에서 계속 진행하기 전에 하나를 활성화하기 전에 설명합니다. 그것은 스틱이 코호트, 안전한 백분율 변경, 그리고 자동 일시 정지 동작을 설명합니다.

Channels에서 계속 진행하기

Channels을 사용하여 Channels 채널 라우팅과 단계별 롤아웃을 계획하고, Channels과 연결합니다. Channels Channels Channels Channels Beta Testing Solution Beta Testing Solution을 위한 제품 워크플로우 Version Targeting Solution Version Targeting Solution을 위한 제품 워크플로우 및 Capgo 환경 최적화: 단일 모바일 앱 ID를 사용한 스테이징 Capgo 환경 최적화: 단일 모바일 앱 ID를 사용한 스테이징을 위한 실제 상황.