📦 __CAPGO_KEEP_0__

📦 Manage app bundles for deployment in Capgo Cloud, including upload, compatibility checks, and encryption.

⬆️ 업로드

터미널 창 u

npx @capgo/cli@latest bundle upload

Capgo 클라우드에 새로운 앱 번들을 업로드하여 배포하세요. 버전은 0.0.0보다 크고 고유해야 합니다. 삭제된 버전은 보안을 위해 재사용할 수 없습니다. 외부 옵션: URL 링크만 저장 (200MB 이상의 앱 또는 개인 정보 보호 요구 사항에 유용합니다). Capgo는 외부 콘텐츠를 검사하지 않습니다. 신뢰할 수 없는 보안을 위해 암호화를 추가하세요.

예시:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,beta

옵션:

Param	Type	설명
-a	string	API 계정에 연결하는 키
-p	string	capacitor.config에서 webDir을 사용하지 않으면 업로드할 폴더의 경로
-c	string	링크할 채널을 지정합니다. 예를 들어 production,beta
—rollout	string	0에서 100 사이의 퍼센트로 업로드한 패키지를 이 채널의 롤아웃 목표로 설정
—rollout-percentage-bps	string	0에서 10000까지 업로드 된 번들 롤아웃 퍼센티지 설정
—rollout-cache-ttl-seconds	string	Cloudflare 로그인 결정 캐시 TTL (초)
-e	string	Capgo 클라우드에 업로드하는 대신 외부 URL로 연결
—iv-session-key	string	번들 URL 외부의 IV 및 세션 키 설정
—s3-region	string	S3 버킷의 지역
—s3-apikey	string	API S3 엔드포인트의 키
—s3-apisecret	string	API S3 엔드포인트의 비밀 키
—s3-endpoint	string	S3 엔드포인트의 URL
—s3-bucket-name	string	AWS S3 버킷의 이름
—s3-port	string	S3 엔드포인트의 포트
—no-s3-ssl	boolean	S3 업로드에 SSL을 비활성화합니다.
—key-v2	string	사용자 지정 개인 서명 키의 경로 (v2 시스템)
—key-data-v2	string	개인 서명 키 (v2 시스템)
—bundle-url	boolean	배포 URL을 stdout에 출력합니다.
—no-key	boolean	서명 키를 무시하고 업데이트 내용을 클리어로 전송합니다.
—no-code-check	boolean	code의 notifyAppReady() 함수가 호출되었는지 및 루트 폴더에 index가 존재하는지 확인하지 않습니다.
—display-iv-session	boolean	업데이트를 암호화할 때 사용되는 IV와 세션 키를 콘솔에 표시합니다.
-b	string	업로드할 배포의 버전 번호
—링크	string	GitHub 외부 자원 링크
—주석	string	이 버전에 대한 주석, 릴리스 노트, 커밋 해시, 커밋 메시지 등이 될 수 있습니다.
—최소 업데이트 버전	string	이 버전으로 업데이트를 위해 필요한 최소 버전. disable auto update이 metadata로 설정된 채널에서만 사용됩니다.
—자동 최소 업데이트 버전	boolean	자연스러운 패키지 버전을 기반으로 최소 업데이트 버전을 설정합니다.
—메타데이터 무시	boolean	업로드 시 메타데이터(노드 모듈) 검사를 무시합니다.
—불일치 시 실패	boolean	채널의 현재 자연스러운 패키지와 불일치하는 경우 업로드를 실패(0이 아닌 종료 코드)합니다. 인터랙티브 터미널에서 자연스러운 빌드를 선택할 수 있지만 거부하면 실패합니다. —ignore-metadata-check와 함께 사용할 수 없습니다.
—ignore-checksum-check	boolean	업로드 시 체크섬 확인을 무시합니다.
—force-crc32-checksum	boolean	업로드 시 CRC32 체크섬을 강제로 사용합니다. (자동 감지 오버라이드)
—timeout	string	업로드 프로세스의 타임아웃 시간 (초)
—multipart	boolean	[deprecated] —tus를 사용하세요. S3 업로드에 multipart 프로토콜을 사용합니다.
—zip	boolean	Capgo 클라우드에서 배ंडल을 zip으로 업로드합니다 (legacy)
—tus	boolean	Capgo 클라우드에서 배ंडल을 TUS를 사용하여 업로드합니다
—tus-블록 크기	string	TUS 재시도 업로드의 블록 크기 (기본값: 자동)
—부분	boolean	[deprecated] —delta를 사용하세요. 부분 업로드
—부분 업로드만	boolean	[deprecated] —delta-only를 사용하세요. 부분 업로드만, 전체 배포 건너뛰기
—델타	boolean	델타 업데이트로 즉시, 초고속 업데이트를 위해 변경된 파일만 업로드
—델타 업로드만	boolean	델타 업데이트로만 업로드, 최대 속도 (대형 앱에 유용)
—델타 업로드 비활성화	boolean	델타 업데이트를 비활성화하세요. 즉시 업데이트가 활성화되어도
—암호화 체크섬	string	외부 번들을 업로드할 때만 사용하는 암호화 체크섬(서명).
—자동 번들 설정	boolean	capacitor.config.json에 번들을 설정합니다.
—dry 업로드	boolean	Dry upload the bundle process: add the row in database without uploading files or updating channels (Used by Capgo for internal testing)
—패키지 json	string	모노레포의 패키지 json 파일 경로(쉼표로 구분)
—노드 모듈	string	모노레포의 노드 모듈 디렉토리 경로(쉼표로 구분)
—부분 암호화	boolean	델타 업데이트 파일 암호화(업데이터 버전 6.14.4 이상부터 자동 활성화)
__CAPGO_KEEP_0__	boolean	현재 업로드 중인 채널에 연결된 번들을 찾고 삭제합니다.
__CAPGO_KEEP_0__	string	브로틀리 압축에서 제외할 파일 목록 (쉼표로 구분된 glob 패턴, 예: “.jpg, .png”)__CAPGO_KEEP_0__업데이터 버전이 브로틀리 압축을 지원하더라도 완전히 비활성화합니다.
__CAPGO_KEEP_0__	boolean	번들의 버전이 이미 존재하면 성공적으로 종료합니다. 모노레포 CI/CD 워크플로우에 유용합니다.
__CAPGO_KEEP_0__	boolean	이 채널에 장치가 자동으로 가입되도록 허용합니다 (업데이트 채널 설정)
업로드 중인 채널의 번들을 삭제합니다.	boolean	업로드 중인 채널의 번들을 삭제합니다.
—QR 미리보기	boolean	이 번들 미리보기 업로드 후 터미널 QR code을 출력합니다.
—업데이트 알림 전송	boolean	링크드 채널 번들을 업데이트한 후 장치에 네이티브 업데이트 체크 알림을 전송합니다.
—수파스 호스트	string	수파스 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—수파스 익명	string	수파스 익명 키 (자체 호스팅용)
—verbose	boolean	세부 로깅과 함께 자세한 로그 출력을 활성화합니다.

🧪 호환성

npx @capgo/cli@latest bundle compatibility

🧪 Capgo 클라우드에서 특정 채널과 버블의 호환성을 확인하여 업데이트가 안전한지 확인하세요.

예시:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

옵션:

Param	Type	설명
-a	string	API 계정에 연결하기 위한 키
-c	string	호환성 확인을 위한 채널
—text	boolean	이모티콘 대신 텍스트 출력
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	커스텀 Supabase anon 키 (자체 호스팅용)

🔹 ReleaseType

npx @capgo/cli@latest bundle releaseType

🧭 'native' 또는 'OTA'를 출력합니다. 채널의 최신 메타데이터와의 호환성을 기반으로.

예시:

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

옵션:

Param	Type	설명
-a	string	API 키를 클릭하여 계정에 연결하세요.
-c	string	비교할 채널
—package-json	string	모노레포의 package.json 파일 경로(쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로(쉼표로 구분)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	自主 호스팅을 위해 사용하는 커스텀 Supabase anon 키

🗑️ 삭제

Alias: d

npx @capgo/cli@latest bundle delete

Capgo Cloud에서 특정 버전을 대상으로 하여 Capgo Cloud에서 삭제할 번들을 선택합니다.

예시:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

옵션:

Param	Type	설명
-a	string	API 키를 클릭하여 계정에 연결하세요.
—supa-host	string	자체 호스팅 또는 Capgo 개발을 위한 사용자 지정 Supabase 호스트 URL
—supa-anon	string	자체 호스팅을 위한 사용자 지정 Supabase anon 키

📋 목록

별칭: l

npx @capgo/cli@latest bundle list

📋 Capgo 앱에 업로드 된 모든 번들을 목록화합니다.

예시:

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

옵션:

파라미터	타입	설명
-a	string	API 계정에 연결하기 위한 키
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	Supabase anon 키 (자체 호스팅용)

🧹 Cleanup

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Capgo Cloud에서 지정된 최근 버전의 수만큼 보존하는 데 사용되는 옵션입니다. 기존 버전의 삭제. 채널과 연결된 번들을 보존하는 데 —ignore-channel 옵션을 사용하지 않는 한.

예시:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

옵션:

파라미터	타입	설명
-b	string	삭제할 앱의 버전 번호
-a	string	API 계정에 연결하는 키
-k	string	보존할 버전 수
-f	boolean	강제 삭제
—ignore-channel	boolean	링크된 채널까지도 삭제 (경고: 채널도 삭제)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	사용자 지정 Supabase 익명 키 (자체 호스팅)

🔒 암호화

npx @capgo/cli@latest bundle encrypt

🔒 외부 저장소에 안전하게 저장하기 위해 zip 배ंडल을 암호화합니다. 업로드/해독을 위해 ivSessionKey를 반환합니다. '배달 zip —json'을 사용하여 체크섬을 가져옵니다.

예시:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

옵션:

파라미터	타입	설명
—key	string	개인 서명 키의 사용자 지정 경로
—key-data	string	개인 서명 키
-j	boolean	JSON 형식으로 출력
—package-json	string	__CAPGO_KEEP_0__

🔓 __CAPGO_KEEP_0__

npx @capgo/cli@latest bundle decrypt

__CAPGO_KEEP_4__

__CAPGO_KEEP_0__ 예시:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__	__CAPGO_KEEP_7__	설명
—키	string	사용자 지정 키 경로
—키 데이터	string	개인 키
—체크섬	string	배달의 번들에 대한 체크섬, 배달의 번들의 무결성을 확인하기 위해
패키지 json 경로	string	모노레포의 패키지 json 파일 경로 (쉼표로 구분)

🔹 압축

npx @capgo/cli@latest bundle zip

🗜️ 앱 번들에 대한 zip 파일을 생성합니다. 암호화에 사용할 체크섬을 반환합니다. —json 옵션을 사용하면 기계가 읽을 수 있는 출력을 얻을 수 있습니다.

예시:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

옵션:

Param	Type	설명
-p	string	capacitor.config에서 설정된 webDir을 사용하지 않으면 업로드할 폴더의 경로입니다.
-b	string	버전 번호를 이름으로 하는 zip 파일 이름으로 패키징
-n	string	zip 파일 이름
-j	boolean	JSON 형식으로 출력
—no-code-체크	boolean	소스 code와 루트 폴더 내 인덱스에 존재하는 notifyAppReady()가 호출되는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)