📦 번들

📦 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

설정:

Param	Type	설명
-a,	string	API 계정에 연결하기 위한 키
-p,	string	업로드할 폴더의 경로를 지정합니다. 지정하지 않으면 capacitor.config의 webDir를 사용합니다.
-c,	string	연결할 채널
-e,	string	외부 URL로 연결하기 대신 Capgo 클라우드에 업로드
—iv-session-key	string	bundle URL 외부에 IV 및 세션 키 설정
—s3-region	string	S3 버킷의 지역
—s3-apikey	string	API S3 엔드포인트의 키
—s3-apisecret	string	API S3 엔드포인트의 비밀번호
—s3-endpoint	string	S3 엔드포인트의 URL
—__CAPGO_KEEP_0__-버킷 이름	string	AWS S3 버킷의 이름
—__CAPGO_KEEP_0__-포트	string	S3 엔드포인트의 포트
—__CAPGO_KEEP_0__-SSL 비활성화	boolean	S3 업로드에 SSL을 비활성화합니다.
—__CAPGO_KEEP_0__-2	string	사용자 지정 개인 서명 키 경로 (버전 2 시스템)
—__CAPGO_KEEP_0__-2-키	string	버전 2 시스템의 개인 서명 키
—__CAPGO_KEEP_0__-URL	boolean	stdout에 번들 URL을 출력합니다.
—no-key	boolean	업데이트를 암호화하지 않고 무조건 전송
—no-code-check	boolean	code 소스와 인덱스 폴더 루트에 존재하는지 확인하지 않고 notifyAppReady() 함수 호출 여부 무시
—display-iv-session	boolean	업데이트 암호화에 사용한 IV와 세션 키를 콘솔에 표시
-b,	string	업로드할 번들의 버전 번호
—link	string	외부 리소스에 대한 링크 (예: GitHub 릴리스)
—comment	string	이 버전에 대한 설명, 릴리스 노트, 커밋 해시, 커밋 메시지 등
—min-update-version	string	업데이트를 위해 필요한 최소 버전. disable auto update이 metadata channel에 설정된 경우에만 사용
—auto-min-update-version	boolean	native 패키지에 따라 min update 버전을 설정
—ignore-metadata-check	boolean	업로드 시 metadata (node_modules) 검사를 무시
—ignore-checksum-check	boolean	업로드 시 체크섬 검사를 무시
—force-crc32-checksum	boolean	업로드 시 CRC32 체크섬을 강제로 사용 (자동 감지 오버라이드)
—timeout	string	업로드 프로세스의 타임아웃 시간 (초)
—multipart	boolean	[DEPRECATED] __CAPGO_KEEP_0__ 사용하기 대신 —tus 사용하세요. multipart protocol을 사용하여 S3 업로드
—zip	boolean	Capgo 클라우드(legacy)에서 zip을 사용하여 배ंडल 업로드
—tus	boolean	Capgo 클라우드에서 TUS를 사용하여 배ंडल 업로드
—tus-chunk-size	string	TUS 재시작 업로드에 대한 chunk size (기본값: 자동)
—partial	boolean	[DEPRECATED] —delta 대신 사용하세요. incremental 업데이트를 업로드
—partial-only	boolean	[DEPRECATED] —delta-only 대신 사용하세요. incremental 업데이트만 업로드, 전체 배ंडल 생략
—delta	boolean	빠른 업데이트를 위해 delta 업데이트만 업로드하세요.
—delta-only	boolean	대형 앱의 경우 최대 속도에 도달하기 위해 전체 번들을 업로드하지 않고 delta 업데이트만 업로드하세요.
—no-delta	boolean	Direct Update가 활성화되어도 delta 업데이트를 비활성화하세요.
—encrypted-checksum	string	외부 번들을 업로드할 때만 사용하는 암호화된 체크섬(서명).
—auto-set-bundle	boolean	capacitor.config.json에 번들을 자동으로 설정하세요.
—dry-upload	boolean	데이터베이스에 행을 추가하는 것만 수행하여 파일을 업로드하지 않습니다. (Capgo 내부 테스트를 위해 사용)
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—encrypt-partial	boolean	델타 업데이트 파일을 암호화 (업데이터 버전 6.14.4 이상일 경우 자동 활성화)
—delete-linked-bundle-on-upload	boolean	업로드하려는 채널에서 현재 연결된 번들을 찾고 삭제
—no-brotli-patterns	string	브로틀리 압축에서 제외할 파일 (쉼표로 구분된 glob 패턴, 예: “*.jpg,*.png”)__CAPGO_KEEP_0____CAPGO_KEEP_0__
—disable-brotli	boolean	업데이터 버전이 지원하는 경우에도 브로틀리 압축을 완전히 비활성화합니다.
—version-exists-ok	boolean	빌드 버전이 이미 존재하는 경우 CI/CD 워크플로우와 함께 모노레포를 위한 성공적으로 종료합니다.
—self-assign	boolean	이 채널(업데이트 채널 설정)에 자동으로 가입할 수 있도록 장치에 허용합니다.
—supa-host	string	自主 호스팅 또는 개발을위한 커스텀 Supabase 호스트 URL ( Capgo )
—supa-anon	string	自主 호스팅을위한 커스텀 Supabase anon 키
—verbose	boolean	세부 로깅과 함께 자세한 로그 출력을 활성화합니다.

🧪 __CAPGO_KEEP_0__

npx @capgo/cli@latest bundle compatibility

🧪 Check compatibility of a bundle with a specific channel in Capgo Cloud to ensure updates are safe.

__CAPGO_KEEP_5__

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

__CAPGO_KEEP_8__

__CAPGO_KEEP_9__	__CAPGO_KEEP_10__	__CAPGO_KEEP_11__
-a,	string	API 계정을 연결하기 위한 키
-c,	string	체크할 호환성 채널
—text	boolean	이모티콘 대신 출력 텍스트
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—supa-host	string	커스텀 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발)
—	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 개발)
—	string	사용자 정의 Supabase 익명 키 (자체 호스팅)

🗑️ 삭제

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	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키

📋 목록

Alias: 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 anon 키 (자체 호스팅)

🧹 Cleanup

터미널 창 c

npx @capgo/cli@latest bundle cleanup

🧹 Delete old bundles in Capgo Cloud, keeping specified number of recent versions. Bundles linked to channels are preserved unless —ignore-channel is used.

터미널 창

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

옵션:

파라미터	타입	설명
-b,	string	앱 삭제할 버전의 번들 버전 번호
-a,	string	API 계정에 연결하는 키
-k,	string	보존할 버전 수
-f,	string	강제 삭제
—ignore-channel	boolean	채널과 연결된 경우에도 번들 삭제 (경고: 채널도 삭제)
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	사용자 지정 Supabase 익명 키 (자체 호스팅용)

🔒 암호화

npx @capgo/cli@latest bundle encrypt

zip 번들을 안전한 외부 저장소에 업로드하기 위해 암호화합니다. 업로드/복호화에 사용할 ivSessionKey를 반환합니다. checksum을 얻으려면 'bundle zip —json'을 사용하세요.

예시:

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

옵션:

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

🔓 해독

npx @capgo/cli@latest bundle decrypt

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

예시:

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

옵션:

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

🔹 Zip

npx @capgo/cli@latest bundle zip

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

예시:

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

옵션:

Param	Type	설명
-p,	string	업로드할 폴더의 경로, 제공되지 않으면 capacitor.config의 webDir을 사용합니다.
-b,	string	__CAPGO_KEEP_0__의 zip 파일 이름을 지정하는 버전 번호
-n,	string	zip 파일 이름
-j,	string	JSON 형식으로 출력
—no-code-check	boolean	소스 code와 인덱스 루트 폴더에 있는 경우 notifyAppReady()가 호출되었는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

번들에서 계속

번들을 사용 중이라면 번들 번들을 사용하여 보안 및 규정 준수 계획을 세우려면 암호화 암호화 구현 세부 정보에서 규정 준수 규정 준수 구현 세부 정보에서 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로우에서 Capgo 보안 Capgo 보안의 제품 워크플로우에서 Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로우에서.