📦 bundle

📦 Gestisci i bundle dell'app per il deployment su Capgo Cloud, inclusi upload, controlli di compatibilità e crittografia.

⬆️ Carica

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Carica un nuovo bundle dell'app su Capgo Cloud per la distribuzione. La versione deve essere > 0.0.0 e univoca. Le versioni eliminate non possono essere riutilizzate per motivi di sicurezza. Opzione External: salva solo un link URL (utile per app >200MB o per requisiti di privacy). Capgo non ispeziona mai il contenuto esterno. Aggiungi la crittografia per una sicurezza senza fiducia.

Esempio:

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

Incrementa automaticamente la prossima versione semver libera dal canale (o dall'ultima versione remota dell'app) se non specifichi --bundle. Utile in CI quando package.json corrisponde già a una versione presente in 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

Con --auto-bump ai, Capgo Cloudflare Workers AI confronta i file del bundle locale con il manifest delta della precedente Capgo/channel, deduce major | minor | patch | metadata, e stampa una breve motivazione nel log CLI. Se non esiste una versione Capgo precedente, l'AI viene saltata e il bump predefinito è patch.

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
-p	string	Percorso della cartella da caricare; se non specificato, userà il webDir impostato in capacitor.config
-c	string	Canale da collegare. Usa le virgole per più canali, ad esempio production,beta
—rollout	string	Imposta il bundle caricato come target di rollout di questo canale a una percentuale da 0 a 100
—stable	boolean	Su un canale con rollout configurato, sostituisce il fallback stable invece di impostare il target di rollout
—rollout-percentage-bps	string	Imposta la percentuale di rollout del bundle caricato in punti base da 0 a 10000
—rollout-cache-ttl-seconds	string	TTL della cache delle decisioni di rollout di Cloudflare in secondi
-e	string	Collega a un URL esterno invece di caricare su Capgo Cloud
—iv-session-key	string	Imposta l'IV e la session key per l'URL esterno del bundle
—s3-region	string	Regione per il tuo bucket S3
—s3-apikey	string	Chiave API per il tuo endpoint S3
—s3-apisecret	string	Secret API per il tuo endpoint S3
—s3-endpoint	string	URL dell'endpoint S3
—s3-bucket-name	string	Nome del bucket AWS S3
—s3-port	string	Porta per il tuo endpoint S3
—no-s3-ssl	boolean	Disabilita SSL per l'upload S3
—key-v2	string	Percorso personalizzato per la chiave di firma privata (sistema v2)
—key-data-v2	string	Chiave di firma privata (sistema v2)
—bundle-url	boolean	Stampa l'URL del bundle su stdout
—no-key	boolean	Ignora la chiave di firma e invia l'update in chiaro
—no-code-check	boolean	Ignora il controllo che notifyAppReady() sia chiamato nel sorgente code e che index sia nella cartella root
—display-iv-session	boolean	Mostra in console l'IV e la session key usati per criptare l'update
-b	string	Numero di versione del bundle da caricare
—auto-bump	string	Incrementa automaticamente dal bundle collegato al canale, o dall'ultima versione remota dell'app. Livelli: major, minor (default), patch (alias fix), metadata, o ai (Workers AI deduce il livello dal manifest delta locale rispetto al precedente; ricade su patch se non c'è una versione Capgo precedente). Incrementa finché non trova un nome libero (i nomi eliminati restano occupati). Non combinabile con —bundle (-b)
—link	string	Collega a una risorsa esterna (es. release di GitHub)
—comment	string	Commento su questa versione, può essere una release note, un hash di commit, un messaggio di commit, ecc.
—min-update-version	string	Versione minima richiesta per aggiornare a questa versione. Usata solo se disable auto update è impostato su metadata nel channel
—auto-min-update-version	boolean	Imposta la min update version in base ai pacchetti nativi
—ignore-metadata-check	boolean	Ignora il controllo dei metadata (node_modules) durante l'upload
—fail-on-incompatible	boolean	Fallisce l'upload (exit non-zero) invece di caricare quando il bundle non è compatibile con i pacchetti nativi correnti del channel. In un terminale interattivo puoi comunque scegliere un native build; rifiutare causa il fallimento. Non può essere combinato con —ignore-metadata-check.
—ignore-checksum-check	boolean	Ignora il controllo del checksum durante l'upload
—force-crc32-checksum	boolean	Forza il checksum CRC32 per l'upload (sovrascrive il rilevamento automatico)
—timeout	string	Timeout del processo di upload in secondi
—multipart	boolean	[DEPRECATED] Usa —tus invece. Utilizza il protocollo multipart per gli upload S3
—zip	boolean	Carica il bundle usando zip su Capgo cloud (legacy)
—tus	boolean	Carica il bundle usando TUS su Capgo cloud
—tus-chunk-size	string	Dimensione del chunk in byte per gli upload riprendibili TUS (predefinito: auto)
—partial	boolean	[DEPRECATO] Usa —delta invece. Carica aggiornamenti incrementali
—partial-only	boolean	[DEPRECATO] Usa —delta-only invece. Carica solo aggiornamenti incrementali, salta il bundle completo
—delta	boolean	Carica aggiornamenti delta (solo file modificati) per aggiornamenti istantanei e velocissimi, al posto di grandi download zip
—delta-only	boolean	Carica solo aggiornamenti delta senza bundle completo per la massima velocità (utile per app grandi)
—no-delta	boolean	Disable delta updates even if instant updates are enabled
—encrypted-checksum	string	Un checksum crittografato (firma). Usato solo quando si carica un bundle esterno.
—auto-set-bundle	boolean	Imposta il bundle in capacitor.config.json
—dry-upload	boolean	Esegue il dry upload del bundle: aggiunge la riga nel database senza caricare file né aggiornare i channel (usato da Capgo per test interni)
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)
—node-modules	string	Percorsi delle directory node_modules per i monorepo (separati da virgola)
—encrypt-partial	boolean	Cripta i file degli aggiornamenti delta (abilitato automaticamente per updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Individua il bundle attualmente collegato al channel in cui stai cercando di fare upload e lo elimina
—no-brotli-patterns	string	File da escludere dalla compressione Brotli (glob separati da virgola, es: “.jpg,.png”)
—disable-brotli	boolean	Disabilita completamente la compressione Brotli anche se la versione dell'updater la supporta
—version-exists-ok	boolean	Termina con successo se la versione del bundle esiste già, utile per workflow CI/CD con monorepo
—self-assign	boolean	Consenti ai dispositivi di unirsi automaticamente al channel (aggiorna l'impostazione)
—qr-preview	boolean	Stampa un QR code nel terminale per l'anteprima di questo bundle dopo l'upload
—send-update-notification	boolean	Invia una notifica nativa di controllo aggiornamenti ai dispositivi dopo aver aggiornato i bundle dei canali collegati
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)
—verbose	boolean	Attiva l'output verbose con log dettagliati

🧪 Compatibilità

npx @capgo/cli@latest bundle compatibility

🧪 Verifica la compatibilità di un bundle con un canale specifico in Capgo Cloud per garantire aggiornamenti sicuri.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
-c	string	Canale per verificare la compatibilità
—text	boolean	Outputta testo invece di emoji
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)
—node-modules	string	Percorsi delle directory node_modules per i monorepo (separati da virgola)
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

🔹 ReleaseType

npx @capgo/cli@latest bundle releaseType

🧭 Stampa “native” o “OTA” in base alla compatibilità con gli ultimi metadati di un canale.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
-c	string	Canale da confrontare
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)
—node-modules	string	Percorsi delle directory node_modules per i monorepo (separati da virgola)
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

🗑️ Elimina

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Elimina un bundle specifico da Capgo Cloud, opzionalmente per una singola versione.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

📋 Elenco

Alias: l

npx @capgo/cli@latest bundle list

📋 Elenca tutti i bundle caricati per un'app su Capgo Cloud.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarti al tuo account
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

🧹 Pulizia

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Elimina i vecchi bundle in Capgo Cloud, mantenendo un numero specifico di versioni recenti. I bundle collegati ai canali vengono preservati, a meno che non si usi —ignore-channel.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-b	string	Numero di versione del bundle dell'app da eliminare
-a	string	chiave API per collegarti al tuo account
-k	string	Numero di versioni da mantenere
-f	boolean	Forza la rimozione
—ignore-channel	boolean	Elimina i bundle anche se collegati a canali (ATTENZIONE: elimina anche i canali)
—supa-host	string	URL host Supabase personalizzato (per self-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anon Supabase personalizzata (per self-hosting)

🔒 Crittografa

npx @capgo/cli@latest bundle encrypt

🔒 Crittografa un bundle zip per l'archiviazione esterna sicura. Restituisce ivSessionKey per l'upload/decifratura. Ottieni il checksum con ‘bundle zip —json’.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
—key	string	Percorso personalizzato per la chiave di firma
—key-data	string	Chiave di firma privata
-j	boolean	Output in formato JSON
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)

🔓 Decripta

npx @capgo/cli@latest bundle decrypt

🔓 Decrypt di un bundle cifrato (principalmente per test). Stampa la chiave di sessione base64 per verifica.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
—key	string	Percorso personalizzato per la chiave di firma
—key-data	string	Chiave di firma privata
—checksum	string	Checksum del bundle, per verificarne l'integrità
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea un file zip del tuo bundle dell'app.\nRestituisce il checksum per la crittografia. Usa —json per un output leggibile dalle macchine.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-p	string	Percorso della cartella da caricare; se non specificato, userà il webDir impostato in capacitor.config
-b	string	Numero di versione del bundle per nominare lo zip
-n	string	Nome del file zip
-j	boolean	Output in formato JSON
—no-code-check	boolean	Ignora il controllo che notifyAppReady() sia chiamato nel sorgente code e che index sia nella cartella root
—key-v2	boolean	Usa la crittografia v2
—package-json	string	Percorsi dei file package.json per i monorepo (separati da virgola)