채널

📢 Capgo Cloud에서 앱 업데이트를 위한 배포 채널을 관리하여, 업데이트 방법을 장치에 전달하는 방법을 제어합니다.

➕ ➕ 추가

터미널 창 a

npx @capgo/cli@latest channel add

앱 배포를 위한 새로운 채널을 Capgo Cloud에서 관리할 수 있는 업데이트 전달을 위해 생성합니다.

예시:

npx @capgo/cli@latest channel add production com.example.app --default

옵션:

Param	타입	설명
-d	boolean	기본 채널로 설정
--self-assign	boolean	이 장치가 이 채널에 자동 ASSIGN 할 수 있도록 허용합니다.
-a	string	API 키를 사용하여 계정에 연결합니다.
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	사용자 지정 Supabase anon 키 (자체 호스팅용)

🗑️ 삭제

Alias: d

npx @capgo/cli@latest channel delete

🗑️ Capgo 채널을 삭제하고, 옵션적으로 관련된 번들을 삭제하여 자원 사용량을 줄일 수 있습니다.

예시:

npx @capgo/cli@latest channel delete production com.example.app

Options:

옵션:	파라미터	타입
-a	string	API 계정에 연결하는 키
-a	boolean	__CAPGO_KEEP_0__ 키를 사용하여 계정에 연결합니다. (Account Link Key).
—found-if-not-success	boolean	채널이 발견되지 않으면 성공
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	사용자 지정 Supabase anon 키 (자체 호스팅용)

주의

기본적으로 앱과 연결된 앱 미리보기 API 키와 --delete-bundle 기본적으로 공개되지 않은 PR 미리보기 채널에만 사용하십시오. 명령어는 좁은 원자적 청소 경로를 사용합니다: 채널과 연결된, 공유되지 않은 __CAPGO_KEEP_0__ 키가 생성한 번들을 성공적으로 처리합니다. 키는 기존 기본/메인 채널, 다른 미리보기 키의 채널, 또는 다른 키의 번들에 사용할 수 없습니다. 또한 일반 bundle.delete. See API 키 설정에 대해 참조하세요.

📋 목록

별명: l

npx @capgo/cli@latest channel list

📋 Capgo 앱에 대한 모든 채널을 목록화하여 배포 설정을 검토합니다.

__CAPGO_KEEP_0__

npx @capgo/cli@latest channel list com.example.app

옵션:

파라미터	타입	설명
-a	string	API 계정에 연결하는 키
--supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
--supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키

📦 현재 버전

npx @capgo/cli@latest channel currentBundle

📦 Capgo에서 특정 채널에 연결된 현재 배포본을 가져와 업데이트 추적을 위해 클라우드에 저장합니다.

예시:

npx @capgo/cli@latest channel currentBundle production com.example.app

옵션:

Param	타입	-c
-c	string	설명
-a	string	API 키를 사용하여 계정에 연결
—quiet	boolean	배포 버전만 출력
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	사용자 지정 Supabase anon 키 (자체 호스팅용)

⚙️ 설정

별명: s

npx @capgo/cli@latest channel set

채널에 대한 설정을 구성합니다. 예를 들어, 버전 업데이트 전략(메이저, 마이너, 메타데이터, 패치, 없음), 장치 타겟팅(iOS, Android, 개발, 프로덕션, 에뮬레이터, 장치) 또는 번들을 연결할 수 있습니다. 한 채널은 기본 채널이어야 합니다.

예시:

npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default

옵션:

파라미터	타입	설명
-a	string	API 키를 사용하여 계정에 연결
-b	string	파일을 설정할 버전 번호
-s	string	채널의 상태를 설정(default 또는 normal)
—최신 원격	boolean	capgo 클라우드에 업로드된 최신 버전을 가져와 채널에 설정
—최신	boolean	package.json의 최신 버전 키를 가져와 채널에 설정
—다운그레이드	boolean	네이티브 버전보다 낮은 버전으로 다운그레이드 허용
—no-downgrade	boolean	네이티브 버전보다 낮은 버전으로 다운그레이드 금지
—ios	boolean	iOS 장치로 업데이트 보내기 허용
—no-ios	boolean	iOS 장치로 업데이트 보내기 차단
—android	boolean	Android 장치로 업데이트 보내기 허용
—no-android	boolean	Android 장치로 업데이트 보내기 차단
—self-assign	boolean	이 채널에 장치 자체 할당 허용
—no-self-assign	boolean	이 채널에 장치 자체 할당 차단
—disable-auto-update	string	업데이트 차단: major, minor, metadata, patch, 또는 none (모두 허용)
—업데이트 패키지	string	zip, delta, 또는 둘 다 제공: all, zip, delta, zip_from_builtin, 또는 delta_from_builtin
—롤아웃 번들	string	이 채널에서 점진적으로 릴리즈할 번들의 버전
—롤아웃 퍼센트	string	0에서 100까지의 롤아웃 퍼센트
—롤아웃 퍼센트 BPS	string	0에서 10000까지의 롤아웃 퍼센트 (BPS)
—롤아웃 활성화	boolean	설정된 롤아웃을 활성화
—롤아웃 비활성화	boolean	설정된 롤아웃을 비활성화합니다.
—롤아웃-중지	boolean	선택된 기기 rollback 없이 롤아웃 노출을 중지합니다.
—롤아웃-재개	boolean	중지된 롤아웃을 재개합니다.
—롤아웃-롤백	boolean	롤아웃 상태를 초기화하고 기기들을 안정 상태로 되돌립니다.
—롤아웃-진보	boolean	롤아웃 대상의 안정 상태로 전환하고 롤아웃 상태를 초기화합니다.
—롤아웃-캐시-TTL-초	string	Cloudflare 롤아웃 결정 캐시 TTL 초
자동 중지 기능이 활성화되어 있는지 여부	boolean	롤아웃 자동 중단 정책 활성화
–auto-pause-disabled	boolean	롤아웃 자동 중단 정책 비활성화
–auto-pause-window-minutes	string	롤아웃 자동 중단 정책 통계 창
–auto-pause-failure-rate-bps	string	실패율 기준점
–auto-pause-confidence	string	0에서 1 사이의 신뢰도
–auto-pause-min-attempts	string	설치 및 실패 시도 횟수 최소화
–auto-pause-min-failures	string	최소 실패 횟수 전 자동 중단이 트리거 될 수 있습니다
---auto-pause-action	string	자동 중단 동작: 중단, 롤백, 또는 알림
---auto-pause-cooldown-minutes	string	자동 중단이 다시 트리거 될 수 있는 최소 대기 시간
---dev	boolean	개발 장치로 업데이트를 전송할 수 있도록 허용
---no-dev	boolean	개발 장치로 업데이트를 전송하지 않도록 비활성화
---prod	boolean	운영 장치로 업데이트를 전송할 수 있도록 허용
---no-prod	boolean	생산 장치로 업데이트를 보내지 않도록 비활성화합니다
—emulator	boolean	에뮬레이터 장치로 업데이트를 보내도록 허용합니다
—no-emulator	boolean	에뮬레이터 장치로 업데이트를 보내지 않도록 비활성화합니다
—device	boolean	물리 장치로 업데이트를 보내도록 허용합니다
—no-device	boolean	물리 장치로 업데이트를 보내지 않도록 비활성화합니다
—qr-preview	boolean	이 채널 프리뷰를 업데이트한 후 터미널 QR code를 출력합니다
—send-update-notification	boolean	__CAPGO_KEEP_0__
—package-json	string	__CAPGO_KEEP_0__
—ignore-metadata-check	boolean	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	string	Capgo
__CAPGO_KEEP_0__	string	__CAPGO_KEEP_0__