📦 bundle

📦 Gestisci i pacchetti dell'applicazione per la distribuzione in Capgo Cloud, inclusa l'upload, le verifiche di compatibilità e la crittografia.

⬆️ Carica

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Carica un nuovo pacchetto dell'applicazione in 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 esterna: Memorizza solo un collegamento URL (utile per le app >200MB o per le esigenze di privacy). Capgo non esamina 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

Opzioni:

Parametro	Tipo	Descrizione
-a	string	API chiave per collegarsi al tuo account
-p	string	Percorso del folder da caricare, se non fornito utilizzerà il webDir impostato in capacitor.config
-c	string	Canale da collegare. Utilizza virgole per più canali, ad esempio production,beta
—rollout	string	Imposta il bundle caricato come obiettivo di distribuzione per questo canale a un percentuale da 0 a 100
—rollout-percentage-bps	string	Imposta la percentuale di distribuzione del bundle caricato in punti base da 0 a 10000
—rollout-cache-ttl-seconds	string	Cloudflare tempo di scadenza della cache della decisione di distribuzione in secondi
-e	string	Collega all'URL esterno al posto del caricamento su Capgo Cloud
—iv-session-key	string	Imposta la chiave di IV e di sessione per l'URL del bundle esterno
—s3-region	string	Regione per il tuo bucket S3
—s3-apikey	string	Chiave API per il tuo endpoint S3
—s3-apisecret	string	Chiave segreta API per il tuo endpoint S3
—s3-endpoint	string	URL dell'endpoint S3
—s3-bucket-name	string	Nome per il tuo bucket S3 AWS
—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 pacchetto nella console
—no-key	boolean	Ignora la chiave di firma e invia l'aggiornamento chiaro
—no-code-check	boolean	Ignora la verifica se notifyAppReady() è chiamato nel file sorgente code e l'indice presente nella cartella radice
—display-iv-session	boolean	Mostra nella console la chiave di IV e la sessione utilizzate per cifrare l'aggiornamento
-b	string	Numero di versione del bundle da caricare
—link	string	Collegamento a una risorsa esterna (ad esempio GitHub rilascio)
—comment	string	Commento su questa versione, potrebbe essere un messaggio di rilascio, un hash di commit, un messaggio di commit, ecc.
—min-update-version	string	Versione minima richiesta per aggiornarsi a questa versione. Utilizzato solo se l'aggiornamento automatico è disabilitato nel canale
—auto-min-update-version	boolean	Imposta la versione di aggiornamento minima in base ai pacchetti nativi
—ignore-metadata-check	boolean	Ignora il controllo dei metadati (node_modules) durante l'upload
—fail-on-incompatible	boolean	Fallire l'upload (uscire con codice di uscita non zero) invece di caricare quando il bundle è incompatibile con i pacchetti nativi del canale. In un terminale interattivo puoi ancora scegliere una costruzione nativa; rifiutare fallisce. Non può essere combinato con —ignore-metadata-check.
—ignora-checksum-check	boolean	Ignores il controllo del checksum quando si carica
—forza-crc32-checksum	boolean	Forza il controllo CRC32 per l'upload (sovrascrive la detezione automatica)
—timeout	string	Timeout per il processo di upload in secondi
—multipart	boolean	[DEPRECATED] Usare —tus invece. Utilizza il protocollo multipart per gli upload S3
—zip	boolean	Carica il bundle utilizzando zip a Capgo cloud (legacy)
—tus	boolean	Carica il bundle utilizzando TUS su Capgo cloud
—tus-chunk-size	string	Dimensione del chunk in byte per le upload TUS ripristinabili (predefinito: auto)
—partial	boolean	[DEPRECATED] Utilizza —delta invece. Carica aggiornamenti incrementali
—partial-only	boolean	[DEPRECATED] Utilizza —delta-only invece. Carica solo aggiornamenti incrementali, saltare il bundle completo
—delta	boolean	Carica aggiornamenti delta (solo file modificati) per aggiornamenti istantanei e velocissimi al posto di download zip grandi
—delta-only	boolean	Carica solo aggiornamenti delta senza bundle completo per massima velocità (utile per app grandi)
—no-delta	boolean	Disabilita gli aggiornamenti delta anche se gli aggiornamenti istantanei sono abilitati
– checksum cifrato	string	Un checksum cifrato (firma). Utilizzato solo quando si carica un bundle esterno.
– impostazione bundle automatica	boolean	Imposta il bundle in capacitor.config.json
– caricamento secco del bundle	boolean	Carica in modo secco il processo del bundle: aggiungi la riga nel database senza caricare file o aggiornare canali (Usato da Capgo per test interni)
– file package.json	string	Percorso ai file package.json per i monorepos (separati da virgole)
– directory node_modules	string	Per il percorso ai directory node_modules per i monorepos (separati da virgole)
– cifra parziale	boolean	Crittografa i file di aggiornamento delta (abilitato automaticamente per l'aggiornatore > 6.14.4)
—elimina-bundle-collegato-all'upload	boolean	Trova il bundle collegato attualmente nel canale a cui si sta cercando di caricare, e lo elimina
—nessun-modello-brotli	string	File da escludere dalla compressione Brotli (glob separati da virgole, ad esempio, “.jpg,.png”)
—disabilita-brotli	boolean	Disabilita completamente la compressione Brotli anche se la versione dell'aggiornatore lo supporta
—esiste-versione-ok	boolean	Esegui con successo se la versione del bundle esiste già, utile per i flussi di lavoro CI/CD con progetti monorepos
—assegna-si-stesso	boolean	Consenti ai dispositivi di unirsi automaticamente a questo canale (impostazione aggiornamento canale)
—qr-preview	boolean	Stampa un QR code del terminale per questa anteprima del pacchetto dopo l'upload
—send-update-notification	boolean	Invia una notifica di controllo aggiornamento nativa ai dispositivi dopo l'aggiornamento dei pacchetti dei canali collegati
—supa-host	string	URL host personalizzato di Supabase (per auto-hosting o Capgo sviluppo)
—supa-anon	string	Chiave anon personalizzata di Supabase (per auto-hosting)
—verbose	boolean	Abilita l'output dettagliato con registrazione di logging

🧪 Compatibilità

npx @capgo/cli@latest bundle compatibility

🧪 Verifica la compatibilità di un bundle con un canale specifico in Capgo Cloud per assicurarti che gli aggiornamenti siano sicuri.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-a	string	API chiave per collegarsi al proprio account
-c	string	Canale per verificare la compatibilità con
—testo	boolean	Testo di output al posto degli emoji
—package-json	string	Periferiche per file package.json per progetti monorepo (separate da virgola)
—node-modules	string	Periferiche per directory node_modules per progetti monorepo (separate da virgola)
—supa-host	string	URL host personalizzato di Supabase (per auto hosting o Capgo sviluppo)
—supa-anon	string	Chiave anonima personalizzata di Supabase (per l'hosting self-service)

🔹 Tipo di rilascio

npx @capgo/cli@latest bundle releaseType

🧭 Stampa “nativo” o “OTA” in base alla compatibilità con i metadati più recenti di un canale.

Esempio:

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

Opzioni:

Parametro	Tipo di dati	Descrizione
-a	string	API chiave per collegarsi al proprio account
-c	string	Canale da confrontare
—package-json	string	Periferiche per file package.json per progetti monorepo (separate da virgola)
—node-modules	string	Periferiche per directory node_modules per progetti monorepo (separate da virgola)
—supa-host	string	URL host personalizzato di Supabase (per hosting self o Capgo sviluppo)
—supa-anon	string	Chiave anonima personalizzata per Supabase (per l'hosting self-service)

🗑️ Elimina

Alias: d

npx @capgo/cli@latest bundle delete

Elimina un bundle specifico da Capgo Cloud, facoltativamente con un riferimento a una versione singola.

Esempio:

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

Opzioni:

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

📋 Elenco

Alias: l

npx @capgo/cli@latest bundle list

📋 Elenco di tutti i pacchetti caricati per un'app in Capgo Cloud.

Esempio:

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

Opzioni:

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

🧹 Pulizia

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Elimina gli archivi vecchi in Capgo Cloud, mantenendo il numero specificato di versioni recenti. Gli archivi collegati ai canali sono preservati a meno che non si utilizzi —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'applicazione da cancellare
-a	string	API chiave per collegarsi al tuo account
-k	string	Numero di versioni da mantenere
-f	boolean	Rimozione forzata
—ignora-canale	boolean	Elimina i bundle anche se collegati a canali (AVVISO: elimina anche i canali)
—supa-host	string	URL del host Supabase personalizzato (per hosting self o Capgo sviluppo)
—supa-anon	string	Chiave anonima Supabase personalizzata (per hosting self)

🔒 Crittografa

npx @capgo/cli@latest bundle encrypt

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

Esempio:

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

Opzioni:

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

🔓 Sforna

npx @capgo/cli@latest bundle decrypt

Sforna un bundle crittografato (principalmente per le prove). Stampa la chiave di sessione base64 per la verifica.

Esempio:

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

Opzioni:

Parametro:	Tipo	Descrizione
—chiave	string	Percorso personalizzato per la chiave di firma privata
—chiave-dati	string	Chiave di firma privata
—checksum	string	Checksum del pacchetto, per verificare l'integrità del pacchetto
—package-json	string	Percorsi dei file package.json per i monorepos (separati da virgole)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea un file zip del tuo bundle dell'applicazione. Restituisce il checksum per l'uso con l'encryption. Utilizza —json per l'output leggibile da macchina.

Esempio:

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

Opzioni:

Parametro	Tipo	Descrizione
-p	string	Percorso del folder da caricare, se non fornito utilizzerà il webDir impostato in capacitor.config
-b	string	Numero di versione del bundle per denominare il file zip
-n	string	Nome del file zip
-j	boolean	Esegui in formato JSON
—no-code-check	boolean	Ignora la verifica se notifyAppReady() è chiamato nel file sorgente code e indice presente nella cartella radice
—key-v2	boolean	Usa l'encryption v2
—package-json	string	Percorso dei file package.json per progetti monorepo (separati da virgole)