채널

설치

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 오버라이드가 만료됩니다..
Cloud override (Dashboard or Public API)Cloud override (Dashboard or Public API) : 기기 채널을 대시보드 또는 Public __CAPGO_KEEP_0__를 통해 변경하면 기기 ID에 대한 override를 기록합니다. 앱을 재설치하면 override가 지워지지 않습니다. override를 삭제하면 지워집니다. 동일한 90일 보존 정책이 적용됩니다.
Plugin setChannel() (local): setChannel() 현재 플러그인 버전에서, setChannel() 기기 채널을 저장합니다. 백엔드 검증 후에 저장됩니다. 대시보드 override가 아닙니다. 앱을 재설치하면 지워집니다. 다시 호출해야 하며, 채널을 유지하려면.
Capacitor config defaultChannel (test build default): 내부 / 베타 / 테스트 빌드의 경우 __CAPGO_KEEP_0__ 설정을 defaultChannel (기존 키) channel) in capacitor.config.* 이러한 테스트 장치가 프리 리리즈 채널 (예: )에서 시작되므로 absent일 경우 장치가 클라우드 기본값으로 진행됩니다. 프로덕션 빌드는 일반적으로 이 설정을 비워둡니다. beta, pr-123클라우드 기본 채널 (99%의 사용자 중 ~99%의 사용자에게 기본 전략)
: 모든 실제 사용자가 접속하는 메인 프로덕션 채널입니다. 새로운 장치가 강제, 오버라이드, 로컬 설정, 및 config 없이 접속하는 경우 이 채널을 사용합니다. 이 채널을 변경하면 즉시 모든 사용자에게 새로운 바이너리가 배포되거나 되돌아갑니다.왜 클라우드 기본 채널이 메인 경로인가: setChannel()원본 빌드 재빌드 또는 재배포 없이 즉시 배포 또는 되돌아갑니다. defaultChannel __CAPGO_KEEP_0__

__CAPGO_KEEP_1__ __CAPGO_KEEP_2__ __CAPGO_KEEP_3__

__CAPGO_KEEP_4__
iOS, Android, Electron의 모든 동작을 한 곳에서 관리하세요.
안전한 환경: 설정이 올바르고 기본값이 변경되기 전에 패키지가 존재하는지 확인할 수 있습니다.
변경 내역을 확인할 수 있습니다 (팀원은 UI 및 로그에서 변경 내역을 확인할 수 있습니다). Layer 위의 원칙 (강제 / 오버라이드 / 구성)은 예외 (단일 사용자 디버그, QA Switching, 테스트 빌드 기본값). 일반 사용자는 클라우드 기본값으로 흐릅니다.

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

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

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

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

Force them to another channel (console or Public API).
Change the cloud override in the dashboard or Public API.
콘솔 또는 Public __CAPGO_KEEP_0__에서 다시 변경합니다. 또는 setChannel() (현재 플러그인 버전에서 지역 할당).
현재 플러그인 버전에서 지역 할당을 제거/아카이브 하세요 (그 다음에 다음 체크 시 우선순위로 다시 돌아갑니다).
90일 후에 console/API override가 만료될 때까지 기다려 주세요.
앱을 재설치하세요. 이는 지역 할당을 지우지만 console/__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_1__1 이미지에서 클릭하면 모달 창이 열리고 새로운 채널을 만들 수 있습니다.

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

misconfigured는 무엇을 의미합니까?

채널의 설정이 유효하지 않으면 sometime이 발생합니다. 그 경우, 큰 경고가 나타나고 채널의 열은 Misconfigured 한 채널 이상의 채널에 대해. Yes 이것에 대해 더 알아보려면 여기

채널 삭제

웹 앱에서 채널을 삭제하려면 앱의 채널 탭을 열고 채널 행을 찾습니다. 채널 삭제 액션 삭제 삭제 채널 행의 삭제 아이콘을 표시하지 않으면, 해당 앱에 대한 삭제 권한이 없습니다. 권한이 없는 경우, 앱 관리자에게 삭제 권한을 부여하거나 __CAPGO_KEEP_0__ 키가 삭제 권한이 있는 채널을 삭제하십시오.

context channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

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

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

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

채널 탭

최소 권한 설정을 위해

대시보드현재 채널의 채널 버전과 설치 통계
정보: 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.
이력채널 설정 및 버전 변경
미리보기: 웹 애플리케이션 내에서 또는 네이티브에서 연결된 번들을 미리보는 기능입니다. 번들 미리보기 기능을 앱 정보 첫 번째.

정보 설정

섹션 제목입니다. 여기서 정보

탭을 유지하세요. 설정은 이 순서로 나타납니다: 첫 번째, 다운로드 채널의 기본값 다운로드 채널의 기본값은 상태 표시기이며 토글이 아닙니다. 활성화 이 채널은 새로운 기기에서 기본적으로 클라우드 기본 채널입니다. 클릭 앱 설정에서 관리 을 통해 기본 채널을 변경할 수 있습니다. 앱 정보. 플랫폼별 기본값(iOS, Android, Electron)을 변경하려면 같은 섹션을 참조하세요.

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

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

여섯 번째 설정입니다. Electron 일곱 번째 설정입니다.

여덟 번째 설정입니다. Disable auto downgrade under native 설정. 만약 이 값이 true라면 Native 버전으로부터 다운그레이드하는 것이 불가능합니다. 이는 앱 스토어나 플레이 스토어에 업로드한 버전을 가지고 channel 버전을 1로 설정하고 업데이트를 시도할 때 업데이트가 실패하는 것을 의미합니다. 1.2.0 여섯 번째는 1.1.0 설정입니다. 이 설정은 매우 복잡하며 더 많은 정보를 얻으려면

여덟 번째는 Disable auto update설정입니다. 만약 이 값이 true라면 이 채널에서 개발자 빌드가 업데이트를 다운로드할 수 있습니다. 만약 false라면 업데이트를 다운로드하는 모든 요청이 거부됩니다. 이 설정은 주로 테스트 목적으로 유용합니다. 업데이트 패키지

업데이트 패키지 Update package 업데이트 패키지 업데이트 패키지.

업데이트 패키지 Allow development build업데이트 패키지 prod 업데이트 패키지

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

10번째는 Allow Emulators. 만약 이 값이 false라면, Capgo는 에뮬레이터에서 오는 업데이트 요청을 거부합니다. 테스트 목적으로 주로 사용됩니다.

11번째는 Allow physical devices. 만약 이 값이 false라면, Capgo는 실제 휴대폰과 태블릿에서 오는 업데이트 요청을 거부합니다. 프로덕션 채널의 경우 이 값을 유지하세요.

12번째는 Allow devices to self dissociate/associate. 만약 이 값이 true라면, 메소드가 사용 가능합니다. 만약 이 값을 false로 설정하고 메소드를 호출하면 호출이 실패합니다. setChannel with this channel then the call will fail.

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

Capgo channel Devices tab showing the Override retention popover: console overrides expire after 90 days — __CAPGO_KEEP_0__는 콘솔 오버라이드가 90일 후에 만료되며, 마지막 기기 체크인도 그 시계를 초기화하지 않습니다. cleanup이 생존하는 assignment을 위해 설정하세요.

이것은 장치 재고 보존. 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: 재고는 장치가 90일 동안 API에 연결하지 않은 경우 장치를 제거합니다..

클린업을 오버라이드하면 장치가 활성 상태인 경우에도 매핑을 제거합니다.

콘솔 및 __CAPGO_KEEP_0__ 오버라이드도 90일 후에 만료됩니다. 패키지 업데이트 패키지 업데이트 채널을 열고 " 정보"

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 채널 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.

진보적 롤아웃

채널 정보 탭에는 진보적 롤아웃 섹션 롤아웃 대상 그리고 안정적인 기본값, 변경 배포 대상 변경, 적용 백분율, 및 동작 배포 완료, 배포 롤백, 배포 활성화, 배포 비활성화, 배포 중지, 및 배포 재개.

__CAPGO_KEEP_0__ 진보적 배포 읽기진보적 배포 전 / 자동 (권장) / 배포 대상; CLI --stable API target: "stable" __CAPGO_KEEP_0__ 이 채널은 진보적 배포를 사용합니다. bundle-link 대화 상자 및 안전한 워크플로우와 함께 관찰 페이지에서 계속 로그 인사이트.

Channels

Channels Channels Channels Channels Channels Channels Channels 베타 테스트 솔루션 베타 테스트 솔루션의 제품 워크플로우를 위한 버전 목표 솔루션 버전 목표 솔루션 및 Capgo 환경 최적화: 단일 모바일 앱 ID를 사용한 스테이징 Capgo 환경 최적화: 단일 모바일 앱 ID를 사용한 스테이징의 실제 적용