📦 배포

📦 Capgo에서 앱 배포를 위한 패키지 관리

⬆️ 업로드

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	타입	설명
-a,	string	API 계정에 연결하기 위한 키
-p,	string	capacitor.config에서 webDir을 사용하지 않으면 업로드할 폴더의 경로
-c,	string	연결할 채널
-e,	string	Capgo Cloud에 업로드하지 않고 외부 URL로 연결하기
—iv-session-key	string	bundle URL 외부에 IV 및 세션 키 설정
—s3-지역	string	S3 버킷의 지역
—s3-apikey	string	API 키로 S3 엔드포인트에 접근
—s3-apisecret	string	API 비밀번호로 S3 엔드포인트에 접근
—s3-엔드포인트	string	S3 엔드포인트의 URL
—s3-버킷-이름	string	AWS S3 버킷의 이름
—s3-포트	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	업로드할 번들의 버전 번호
—link	string	외부 자원에 대한 링크 (예: GitHub 릴리스)
—comment	string	이 버전에 대한 주석, 릴리스 노트, 커밋 해시, 커밋 메시지 등이 될 수 있습니다.
—min-update-version	string	이 버전으로 업데이트하려면 필요한 최소 버전. 자동 업데이트를 비활성화하고 채널의 메타데이터로 설정된 경우에만 사용됩니다.
—auto-min-update-version	boolean	원시 패키지에 따라 최소 업데이트 버전을 설정합니다.
—ignore-metadata-check	boolean	업로드 시 node_modules 확인을 무시합니다.
—ignore-checksum-check	boolean	업로드 시 체크섬 확인을 무시합니다.
—force-crc32-checksum	boolean	업로드 시 CRC32 체크섬을 강제로 사용합니다.
—timeout	string	업로드 프로세스의 타임아웃 시간 (초)
—multipart	boolean	[deprecated] —tus를 사용하세요. multipart 프로토콜을 사용하여 S3 업로드
—zip	boolean	배포를 Capgo 클라우드에 zip으로 업로드합니다.
—tus	boolean	Capgo 클라우드에 TUS를 사용하여 배ंडल을 업로드하세요.
—tus-chunk-size	string	TUS 재시작 업로드에 사용되는 바이트 단위의 블록 크기 (기본값: 자동)
—partial	boolean	[deprecated] —delta를 사용하세요. 빠른 업데이트를 위해 incremental 업데이트를 업로드하세요.
—partial-only	boolean	[deprecated] —delta-only를 사용하세요. incremental 업데이트만 업로드하고 전체 배ंडल은 건너 뛰세요.
—delta	boolean	빠른 업데이트를 위해 instant 업데이트를 업로드하세요. (대형 zip 다운로드 대신)
—delta-only	boolean	대형 앱을 위한 최대 속도에 최적화된 업로드로, 전체 배ंडल 없이 delta 업데이트만 업로드하세요.
—no-delta	boolean	Direct Update를 사용하더라도 델타 업데이트를 비활성화합니다.
—encrypted-checksum	string	업로드할 외부 패키지의 암호화된 체크섬(서명).
—auto-set-bundle	boolean	capacitor.config.json에 패키지를 자동으로 설정합니다.
—dry-upload	boolean	패키지를 업로드하는 프로세스를 시뮬레이션합니다. (업로드 파일은 업로드하지 않지만 데이터베이스에 행을 추가합니다. Capgo의 내부 테스트를 위해 사용됩니다.)
—package-json	string	모노레포의 package.json 파일 경로(쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로(쉼표로 구분)
—partial-암호화	boolean	업데이터 파일의 부분 암호화 (업데이터 > 6.14.4 버전부터 자동 활성화)
—업로드 시 연결된 번들 삭제	boolean	업로드하려는 채널에서 현재 연결된 번들을 찾고 삭제합니다
—브로틀리 패턴 제외	string	브로틀리 압축에서 제외할 파일 목록 (쉼표로 구분된 glob 패턴, 예: “.jpg, .png”)—브로틀리 비활성화업데이터 버전이 브로틀리 압축을 지원하더라도 완전히 브로틀리 압축을 비활성화합니다
—버전이 존재해도 성공	boolean	CI/CD 워크플로우에서 모노레포를 사용하는 경우 버전이 이미 존재해도 성공적으로 종료합니다
__CAPGO_KEEP_0__	boolean	__CAPGO_KEEP_0__
—자체 할당	boolean	장치가 이 채널에 자동으로 가입할 수 있도록 허용 (업데이트 채널 설정)
—슈파 호스트	string	자체 호스팅 또는 개발을 위해 사용하는 커스텀 슈파베이스 호스트 URL (for self-hosting or Capgo development)
—슈파 익명	string	자체 호스팅을 위해 사용하는 커스텀 슈파베이스 익명 키
—verbose	boolean	상세 로깅과 함께 자세한 출력을 활성화

🧪 호환성

npx @capgo/cli@latest bundle compatibility

🧪 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	커스텀 Supabase anon 키 (자체 호스팅용)

🔹 릴리즈 타입

npx @capgo/cli@latest bundle releaseType

🧭 호환성에 따라 채널의 최신 메타데이터와의 호환성을 기준으로 "자연어" 또는 "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에서 특정 번들을 삭제합니다. (버전을 선택적으로 지정할 수 있습니다.)

예시:

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

옵션:

Param	Type	설명
-a,	string	API 계정에 연결하기 위한 키
—supa-host	string	사용자 호스팅 또는 개발을 위한 Capgo Custom Supabase 호스트 URL
—supa-anon	string	사용자 호스팅을 위한 Custom Supabase anon 키

📋 목록

Alias: l

npx @capgo/cli@latest bundle list

📋 Capgo Cloud에서 앱에 업로드한 모든 패키지를 목록으로 표시

예시:

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

설정:

파라미터	타입	설명
-a,	string	API 계정에 연결하기 위한 키
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키

🧹 정리

별명: c

npx @capgo/cli@latest bundle cleanup

Capgo Cloud에서 Capgo 개의 최근 버전을 보존하는 동안 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,	string	강제 삭제
—ignore-channel	boolean	링크된 채널까지 삭제 (경고: 채널도 삭제)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위해 사용하는 커스텀 Supabase anon 키

🔒 암호화

npx @capgo/cli@latest bundle encrypt

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

예시:

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

옵션:

파라미터	타입	설명
—key	string	__CAPGO_KEEP_0__ 개인 서명 키를 위한 사용자 지정 경로
—key-data	string	__CAPGO_KEEP_0__ 개인 서명 키
-j,	string	JSON 형식으로 출력
—package-json	string	__CAPGO_KEEP_0__ 패키지 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 파일 경로 (쉼표로 구분)

🔹 압축

npx @capgo/cli@latest bundle 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,	string	JSON으로 출력
—no-code-체크	boolean	notifyAppReady() 함수가 소스 code와 root 폴더에 있는 인덱스에 호출되었는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)