📦 패키지

📦 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__을 제외하고) --bundleCI에서 유용합니다. package.json 이미 버전 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__/채널 델타 매니페스트와 지역 번들 파일을 비교하고, --auto-bump ai, Capgo Cloudflare Workers AI compares local bundle files to the previous Capgo/channel delta manifest, infers major | minor | patch | metadata짧은 이유를 CLI 로그에 출력합니다. 이전 Capgo 버전이 없으면 AI는 무시되고, patch로 기본값이 설정됩니다..

옵션:

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

🧪 호환성

npx @capgo/cli@latest bundle compatibility

Capgo Cloud에서 특정 채널과 호환성을 확인하여 업데이트가 안전한지 확인하세요.

예시:

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	사용자 정의 Supabase 익명 키 (자체 호스팅)

🔹 릴리즈 타입

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	사용자 지정 Supabase 익명 키 (자체 호스팅용)

🗑️ 삭제

Alias: 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

옵션:

파라미터	타입	설명
--키	string	개인 서명 키의 사용자 지정 경로
--키-데이터	string	개인 서명 키
-j	boolean	JSON 형식으로 출력
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

🔓 해제

npx @capgo/cli@latest bundle decrypt

암호화된 번들을 해제 (주로 테스트 용도). 인증을 위한 base64 세션 키를 출력합니다.

예시:

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

옵션:

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

🔹 Zip

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-check	boolean	소스 code와 root 폴더 내 index가 존재하는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)