📦 패키지

📦 Capgo Cloud에서 배포를 위해 앱 패키지를 관리합니다. 업로드, 호환성 검사 및 암호화가 포함됩니다.

⬆️ 업로드

Alias: u

npx @capgo/cli@latest bundle upload

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

예시:

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

__CAPGO_KEEP_0__ 채널 (또는 최신远程应用版本)에서 다음 무료 세미버저를 자동으로 업데이트합니다. __CAPGO_KEEP_0__을 전달하지 않을 때 --bundle__CAPGO_KEEP_0__이 CI에서 유용합니다. package.json Capgo이 이미 Capgo과 일치할 때:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__와 함께, Workers AI는 이전 __CAPGO_KEEP_2__/채널 델타 매니페스트와 __CAPGO_KEEP_0__의 로그에 짧은 이유를 출력합니다. 이전 __CAPGO_KEEP_1__ 버전이 없으면 AI가 생략되고 업데이트는 __CAPGO_KEEP_0__로 기본값이 됩니다. --auto-bump ai, Capgo Cloudflare Workers AI compares local bundle files to the previous Capgo/channel delta manifest, infers major | minor | patch | metadata, and prints a short reason in the CLI log. If no previous Capgo version exists, AI is skipped and the bump defaults to __CAPGO_KEEP_0__.

__CAPGO_KEEP_1__

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 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을 출력합니다.
—no-key	boolean	서명 키를 무시하고 업데이트 내용을 클리어로 전송합니다.
—no-code-check	boolean	소스 code와 인덱스 루트 폴더에 있는지 확인하지 않습니다.
—display-iv-session	boolean	콘솔에 업데이트를 암호화할 때 사용하는 IV와 세션 키를 표시합니다.
-b	string	업로드할 번들의 버전 번호
—auto-bump	string	채널과 연결된 번들에서 자동으로 증가하거나, else 최신远程 앱 버전입니다. Level: major, minor (기본), patch (alias fix), metadata, 또는 ai (웹 워커 AI는 지역 vs 이전 delta 매니페스트에서 수준을 추론합니다; 이전 Capgo 버전이 없으면 patch로 돌아갑니다). 삭제된 이름이 차지한 채널이 있으면 free 이름이 발견될 때까지 버전을 업데이트합니다. —bundle (-b)와 함께 사용할 수 없습니다.
—링크	string	외부 리소스에 연결합니다 (예: GitHub 릴리스)
이 버전에 대한 주석입니다. 릴리스 노트, 커밋 해시, 커밋 메시지 등이 될 수 있습니다.	string	이 버전으로 업데이트하려면 필요한 최소 버전입니다. 채널의 disable auto update이 metadata로 설정된 경우에만 사용됩니다.
자체 패키지에 기반하여 최소 업데이트 버전을 설정합니다.	string	업로드 시 메타데이터 (node_modules) 검사를 무시합니다.
일치하지 않는 버전일 경우 실패합니다.	boolean	—fail-on-incompatible
—ignore-metadata-check	boolean	—auto-min-update-version
—min-update-version	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-chunk-size	string	TUS 재시작 업로드의 바이트 단위로의 블록 크기 (기본값: 자동)
—partial	boolean	[deprecated] —delta를 사용하세요. incremental 업데이트를 업로드하세요.
—partial-only	boolean	[deprecated] —delta-only를 사용하세요. 전체 배ंडल을 업로드하지 않고 incremental 업데이트만 업로드하세요.
—delta	boolean	delta 업데이트만 업로드하세요. (업데이트된 파일만 업로드). 대용량 다운로드 대신 빠른 업데이트를 위해.
—delta-only	boolean	대용량 앱을 위한 최대 속도 (업데이트된 파일만 업로드).
—no-delta	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 이상부터 자동 활성화)
—업로드 시 연결된 번들 삭제	boolean	업로드하려는 채널에서 현재 연결된 번들을 찾고 삭제합니다
—브로틀리 패턴 제외	string	브로틀리 압축에서 제외할 파일 목록 (쉼표로 구분된 glob 패턴, 예: “.jpg, .png”)—브로틀리 비활성화업데이터 버전이 지원하는 경우에도 브로틀리 압축을 완전히 비활성화합니다
—버전이 이미 존재해도 성공적으로 종료	boolean	CI/CD 워크플로우에서 모노레포를 위한 버전이 이미 존재해도 성공적으로 종료합니다
—자신에게 할당	boolean	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	boolean	이 채널에 장치가 자동으로 가입할 수 있도록 허용 (업데이트 채널 설정)
—qr-preview	boolean	이 번들의 미리보기 업로드 후 터미널 QR code 출력
—send-update-notification	boolean	장치에 업데이트된 링크 채널 번들을 업데이트한 후 네이티브 업데이트 체크 알림을 보내는
—supa-host	string	자체 호스팅 또는 Capgo 개발을 위한 커스텀 Supabase 호스트 URL
—supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키
—verbose	boolean	세부 로깅과 함께 자세한 로그 출력을 활성화

🧪 호환성

npx @capgo/cli@latest bundle compatibility

Capgo 클라우드에서 업데이트가 안전한지 확인하기 위해 특정 채널과 Capgo의 배포본이 호환되는지 확인하세요.

예시:

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

옵션:

파라미터	타입	설명
-a	string	API 계정에 연결하는 키
-c	string	채널을 확인하기 위해
—텍스트	boolean	이모티콘 대신 텍스트를 출력
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발)
—supa-anon	string	개인 호스팅을 위한 Custom Supabase anon 키

🔹 릴리즈 타입

npx @capgo/cli@latest bundle releaseType

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

예시:

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

옵션:

파라미터	타입	설명
-a	string	API 키를 사용하여 계정에 연결
-c	string	비교할 채널
--package-json	string	모노레포의 package.json 파일 경로(쉼표로 구분)
--node-modules	string	모노레포의 node_modules 디렉토리 경로(쉼표로 구분)
--supa-host	string	사용자 지정 Supabase 호스트 URL(자체 호스팅 또는 Capgo 개발용)
--supa-anon	string	개인 호스팅을 위한 Custom Supabase anon 키

🗑️ 삭제

별칭: d

npx @capgo/cli@latest bundle delete

🗑️ Capgo Cloud에서 특정 번들을 삭제합니다. 단, 버전을 지정할 수 있습니다.

예시:

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

옵션:

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

📋 목록

별명: l

npx @capgo/cli@latest bundle list

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

예시:

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

옵션:

Param	Type	설명
-a	string	API 계정에 연결하기 위한 키
--supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	사용자 지정 Supabase 익명 키 (자체 호스팅)

🧹 정리

별명: 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	강제 삭제
—채널 무시	boolean	채널과 연결된 배너도 삭제 (경고: 채널도 삭제)
—수파베스 호스트	string	Custom Supabase host URL (for self-hosting or Capgo development)
—수파베스 익명	string	사용자 지정 수파베스 익명 키 (자체 호스팅용)

🔒 암호화

npx @capgo/cli@latest bundle encrypt

🔒 배너를 안전한 외부 저장소에 보관하기 위해 암호화합니다. 업로드/해독을 위해 ivSessionKey를 반환합니다. 체크섬을 얻으려면 '배너 zip —json'을 사용하세요.

예시:

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

옵션:

Param	Type	설명
—key	string	개인 서명 키의 사용자 지정 경로
—key-data	string	개인 서명 키
-j	boolean	JSON 형식으로 출력
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

🔓 해독

npx @capgo/cli@latest bundle decrypt

암호화된 번들을 해독 (주로 테스트 용도). 기본 64진법 세션 키를 출력하여 검증 가능.

예시:

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

옵션:

파라미터	형식	설명
—키	string	사용자 지정 키 경로 (사용자 지정 키)
—키 데이터	string	사용자 지정 키
—체크섬	string	배포물의 무결성을 확인하기 위한 체크섬
—패키지 json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

🔹 압축 파일

npx @capgo/cli@latest bundle zip

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

예시:

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

옵션:

파라미터	타입	설명
-p	string	capacitor.config에서 webDir을 설정하지 않은 경우 업로드할 폴더의 경로
-b	string	압축 파일 이름을 zip 파일 이름으로 지정하는 버전 번호
-n	string	zip 파일 이름
-j	boolean	JSON 형식으로 출력
—no-code-check	boolean	소스 code와 root 폴더 내 index가 존재하는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)