📦 패키지

📦 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

채널 (또는 최신 remote 앱 버전)에서 다음 무료 semver를 자동으로 증가시킵니다. (버전 __CAPGO_KEEP_0__을 제외하고) --bundleCI에서 유용합니다. __CAPGO_KEEP_0__ 버전이 이미 __CAPGO_KEEP_1__과 일치할 때 package.json Capgo 버전이 이미 __CAPGO_KEEP_1__과 일치할 때

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

With --auto-bump ai, Capgo Cloudflare 워커는 로컬 번들 파일을 이전 Capgo/채널 델타 매니페스트와 비교하여, 추론 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__

Param	형식	설명
-a	string	API 계정에 연결하는 키
-p	string	capacitor.config에서 제공하지 않으면 사용할 폴더 업로드 경로
-c	string	연결할 채널. 여러 채널을 사용하려면 예를 들어 production,beta와 같이 쉼표로 구분
--rollout	string	0에서 100까지의 백분율에서 업로드한 패키지를 이 채널의 롤아웃 목표로 설정
--stable	boolean	롤아웃 구성된 채널에서 안정적인 대체 대신 롤아웃 목표를 설정
—배포율-퍼센트-bps	string	0에서 10000까지의 배포율 퍼센트를 설정합니다.
—배포-캐시-TTL-초	string	Cloudflare 배포 결정 캐시 TTL 초
-e	string	Capgo에 업로드하지 않고 외부 URL로 연결합니다.
—iv-세션-키	string	배포 URL 외부에서 IV 및 세션 키를 설정합니다.
—s3-지역	string	S3 버킷의 지역을 설정합니다.
—s3-apikey	string	API 키를 설정합니다.
—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	bundle URL을 stdout로 출력합니다.
—no-key	boolean	서명 키를 무시하고 업데이트 내용을 클리어로 전송합니다.
—no-code-check	boolean	notifyAppReady()가 소스 code에서 호출되었는지 및 루트 폴더에 인덱스가 존재하는지 확인하지 않습니다.
—display-iv-session	boolean	업데이트를 암호화할 때 사용하는 IV와 세션 키를 콘솔에 표시합니다.
-b	string	업로드할 배포본의 버전 번호
—auto-bump	string	채널에 연결된 번들에서 자동으로 증가합니다. (기본값: 최신远程앱 버전). 레벨: 메이저, 마이너, 패치(기본값), 메타데이터, 또는 ai (웹워커 AI는 로컬 vs 이전 델타 매니페스트에서 레벨을 추론합니다. 이전 Capgo 버전이 없으면 패치로 돌아갑니다). 삭제된 이름은 사용되지 않습니다.
—link	string	외부 리소스에 연결합니다 (예: GitHub 릴리스)
—comment	string	이 버전에 대한 설명입니다. 릴리스 노트, 커밋 해시, 커밋 메시지 등이 될 수 있습니다.
—min-update-version	string	이 버전으로 업데이트할 수 있는 최소 버전입니다. 채널의 자동 업데이트를 비활성화하고 메타데이터로 설정한 경우에만 사용됩니다.
—auto-min-update-version	boolean	네이티브 패키지에 따라 최소 업데이트 버전을 설정합니다.
—ignore-metadata-check	boolean	업로드 시 메타데이터(노드 모듈) 검사를 무시합니다.
—fail-on-incompatible	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을 사용합니다.
—tus	boolean	Capgo 클라우드에 TUS를 사용하여 패키지를 업로드하세요.
—tus-chunk-size	string	TUS 재시작 업로드의 바이트 단위로 쿼리 (기본값: 자동)
—partial	boolean	[deprecated] —delta를 사용하세요. 빠른 업데이트를 위해 incremental 업데이트를 업로드하세요.
—partial-only	boolean	[deprecated] —delta-only를 사용하세요. 큰 앱의 경우 최대 속도에 도달하기 위해 full bundle를 생략하고 incremental 업데이트만 업로드하세요.
—delta	boolean	빠른 업데이트를 위해 delta 업데이트만 업로드하세요.
—delta-only	boolean	대형 앱의 경우 최대 속도에 도달하기 위해 full bundle를 생략하고 delta 업데이트만 업로드하세요.
—no-delta	boolean	delta 업데이트를 비활성화하십시오. (instant 업데이트가 활성화되어도)
—encrypted-checksum	string	암호화된 체크섬 (서명). 외부 배포본을 업로드할 때만 사용됩니다.
—auto-set-bundle	boolean	capacitor.config.json에 배포본을 설정합니다.
—dry-upload	boolean	bundle 업로드 프로세스: 데이터베이스에 행을 추가하고 파일 업로드 또는 채널 업데이트 없이 (Capgo 내부 테스트를 위해 사용됨)
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—암호화-부분	boolean	업데이트 델타 파일 암호화 (업데이터 > 6.14.4부터 자동 활성화)
—업로드 시 연결된 번들 삭제	boolean	현재 업로드 중인 채널에서 연결된 번들을 찾고 삭제
—브로틀리 패턴 제외	string	압축에서 제외할 파일 (쉼표로 구분된 glob, 예: “.jpg,.png”)
—브로틀리 비활성화	boolean	업데이터 버전이 지원하는 경우에도 브로틀리 압축을 완전히 비활성화
—버전이 이미 존재해도 성공	boolean	버전이 이미 존재하는 경우 성공적으로 종료, CI/CD 워크플로우와 모노레포에 유용
—자체 할당	boolean	이 채널 (업데이트 채널 설정)을 자동으로 가입하도록 장치에 허용합니다.
—qr 미리보기	boolean	업로드 한 이 번들의 미리보기 후 터미널 QR code를 출력합니다.
—업데이트 알림 전송	boolean	링크된 채널 번들의 업데이트가 완료된 후 장치에 원시적인 업데이트 체크 알림을 전송합니다.
—수파 호스트	string	자체 호스팅 또는 Capgo 개발을 위한 수파베이스 호스트 URL
—수파 익명	string	자체 호스팅을 위한 수파베이스 익명 키
—세부 정보	boolean	세부 정보 출력을 활성화하여 자세한 로깅을 표시합니다.

🧪 호환성

npx @capgo/cli@latest bundle compatibility

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

Example:

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

Options:

Param	예시:	Example:
-a	string	API 계정에 연결하기 위한 키
-c	string	채널을 확인하여 호환성을 체크합니다.
—text	boolean	이모티콘 대신 텍스트를 출력합니다.
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—supa-host	string	커스텀 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	자체 호스팅을 위한 Custom Supabase anon 키

🔹 ReleaseType

npx @capgo/cli@latest bundle releaseType

🧭 호환성에 따라 채널의 최신 메타데이터와 native 또는 OTA를 출력합니다.

예시:

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

옵션:

Param	타입	설명
-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 anon 키 (자체 호스팅)

🗑️ 삭제

Alias: d

npx @capgo/cli@latest bundle delete

Capgo Cloud에서 특정 번들 삭제, 옵션으로 단일 버전을 대상으로 할 수 있습니다.

예시:

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

옵션:

Param	Type	설명
-a	string	API
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	사용자 지정 Supabase 익명 키 (자체 호스팅용)

📋 목록

설명 l

npx @capgo/cli@latest bundle list

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

예시:

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

옵션:

Param	타입	설명
-a	string	API 계정에 연결하는 키
—서버 호스트	string	Custom Supabase host URL (for self-hosting or Capgo development)
—anon 키	string	자체 호스팅을 위한 커스텀 Supabase anon 키

🧹 정리

별명: c

npx @capgo/cli@latest bundle cleanup

🧹 Capgo 클라우드에서 __CAPGO_KEEP_1__ 버전의 최근 버전을 보존하는 동안 삭제하는 옛 버너들을 삭제합니다. 채널과 연결된 번들을 삭제하려면 —ignore-channel 옵션을 사용합니다.

예시:

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

옵션:

Param	타입	설명
-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

🔒 배포본을 안전한 외부 저장소에 저장하기 위해 암호화합니다. 업로드/복호화에 사용할 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

옵션:

Param	Type	설명
—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와 인덱스 폴더가 루트 폴더에 존재하는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)