Pacchetto 📦

📦 Gestisci i pacchetti di 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 di applicazione in Capgo Cloud per la distribuzione. La versione deve essere > 0.0.0 e univoca. Le versioni cancellate 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

Aggiorna automaticamente la prossima versione semver disponibile nel canale (o l'ultima versione remota dell'applicazione) se non viene fornito --bundleUtile in CI quando package.json già corrisponde a una versione 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 manifesto delta del canale precedente Capgo, inferisce major | minor | patch | metadata, e stampa una breve ragione nel CLI log. Se non esiste alcuna versione precedente Capgo, l'AI viene saltata e l'aggiornamento predefinito è patch.

Opzioni:

Parametri	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 le virgole per più canali, ad esempio production,beta
—rollout	string	Imposta il bundle caricato come obiettivo di distribuzione del canale a un percentuale da 0 a 100
—stable	boolean	In un canale configurato per la distribuzione, sostituisci il fallback stabile anziché impostare il target di distribuzione
—percentuale-di-distribuzione-bps	string	Imposta la percentuale di distribuzione del bundle caricato in punti base da 0 a 10000
—ttl-cache-decision-rollout-secondi	string	Cloudflare tempo di scadenza della cache delle decisioni di distribuzione in secondi
-e	string	Collega all'URL esterno anziché caricare su Capgo Cloud
—chiave-di-sessione-IV	string	Imposta la chiave di sessione e IV per l'URL del bundle esterno
—regione-S3	string	Regione del tuo bucket S3
—chiave-di-accesso-S3	string	API chiave per il tuo endpoint S3
—s3-apisecret	string	API segreto per il tuo endpoint S3
—s3-endpoint	string	URL del tuo endpoint S3
—nome-bucket-s3	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)
—url-del-bundle	boolean	Stampa l'URL del bundle nella console
—senza-chiave	boolean	Ignora la chiave di firma e invia l'aggiornamento chiaro
—senza-verifica-code	boolean	Ignora la verifica se notifyAppReady() è chiamata nella sorgente code e l'indice presente nella cartella radice
—mostra-sessione-iv	boolean	Mostra nella console la chiave IV e di sessione utilizzate per cifrare l'aggiornamento
-b	string	Numero di versione del bundle da caricare
—auto-bump	string	Incrementa automaticamente dalla versione del bundle collegata al canale, altrimenti la versione più recente dell'app remota. Livello: maggiore, minore (predefinito), patch (alias riparo), metadati, o ai (Workers AI inferisce il livello dal manifesto locale vs precedente delta; ricade su patch senza precedente versione Capgo. Bump fino a quando non viene trovato un nome libero (i nomi eliminati occupano ancora il posto). Non può essere combinato con —bundle (-b)
—link	string	Collegamento a risorsa esterna (ad esempio GitHub rilascio)
—comment	string	Commento su questa versione, potrebbe essere una nota 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 per i metadati nel canale
—auto-min-update-version	boolean	Imposta la versione di aggiornamento minima basata sui pacchetti nativi
—ignore-metadata-check	boolean	Ignores il controllo dei metadati (node_modules) durante l'upload
---falla-in-compatibilità	boolean	Fai fallire l'upload (uscire con un codice di uscita non zero) al posto di caricare quando il bundle è incompatibile con i pacchetti nativi del canale corrente. In un terminale interattivo puoi ancora scegliere una costruzione nativa; rifiutando fallisci. Non può essere combinato con ---ignora-controllo-metadati.
---ignora-controllo-somma	boolean	Ignores il controllo della somma durante l'upload
---forza-controllo-somma-crc32	boolean	Forza il controllo della somma CRC32 per l'upload (sovrascrive la detezione automatica)
---timeout	string	Timeout per il processo di upload in secondi
---multipart	boolean	[DEPRECATED] Utilizza —tus invece. Utilizza il protocollo multipart per gli upload S3
---zip	boolean	Carica il bundle utilizzando zip su 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 (impostazione predefinita: auto)
—partial	boolean	[DEPRECATED] Utilizza —delta invece. Carica aggiornamenti incrementali
—partial-only	boolean	[DEPRECATED] Utilizza —delta-only invece. Carica solo aggiornamenti incrementali, saltando il bundle completo
—delta	boolean	Carica aggiornamenti delta (solo file modificati) per aggiornamenti istantanei e velocissimi al posto dei grandi download zip
—delta-only	boolean	Carica solo le differenze degli aggiornamenti senza il bundle completo per massimizzare la velocità (utile per le grandi app)
—no-delta	boolean	Disabilita le differenze degli aggiornamenti anche se gli aggiornamenti istantanei sono abilitati
—checksum-crittografato	string	Un checksum crittografato (firma). Utilizzato solo quando si carica un bundle esterno
—impostazione-automatica-bundle	boolean	Imposta il bundle in capacitor.config.json
—carica-senza-effetti	boolean	Carica a secco il processo del bundle: aggiungi la riga nel database senza caricare file o aggiornare canali (Usato da Capgo per test interni)
—file-json-del-progetto	string	Percorsi ai file json del progetto per i monorepos (separati da virgole)
—moduli-node	string	Perimetri dei directory node_modules per progetti monorepo (separati da virgola)
—cifra-parziale	boolean	Cifra i file di aggiornamento delta (abilitato automaticamente per aggiornatore > 6.14.4)
—elimina-bundle-collegato-all'upload	boolean	Localizza il bundle collegato attualmente nel canale che stai cercando di caricare e lo elimina
—no-patterni-brotli	string	File da escludere dalla compressione Brotli (globs separati da virgola, ad esempio “.jpg,.png”)
—disabilita-brotli	boolean	Disabilita completamente la compressione Brotli anche se la versione dell'aggiornatore lo supporta
—versione-esiste-ok	boolean	Esci con successo se la versione del bundle esiste già, utile per i flussi di lavoro CI/CD con monorepos
---self-assign	boolean	Consenti ai dispositivi di unirsi automaticamente a questo canale (aggiorna impostazione del canale)
---qr-preview	boolean	Stampa un QR code del terminale per questa anteprima del bundle dopo l'upload
---send-update-notification	boolean	Invia una notifica di controllo dell'aggiornamento nativa ai dispositivi dopo l'aggiornamento dei bundle collegati del canale
---supa-host	string	URL host personalizzato di Supabase (per l'auto-hosting o lo sviluppo Capgo)
---supa-anon	string	Chiave anonima personalizzata di Supabase (per l'auto-hosting)
---verbose	boolean	Abilita l'output dettagliato con registrazione dettagliata

🧪 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	Visualizza il testo al posto degli emoji
—package-json	string	Periferiche per file package.json nei progetti monorepo (separate da virgola)
—node-modules	string	Periferiche per directory node_modules nei progetti monorepo (separate da virgola)
—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)

🔹 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:

Parametri	Tipo	Descrizione
-a	string	API chiave per collegarsi al tuo account
-c	string	Canale da confrontare
—package-json	string	Periferiche per file package.json nei monorepos (separate da virgole)
—node-modules	string	Periferiche per directory node_modules nei monorepos (separate da virgole)
—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)

🗑️ Elimina

Alias: d

npx @capgo/cli@latest bundle delete

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

Esempio:

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

Opzioni:

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

📋 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 l'hosting self o lo sviluppo Capgo)
—supa-anon	string	Chiave anonima personalizzata di Supabase (per l'hosting self)

🧹 Pulizia

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Elimina vecchi bundle in Capgo Cloud, mantenendo il numero specificato di versioni recenti. I bundle 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:

Param	Tipo	Descrizione
-b	string	Numero di versione del pacchetto dell'applicazione da eliminare
-a	string	API chiave per collegare il tuo account
-k	string	Numero di versioni da mantenere
-f	boolean	Forzare rimozione
—ignore-channel	boolean	Elimina i pacchetti anche se collegati a canali (AVVISO: elimina anche i canali)
—supa-host	string	URL host personalizzato di Supabase (per hosting self o sviluppo Capgo)
—supa-anon	string	Chiave anonima personalizzata di Supabase (per hosting self)

🔒 Crittografare

npx @capgo/cli@latest bundle encrypt

🔒 Cifra un archivio zip per una memorizzazione esterna sicura. Restituisce ivSessionKey per l'upload/decrittazione. Ottieni il checksum utilizzando ‘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 privata
—key-data	string	Chiave di firma privata
-j	boolean	Output in formato JSON
—package-json	string	Permessi di accesso ai file package.json per progetti monorepo (separati da virgola)

🔓 Decrittografare

npx @capgo/cli@latest bundle decrypt

Decrittografa un bundle crittografato (principalmente per test).

Stampa la chiave di sessione base64 per la verifica.

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

Opzioni:

Param	Tipo	Descrizione
—chiave	string	Percorso personalizzato per la chiave di firma privata
—chiave-dati	string	Chiave di firma privata
—checksum	string	Checksum del bundle, per verificare l'integrità del bundle
—package-json	string	Permessi per i file package.json per i monorepositori (separati da virgole)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea un file zip del tuo bundle di app. 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 da utilizzare per il nome del file zip
-n	string	Nome del file zip
-j	boolean	Output in formato JSON
—no-code-check	boolean	Ignora la verifica se notifyAppReady() è chiamata nel file source code e indice presente nella cartella radice
—key-v2	boolean	Utilizza l'encryption v2
—package-json	string	Permessi di accesso ai file package.json per progetti monorepo (separati da virgola)