📦 pacchetto

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

⬆️ Carica

Alias: u

npx @capgo/cli@latest bundle upload

Carica un nuovo bundle di app in Capgo Cloud per la distribuzione. La versione deve essere > 0.0.0 e unica. Le versioni cancellate non possono essere riutilizzate per motivi di sicurezza. Opzione esterna: Memorizza solo un collegamento URL (utile per app >200MB o requisiti 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 dal canale (o la versione più recente dell'app remota) quando non si passa --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 I lavoratori AI confrontano i file del bundle locale con il manifesto delta del canale precedente Capgo, inferiscono major | minor | patch | metadata, e stampa una breve ragione nel CLI log. Se non esiste una versione precedente Capgo, l'AI viene saltato e il bump si riduce a patch.

Opzioni:

Parametro	Tipo	context
-a	string	tasto API 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. Utilizzare virgole per più canali, ad esempio production,beta
—rollout	string	Imposta il bundle caricato come obiettivo di distribuzione per il canale specificato a un percentuale da 0 a 100
—stable	boolean	Sostituisci il fallback stabile su un canale configurato per la distribuzione, anziché impostare il target di distribuzione.
—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 rollout decision cache TTL in seconds
-e	string	Collega un URL esterno al posto di caricare su Capgo Cloud
—iv-session-key	string	Imposta la chiave IV e di sessione per l'URL del bundle esterno
—s3-region	string	Regione per il tuo bucket S3
—s3-apikey	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
—porta-s3	string	Porta per il tuo endpoint S3
—no-ssl-s3	boolean	Disabilita SSL per l'upload S3
—chiave-v2	string	Percorso personalizzato per la chiave di firma privata (sistema v2)
—chiave-dati-v2	string	Chiave di firma privata (sistema v2)
—url-bundle	boolean	Stampa l'URL del bundle nella console
—no-key	boolean	Ignora la chiave di firma e invia l'aggiornamento in chiaro
—no-code-check	boolean	Ignora il controllo se notifyAppReady() è chiamato nella sorgente code e l'indice presente nella cartella radice
—display-iv-session	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 locale vs precedente manifesto delta; ricade sul patch con nessuna versione precedente Capgo). Incrementa fino a quando non viene trovato un nome libero (i nomi eliminati restano occupati). Non può essere combinato con —bundle (-b)
—link	string	Collegamento a risorsa esterna (ad esempio GitHub release)
---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. Usato solo se l'aggiornamento automatico è disabilitato nel canale
---auto-min-update-version	boolean	Imposta la versione di aggiornamento minima basata sui pacchetti nativi
---ignore-metadata-check	boolean	Ignota la verifica dei metadati (node_modules) durante l'upload
---fail-on-incompatible	boolean	Fallisce l'upload (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 ---ignore-metadata-check.
---ignore-checksum-check	boolean	Ignota la verifica del checksum durante l'upload
—checksum-crc32-forzato	boolean	Forzare checksum CRC32 per l'upload (sovrascrivere 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 a Capgo cloud (legacy)
—tus	boolean	Carica il bundle utilizzando TUS a Capgo cloud
—tus-size-di-blocco	string	Dimensione del blocco in byte per gli upload TUS ripristinabili (predefinito: auto)
---parziale	boolean	[DEPRECATO] Utilizza ---delta invece. Carica aggiornamenti incrementali
---parziale-solo	boolean	[DEPRECATO] Utilizza ---delta-solo invece. Carica solo aggiornamenti incrementali, saltare bundle completo
---delta	boolean	Carica aggiornamenti delta (solo file modificati) per aggiornamenti istantanei e super-veloci al posto di download zip grandi
---delta-solo	boolean	Carica solo aggiornamenti delta senza bundle completo per massima velocità (utile per app grandi)
---senza-delta	boolean	Disabilita aggiornamenti delta anche se gli aggiornamenti istantanei sono abilitati
---checksum-crittografato	string	Un checksum crittografato (firma). Utilizzato solo quando si carica un bundle esterno
—auto-set-bundle	boolean	Imposta il bundle in capacitor.config.json
—dry-upload	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)
—package-json	string	Permessi per file package.json per progetti monorepo (separati da virgola)
—node-modules	string	Permessi per directory node_modules per progetti monorepo (separati da virgola)
—encrypt-partial	boolean	Crittografa file di aggiornamento delta (abilitato automaticamente per aggiornatore > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Trova il bundle attualmente collegato nel canale che stai cercando di caricare, e lo cancella
—no-brotli-patterns	string	File da escludere dalla compressione Brotli (glob separati da virgole, ad esempio “.jpg,.png”)
—disable-brotli	boolean	Disabilita completamente la compressione Brotli anche se la versione dell'aggiornatore lo supporta
—version-exists-ok	boolean	Esegui con successo se la versione del bundle esiste già, utile per i flussi di lavoro CI/CD con progetti monorepo
—self-assign	boolean	Allow devices to auto-join this channel (updates channel setting)
—qr-preview	boolean	Stampa un QR code terminale per questa anteprima del bundle dopo l'upload
—invia-notifica-aggiornamento	boolean	Invia una notifica di controllo di aggiornamento nativo ai dispositivi dopo l'aggiornamento dei bundle dei canali collegati
—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 verboso con registrazione dettagliata

🧪 Compatibilità

npx @capgo/cli@latest bundle compatibility

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

Esempio:

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

Opzioni:

Parametro	Tipo	Description
-a	string	tasto API per collegarsi al tuo 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 dei monorepos (separate da virgole)
—node-modules	string	Periferiche per directory node_modules dei monorepos (separate da virgole)
—supa-host	string	URL host personalizzato di Supabase (per auto-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anonima personalizzata di Supabase (per auto-hosting)

🔹 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	Descrizione
-a	string	chiave API per collegarsi al tuo account
-c	string	Canale per 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 auto-hosting o sviluppo Capgo)
—supa-anon	string	Chiave anonima personalizzata di Supabase (per auto-hosting)

🗑️ 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

Optioni:

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

📋 Elenco

Alias: l

npx @capgo/cli@latest bundle list

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

Esempio:

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

Opzioni:

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

🧹 Pulizia

Alias: c

npx @capgo/cli@latest bundle cleanup

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

Parametro	Tipo	Descrizione
-b	string	Numero di versione del pacchetto dell'applicazione da eliminare
-a	string	API chiave per collegarsi al proprio account
-k	string	Numero di versioni da mantenere
-f	boolean	Forzare la rimozione
—ignora-canale	boolean	Elimina i pacchetti anche se collegati a canali (AVVISO: elimina anche i canali)
—supa-host	string	URL host personalizzato di Supabase (per l'hosting self-service o Capgo sviluppo)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🔒 Crittografa

npx @capgo/cli@latest bundle encrypt

Crittografa un archivio zip per un storage esterno sicuro. Restituisce ivSessionKey per l'upload/decrittografia. Ottieni checksum usando ‘bundle zip —json’.

Esempio:

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

Opzioni:

Parametri	Tipo	Descrizione
—chiave	string	Custom path for private signing key
—chiave-dati	string	Chiave di firma privata
-j	boolean	Output in formato JSON
—package-json	string	Perimetri dei file package.json per repository monorepo (separati da virgole)

🔓 Decrittografare

npx @capgo/cli@latest bundle decrypt

🔓 Decrittografare un bundle crittografato (principalmente per test).\nStampa 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	Custom path for private signing key
—key-data	string	Chiave di firma privata
—checksum	string	Checksum del pacchetto, per verificare l'integrità del pacchetto
—package-json	string	Periferiche a package.json per progetti monorepo (separate da virgole)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Crea un file zip del tuo pacchetto di app. Restituisce 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	Output in formato JSON
—no-code-check	boolean	Ignora la verifica se notifyAppReady() è chiamato in source code e indice presente nella cartella root
—key-v2	boolean	Usa l'encryption v2
—package-json	string	Periferiche per file package.json per monorepos (separate da virgola)