채널

설치

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

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

강제 장치 매핑: 장치 ID가 명시적으로 강제로 채널에 매핑되면 (채널 페이지의 장치 탭), 그 채널은 항상 승리합니다. 강제 매핑은 콘솔/API 오버라이드입니다. Capgo은 마지막 오버라이드 쓰기 후 90일이 지난 후 제거합니다. 콘솔 및 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 없이 접속하는 경우 이 채널을 사용합니다. 이 채널을 변경하면 즉시 모든 사용자에게 새로운 바이너리가 배포되거나 롤백됩니다.Why the setChannel()클라우드 기본 채널 defaultChannel 은 주된 경로입니다:

원본 빌드 재빌드나 재배포 없이 즉시 배포 또는 롤백이 가능합니다. (legacy key) ) in

so test devices start on a pre-release channel (e.g. ) If absent, the device will proceed to the cloud default. Production builds usually leave this unset.
iOS, Android, Electron을 관리하는 한 곳.
안전합니다: 기본 설정을 변경하기 전에 패키지가 존재하고 설정이 올바른지 확인할 수 있습니다.
변경 내역을 확인할 수 있습니다 (팀원은 UI / 로그에서 변경한 내용을 확인할 수 있습니다). Layer 위의 원칙 (강제 / 오버라이드 / 구성)은 예외 (단일 사용자 디버그, QA Switching, 테스트 빌드 기본값). 일반 사용자는 클라우드 기본값으로 흐릅니다.

클라우드 기본값을 변경하면 새로운 강제되지 않은 클라우드 오버라이드가 이미 존재하지 않는 일반 장치가 영향을 받습니다.

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

테스트 빌드가 포함되어 있고 나중에 클라우드 기본값을 defaultChannel: 'beta' 로 변경한다면, production을 통해 시작한 기기들은 beta 까지 유지될 것입니다. 더 높은 우선 순위 assignment이 적용되거나, defaultChannel없이 바이너리를 배포할 때까지. setChannel() 기기들은 현재 채널에서 유지될 것입니다. 만약:

콘솔 또는 Public __CAPGO_KEEP_0__에서 다른 채널로 강제한다.

클라우드 override를 대시보드 또는 Public API에서 변경한다.
Change the cloud override in the dashboard or Public API.
console에서 호출한다. 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는 무엇을 의미하는 것인가?

채널의 설정이 유효하지 않다면, 큰 경고가 나타나고 채널의 열은 Misconfigured 한 채널 이상이 잘못 설정되어 있습니다. 더 많은 정보를 알아보려면 Yes 여기 채널 삭제

채널 삭제

웹 앱에서 채널을 삭제하려면 채널을 삭제하는 방법을 참조하세요. 채널 채널을 삭제하려면 앱의 채널 탭을 열고 채널을 찾습니다. 채널 행에서 ‘액션’ 열을 클릭하고 ‘삭제’ 아이콘을 클릭한 후 확인 대화 상자에서 ‘삭제’를 클릭합니다. 삭제 채널 행의 삭제 아이콘을 클릭하면 삭제가 가능합니다. 삭제 아이콘을 볼 수 없다면, 해당 앱에 대한 삭제 권한이 없습니다. 권한을 부여받거나 삭제할 수 있는 키를 가진 __CAPGO_KEEP_0__ 키를 사용하여 채널을 삭제하십시오. 터미널 창

__CAPGO_KEEP_0__ channel.delete API

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

회사 및 앱에 바인딩된 앱 미리보기 키는 공개되지 않은 미리보기 채널과 함께 생성된 채널만 원자적으로 삭제할 수 있습니다. existing default/main 채널, 다른 미리보기 키의 채널, 또는 다른 키의 채널을 변경하거나 삭제할 수 없습니다. 자세한 내용은 channel delete <preview-channel> <app-id> --delete-bundle__CAPGO_KEEP_0__ 키 API Keys 채널 관리

제목: 채널 관리

채널 설정

__CAPGO_KEEP_0__

대시보드현재 채널의 채널 버전과 설치 통계를 표시합니다.
정보채널 설정이 아래에 나열되어 있으며, 점진적인 출시 및 테스트 업데이트 API도 포함됩니다.
디바이스콘솔 또는 Public API에서 만든 강제 매핑만 표시합니다. 채널에 현재 연결된 모든 디바이스를 표시하지는 않으며, 이 채널을 사용한 디바이스도 표시하지 않습니다. setChannel()콘솔 및 __CAPGO_KEEP_0__ 오버라이드가 만료됩니다. Console and API overrides expire.
이 채널의 설정과 버전 변경 사항을 표시합니다.미리보기
__CAPGO_KEEP_0__: 웹 앱 내에서 링크된 번들을 미리보는 기능입니다. 번들 미리보기 기능을 앱 정보 첫 번째.

정보 설정

여기서 머물러 있습니다. 정보 탭입니다. 설정은 이 순서로 나타납니다:

첫 번째, 기본 다운로드 채널 기본 다운로드 채널은 상태 표시줄입니다. 토글이 아닙니다. 활성 이 채널은 새로운 기기에서 기본적으로 클라우드 기본 채널입니다. 클릭 앱 설정에서 관리 을 클릭하여 기본 채널을 변경하세요. 앱 정보. 플랫폼별 기본 설정(iOS, Android, Electron)을 확인하려면 동일한 섹션을 참조하세요.

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

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

sixth is the setting. If this is false then Electron apps will not be allowed to download updates from this channel. Electron sixth is the setting. If this is false then Electron apps will not be allowed to download updates from this channel.

sixth is the setting. If this is false then Electron apps will not be allowed to download updates from this channel. Disable auto downgrade under native 설정. 만약 이 값이 true라면 Native 버전으로부터 다운그레이드하는 것이 불가능합니다. 이는 앱 스토어나 플레이 스토어에 업로드한 버전을 가지고 있고, 채널 버전을 1로 설정하고 업데이트를 시도하면 업데이트가 실패할 수 있습니다. 1.2.0 여섯 번째는 1.1.0 이 설정은 매우 복잡하며, 더 많은 정보를 얻으려면

여덟 번째는 Disable auto update설정입니다. 이 설정은 장치가 전체 ZIP 파일, 변경된 파일의 델타, 또는 두 가지 모두 다운로드할지 선택합니다. 업데이트 패키지

아홉 번째는 Update package 설정입니다. 만약 이 값이 true라면 개발자 빌드가 이 채널에서 업데이트를 다운로드할 수 있습니다. 만약 false라면 업데이트 요청이 false로 설정되어 있으면 거부됩니다. 이 설정은 주로 테스트 목적으로 유용합니다. __CAPGO_KEEP_0__.

__CAPGO_KEEP_0__ Allow development build__CAPGO_KEEP_0__ 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

__CAPGO_KEEP_0__ 정보 __CAPGO_KEEP_0__ 테스트 업데이트 APICapgo은 이 채널의 샘플 장치에 대한 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 쓰기 후 마지막으로 override가 삭제됩니다. 마지막 기기 체크인도 그 시계를 초기화하지 않습니다. cleanup을 생존시키려면 assignment을 설정하세요. defaultChannel 설정에서 Capacitor config (재설치 시 살아남음, 새로운 바이너리 변경을 위해 다시 호출해야 함) 또는 앱에서 호출하세요 (90일 cleanup을 피하지만 재설치 시 삭제되므로 앱에서 다시 호출해야 함). setChannel() __CAPGO_KEEP_0__ 채널 기기 탭에 Override 보관 기간 팝오버: 콘솔 override가 90일 후 만료됩니다. setChannel() 채널 기기 탭의 보관 기간. 동일한 알림이 채널에 기기 ID를 강제로 할당할 때 나타납니다.

Capgo channel Devices tab showing the Override retention popover: console overrides expire after 90 days — Override retention on the channel Devices tab. The same notice appears when you force a device ID onto the channel.

이것은 장치 재고 보존. Inventory removes devices that have not connected to Capgo for 90 days. Override cleanup removes the mapping even if the device is still active. Full detail: Inventory는 장치가 90일 동안 API에 연결하지 않은 경우 장치를 제거합니다. Override cleanup은 장치가 활성 상태일지라도 매핑을 제거합니다. 자세한 내용은 다음과 같습니다:.

콘솔 및 __CAPGO_KEEP_0__ override는 90일 후 만료됩니다.

‘패키지 업데이트’라는 제목을 가진 섹션 __CAPGO_KEEP_0__ 채널을 열고 ‘정보’ 탭에서 유지하세요. 패키지 업데이트 자동 업데이트 비활성화 목록의 설정 아래에 있습니다. 패키지 업데이트 드롭다운 메뉴는 __CAPGO_KEEP_0__ 채널에서 Zip 및 delta, Zip만, Delta만, Zip만 빌트인, Delta만 빌트인으로 표시됩니다.

Capgo이 이 채널의 장치가 업데이트를 확인할 때 어떤 것을 보냅니까? 이 채널의 장치가 업데이트를 확인할 때 Capgo이 보낸 것을 변경하지 마세요. Zip 및 delta Zip 및 delta를 사용하지 않아야 하는 경우에만 사용하세요.

콘솔에 표시되는 레이블	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 업데이트 전에 사용합니다. from builtin 업데이트 모드를 사용할 때, 첫 번째 업데이트는 스토어 빌드에서 zip-only 또는 delta-only가 되고, 나중에 업데이트는 두 가지 모두를 사용할 수 있습니다.

Capgo은 zip-only 채널과 delta-only 배포를 pair하지 않습니다. 반대도 마찬가지입니다. 콘솔, CLI, 및 채널 Capgo은 저장을 거부하고 업로드한 패키지를 다시 업로드하거나 모드를 변경하라고 알려줍니다. 채널 API 콘솔, __CAPGO_KEEP_1__, 및 채널 __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.

진보적 롤아웃

채널 정보 채널 정보 탭에는 진보적 롤아웃 진보적 롤아웃 제어는 __CAPGO_KEEP_0__ 채널에 나타납니다.

Progressive rollout controls in a Capgo channel — 진보적 롤아웃 제어는 __CAPGO_KEEP_0__ 채널에 나타납니다.

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

채널에서 계속

Capgo 릴리스 채널 기능을 사용하는 경우 채널 채널 채널 채널 채널 채널 Beta 테스트 솔루션 Beta 테스트 솔루션의 제품 워크플로우에 대해 버전 목표 솔루션 버전 목표 솔루션 및 Capgo 환경 최적화: 단일 모바일 앱 ID로 스테이징 Capgo 환경 최적화: 단일 모바일 앱 ID로 스테이징의 실제 맥락에 대해