🔹 Costruisci

🏗️ Manage native iOS/Android builds through Capgo Cloud.

Accesso e output di costruzione

Native cloud build requests are currently in limited beta and access is restricted. Build credentials are never stored on Capgo servers: they are used only for the build and then deleted. Build outputs can optionally be uploaded with time-limited download links.

Salva le credenziali per primo

npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform ios
npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform android

Cattura un URL di output in CI

Passa --output-record per persistere l'URL di download e il QR code, quindi utilizza build last-output per leggerlo:

npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.json
npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl

🔹 Richiesto

npx @capgo/cli@latest build needed

🧭 Stampa "sì" e esce con code 1 se è richiesta una costruzione nativa; altrimenti stampa "no" e esce con code 0. Le fallite dei comandi escono con code 2.

Esempio:

npx @capgo/cli@latest build needed com.example.app --channel production --verbose

Opzioni:

Parametro	Tipo	Descrizione
-a	string	chiave API per collegarsi al tuo account
-c	string	Canale di riferimento per la comparazione. Predefinito su CapacitorUpdater.defaultChannel o il canale predefinito pubblico
—package-json	string	Permessi per file package.json dei monorepos (separati da virgole)
—node-modules	string	Permessi per directory node_modules dei monorepos (separati da virgole)
—verbose	boolean	Abilita l'output dettagliato con registrazione di logging
—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)

🚀 Inizia

Alias: onboarding

npx @capgo/cli@latest build init

Configura le credenziali di costruzione in modo interattivo (iOS: certificati + profili automatizzati; Android: keystore + Google OAuth fornisce account di servizio di GCP e invita alla console di gioco)

Opzioni:

Parametro	Tipo	Descrizione
-a	string	API chiave per collegarsi al tuo account
-p	string	Piattaforma per l'onboarding (ios o android). Se omesso, auto-detecta quando esiste solo una cartella nativa; sollecita altrimenti.
– supa-host	string	URL host personalizzato di Supabase (per l'hosting self o lo sviluppo Capgo)
– no-analytics	boolean	Disabilita l'analisi di onboarding e la riproduzione del terminale per questa esecuzione

🔹 Richiesta

npx @capgo/cli@latest build request

Richiedi un build nativo da Capgo Cloud. Questo comando comprimerà il tuo progetto directory e lo invierà a Capgo per la costruzione. Il build sarà elaborato e inviato direttamente alle app store. Le credenziali non sono mai memorizzate sui server Capgo; vengono eliminate dopo il build. Salvali prima di richiedere un build:

npx @capgo/cli build credentials save --appId APP_ID --platform ios

Esempio:

npx @capgo/cli@latest build request com.example.app --platform ios --path .

Opzioni:

Parametro	Tipo	Descrizione
—path	string	Percorso del directory del progetto da costruire (predefinito: directory corrente)
—node-modules	string	Percorsi dei directory node_modules per i monorepos (separati da virgole)
—piattaforma	string	Piattaforma di destinazione: ios o android (obbligatorio)
– modalità di costruzione	string	Modalità di costruzione: debug o rilascio (predefinito: rilascio)
– base64 del certificato di costruzione	string	iOS: Certificato base64 codificato .p12
– password del certificato .p12	string	iOS: Password del certificato (facoltativo se il certificato non ha password)
– email Apple ID	string	iOS: Email dell'ID Apple per l'upload della password specifica dell'app (alternativa alla chiave App Store Connect API)
– password dell'app specifica	string	iOS: Password specifica dell'app (xxxx-xxxx-xxxx-xxxx) per gli upload di TestFlight
– ID dell'app Apple	string	iOS: ID numerico dell'applicazione di App Store Connect (obbligatorio insieme a —apple-id e —apple-app-specific-password)
—apple-key-id	string	iOS: ID chiave di App Store Connect API
—apple-issuer-id	string	iOS: ID rilasciatore di App Store Connect
—apple-key-content	string	iOS: Chiave di App Store Connect API codificata in Base64 (.p8)
—app-store-connect-team-id	string	iOS: ID del team di App Store Connect
—ios-scheme	string	iOS: Schema di Xcode da costruire (predefinito: App)
—ios-target	string	iOS: Impostazione di build Xcode (predefinito: stesso schema)
—ios-distribution	string	iOS: Modalità di distribuzione
—ios-provisioning-profile	string	iOS: Percorso del profilo di provisioning o bundleId=path mapping (ripetibile)
—android-keystore-file	string	Android: File di keystore codificato in Base64
—keystore-key-alias	string	Android: Alias della chiave del keystore
—keystore-key-password	string	Android: Password della chiave del keystore
—keystore-store-password	string	Android: Password del magazzino delle chiavi
—play-config-json	string	Android: Account Google Play servizi JSON codificato in Base64
—android-flavor	string	Android: Flavore del prodotto da costruire (ad esempio, produzione). Richiesto se il progetto ha più gusti.
—android-track	string	Android: Tracciato Google Play per questo upload (interno, alpha, beta, produzione). Predefinito senza —submit-to-store-review: interno. Con —submit-to-store-review e nessun tracciato impostato: produzione. Precedenza: CLI > ambiente > credenziali salvate
—android-release-status	string	Android: Stato di rilascio Google Play (bozza, completato, in corso, sospeso). Predefinito senza —submit-to-store-review: bozza. Con —submit-to-store-review e nessun stato impostato: completato. Precedenza: CLI > ambiente > credenziali salvate
—in-app-update-priority	string	Android: Priorità dell'aggiornamento in-app Google Play per questo rilascio (intero 0–5; più alto = più urgente). Vedi https://developer.android.com/guide/playcore/in-app-updates. Precedenza: CLI > ambiente > credenziali salvate
—no-playstore-upload	boolean	Saltare l'upload su Play Store per questa costruzione (annulla la configurazione di play salvata). Richiede —output-upload.
—submit-to-store-review	boolean	Dopo l'upload, invia la versione di store per la revisione al posto di lasciarla come bozza/costruzione inattiva. Su Android questo predefinito per il tracciato di produzione con stato di rilascio completato (sovrascrivi con —android-track / PLAY_STORE_TRACK e —android-release-status / PLAY_STORE_RELEASE_STATUS). Su iOS invia la costruzione elaborata di TestFlight per la revisione di App Store.
—store-release-name	string	Nome/vers. della versione di store. L'Android invia questo come version_name di Google Play; l'iOS lo utilizza come versione di App Store quando si crea o si riutilizza la versione modificabile.
—store-release-notes	string	Note di versione di store predefinite. L'Android utilizza questo come changelog di Play; l'iOS lo utilizza come testo 'What’s New' di App Store di default.
—store-release-notes-locale	string	Note di versione di store localizzate (ripetibili), ad esempio —store-release-notes-locale en-US=“Bug fixes” —store-release-notes-locale fr-FR=“Correzioni”.
—ios-testflight-groups	string	iOS: opzionale, elenco separato da virgole dei nomi o ID dei gruppi di TestFlight per la distribuzione beta esterna.
—ios-automatic-release	boolean	iOS: rilascia automaticamente la versione dell'App Store dopo l'approvazione di Apple. Impostazione predefinita: rilascio manuale.
—no-ios-automatic-release	boolean	iOS: mantiene la versione dell'App Store in attesa di un rilascio manuale dopo l'approvazione di Apple.
—output-upload	boolean	Attiva l'override del comportamento di caricamento degli output per questa sola costruzione (abilita). Precedenza: CLI > ambiente > credenziali salvate
—no-output-upload	boolean	Sospendi l'override del comportamento di caricamento degli output per questa sola costruzione (disabilita). Precedenza: CLI > ambiente > credenziali salvate
—output-retention	string	Attiva l'override della durata della link degli output per questa sola costruzione (1h a 7d). Esempi: 1h, 6h, 2d. Precedenza: CLI > ambiente > credenziali salvate
—output-record	string	After un buon build, scrivi un record JSON (jobId, stato, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) in un percorso. Un QR code in PNG viene anche scritto accanto a quel percorso con il .qr.png Leggi i campi di nuovo con build last-output.
senza cache	boolean	Saltare il ripristino della cache di build e non salvare un nuovo elemento di cache per questo build. La cache di build è abilitata per impostazione predefinita per app.
chiave di cache	string	Dividi la cache di build per ambiente, branch o flavor Android (ad esempio prod, stagingOmettere per una cache condivisa predefinita per app.
non saltare l'incremento del numero di build	boolean	Sovrascrivi le credenziali salvate per riabilitare l'incremento automatico del numero di build per questo build solo.
non saltare l'incremento della versione di marketing	boolean	Saltare l'aumento automatico della versione di marketing (CFBundleShortVersionString / versionName) quando l'app è già rilasciata.
–sync-ios-version	boolean	IOS: sincronizza la versione di marketing di Xcode dal package.json prima di caricare il progetto.
–ai-analytics	boolean	In caso di fallimento della costruzione, invia i log a Capgo AI per la diagnosi. In terminal interattivi questo salta la conferma iniziale; in CI questo carica automaticamente e stampa l'analisi su stderr.
–no-prescan	boolean	Saltare lo scansionamento pre-costruzione automatico
–prescan-ignore-fatal	boolean	Eseguire lo scansionamento pre-costruzione ma non bloccare mai la costruzione (rilasciare solo avvisi)
–prescan-skip	string	Saltare specifiche verifiche di scansionamento pre-costruzione (ripetibili o separate da virgole) per ID (ripetibili o separate da virgole). Le altre verifiche sono ancora eseguite.
–prescan-warn	string	Abbassare la soglia di avviso per il controllo prescan specifico (ripetibile o separato da virgola). Il controllo viene ancora eseguito.
---falla-su-avvisi	boolean	Considera le avvertenze prescan come fatali
---invia-log-in-supporto	boolean	In caso di fallimento del build CI/CD, invia automaticamente i log del build a Capgo supporto (nessun indirizzo email richiesto). Capgo supporto viene informato e seguirà con un'email. Aggiuntivo a —ai-analitiche.
---invia-log	boolean	Alias deprecato per —invia-log-in-supporto
-a	string	API chiave per collegarsi al proprio account
---host-supabase-personalizzato	string	URL di host personalizzato di Supabase (per l'auto-hosting o lo sviluppo Capgo)
---supabase-anonimo	string	Chiave anonima personalizzata per Supabase (per hosting self-service)
– dettagliato	boolean	Abilita l'output dettagliato con registrazione di logging

Caching di costruzione: Capgo ripristina e salva gli artefatti nativi compilati (CocoaPods, Gradle e relative uscite) per app di default. Utilizza --cache-key per mantenere separati i cache RC e di produzione; utilizza --no-cache per una pulizia di costruzione unica. Le integrazioni API possono passare cache_key o cache_enabled: false HTML testo frammento da una stringa UI Capgo più lunga (chiave genitrice `alternatives_cta_questions`). Pagina/area: pagina di confronto delle alternative di aggiornamento live di Capacitor. Ruolo: lungo paragrafo di marketing o legale. Visto in: pagina alternatives.astro. Preservare i termini di prodotto e marchio Capgo e i termini di sviluppatore esattamente. Chiave messaggio `alternatives_cta_questions` (Domande di azione per alternative). | Testo frammento HTML da una stringa UI Capgo più lunga (chiave genitrice `appflow_cta_questions`). Pagina/area: copia di marketing di confronto/migrazione di Appflow. Ruolo: lungo paragrafo di marketing o legale. Visto in: pagina ionic-appflow.astro. Preservare i termini di prodotto e marchio Capgo e i termini di sviluppatore esattamente. Chiave messaggio `appflow_cta_questions` (Domande di azione per Appflow). | Testo frammento HTML da una stringa UI Capgo più lunga (chiave genitrice `capwesome_cta_questions`). Pagina/area: pagina di confronto di Capawesome. Ruolo: lungo paragrafo di marketing o legale. Visto in: pagina capwesome.astro. Preservare i termini di prodotto e marchio Capgo e i termini di sviluppatore esattamente. Chiave messaggio `capwesome_cta_questions` (Domande di azione per Capawesome). | Pagina/area: pagina di servizi di consulenza. Ruolo: sottotitolo di sezione o didascalia. Visto in: pagina consulting.astro. Preservare i termini di prodotto e marchio Capgo e i termini di sviluppatore esattamente. Chiave messaggio `consulting_faq_subtitle` (Sottotitolo FAQ per consulenza). | Pagina/area: copia di marketing di confronto/migrazione di Appflow. Ruolo: breve etichetta UI o elemento di navigazione. Visto in: pagina ionic-appflow.astro, pagina ionic-enterprise-plugins.astro, pagina soluzioni/ionic-enterprise-plugins.astro. Chiave messaggio `appflow_plugins_or` (Appflow Plugins o). nel payload della richiesta di costruzione. Vedi Caching di costruzione e.

🔹 Sincronizza-versione-ios

npx @capgo/cli@latest build sync-ios-version

Sincronizza la versione locale di iOS Xcode MARKETING_VERSION da package.json.

Esempio:

npx @capgo/cli@latest build sync-ios-version --path .

Opzioni:

Parametro	Tipo	Descrizione
—percorso	string	Percorso del directory del progetto (predefinito: directory corrente)
—verifica	boolean	Verifica solo; esce con codice non zero quando MARKETING_VERSION è fuori sincronia

🔹 Prelievo

npx @capgo/cli@latest build prescan

Scansiona il tuo progetto e le credenziali salvate per problemi che fallirebbero una costruzione cloud — prima di caricare qualsiasi cosa. Verifica le credenziali (scadenza, password, pairing del profilo), lo stato del progetto (cap sync, layout di node_modules), e la configurazione della piattaforma. Esegue automaticamente all'interno build request; questo comando lo esegue in modo autonomo (ad esempio in CI). Vedi Prelievo controlla per il catalogo completo di controlli e come procedere --skip / --warn Regole individuali.

Opzioni:

Param	Tipo	Descrizione
---piattaforma	string	Piattaforma di destinazione: ios o android (obbligatoria)
---percorso	string	Percorso del directory del progetto (impostazione predefinita: directory corrente)
-a	string	API chiave per collegarsi al proprio account
---flavore android	string	Android: il flavor del prodotto che verrà utilizzato per la costruzione
—ios-dist	string	iOS: modalità di distribuzione per la validazione
—json	boolean	Outputta un rapporto JSON leggibile da macchina
—fail-on-warnings	boolean	Esci con codice di uscita non zero quando sono trovati avvisi (CI)
—ignore-fatal	boolean	Modalità diagnostica: segnala tutto ma esce sempre con codice 0
—skip	string	Saltare specifiche verifiche (ripetibili o separate da virgola) per ID
—warn	string	Abbassare la priorità di un controllo specifico (ripetibile o separato da virgola)
—verbose	boolean	Abilita l'output dettagliato con registrazione di logging
—supa-host	string	URL del host Supabase personalizzato (per hosting self o sviluppo Capgo)
—supa-anon	string	Chiave anonima Supabase personalizzata (per hosting self)

🔹 Ultimo-output

npx @capgo/cli@latest build last-output

Leggi il record dell'output di costruzione scritto da un precedente build request --output-recordStampa il JSON completo di default, un campo singolo con —field, o il QR ASCII code con —qr. Utile in CI per recuperare l'URL di download o il QR per inviarlo nuovamente in un PR o un problema. Esempi: npx @capgo/cli build last-output —path /tmp/build.json npx @capgo/cli build last-output —path /tmp/build.json —field outputUrl npx @capgo/cli build last-output —path /tmp/build.json —qr

Opzioni:

Parametro	Tipo	Descrizione
Percorso	string	Stampa un campo singolo (uno dei seguenti: jobId, appId, piattaforma, buildMode, stato, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion)
Stampa il QR ASCII reso __CAPGO_KEEP_0__ (shortcut per —field qrCodeAscii)	string	Credenziali
Opzioni:	boolean	Print the rendered ASCII QR code (shortcut for —field qrCodeAscii)

🔹 Tipo

Gestisci le credenziali di costruzione memorizzate localmente sul tuo computer. 🔒 SICUREZZA:

• Credenziali salvate in ~/.capgo-credentials/credentials.json (globale) o .capgo-credentials.json (locale)
• Quando si costruisce, inviate a Capgo ma NON vengono archiviati permanentemente
• Cancellate da Capgo immediatamente dopo la costruzione
• Il output di costruzione può essere caricato facoltativamente per collegamenti di download a tempo limitato 📚 DOCUMENTAZIONE: iOS setup: https://capgo.app/docs/cli/cloud-build/ios/ Configurazione Android: https://capgo.app/docs/cli/cloud-build/android/

🔹 Chiave Apple

Alias: asc-key

npx @capgo/cli@latest build credentials apple-key

Creare un team App Store Connect con una chiave API guidata da un helper macOS (solo macOS). Apre una finestra nativa che ti guida attraverso l'interfaccia utente di Apple App Store Connect in un browser incorporato, cattura automaticamente l'ID emittente + ID chiave, intercetta il codice di accesso a una volta, lo valuta contro Apple e lo salva in ~/.appstoreconnect/private_keys. Le statistiche di avanzamento vengono inviate a Capgo analytics (disabilita con CAPGO_DISABLE_TELEMETRY). npx @capgo/cli costruisce le credenziali dell'app apple-key —appId com.example.app

Esempio:

Example:

Opzioni:

Parametro	Tipo	Descrizione
-a	string	Chiave API per collegarsi al tuo account
—appId	string	Salva la chiave catturata nei credenziali di build iOS di questa app
—local	boolean	Salva nei file .capgo-credentials.json per progetto anziché nel file globale
—json	boolean	Stampa la chiave ID / ID emittente / percorso .p8 come JSON

🔹 Salva

npx @capgo/cli@latest build credentials save

Salva le credenziali di build localmente per iOS o Android. Le credenziali sono memorizzate in:

• ~/.capgo-credentials/credentials.json (predefinito, globale)
• capgo-credenziali.json nel root del progetto (con la flag —locale) ⚠️ OBBLIGATORIO PRIMA DELLA COMPILAZIONE: Deve salvare le credenziali prima di richiedere una compilazione. 🔒 Queste credenziali NON sono mai memorizzate permanentemente sui server di Capgo. Sono eliminate immediatamente dopo la compilazione è completata. 📚 Guida di configurazione: iOS: https://capgo.app/docs/cli/build-cloud/ios/ Android: https://capgo.app/docs/cli/build-cloud/android/ npx @capgo/cli build credenziali salva —piattaforma ios
  —certificato ./cert.p12 —password p12 “password”
  —profilo di provisioning ios ./profile.mobileprovision
  —chiave di Apple ./AuthKey.p8 —chiave di Apple “KEY123”
  —ID emittente di Apple “issuer-uuid” —ID team di Apple “team-id” Esempio di compilazione multi-target (app + estensione widget): npx @capgo/cli build credenziali salva —piattaforma ios
  —profilo di provisioning ios ./App.mobileprovision
  —profilo di provisioning ios com.esempio.widget=./Widget.mobileprovision
  ...npx @capgo/cli build credenziali salva —piattaforma android
  –keystore ./release.keystore –keystore-alias “la mia chiave”
  –keystore-key-password “la password della chiave”
  –play-config ./service-account.json Memoria locale (per progetto): npx @capgo/cli build credentials save –locale –piattaforma ios …

Esempio:

iOS Example:

Opzioni:

Parametro	Tipo	Descrizione
–appId	string	ID dell'app (ad esempio, com.example.app) (obbligatorio)
—piattaforma	string	Piattaforma: ios o android (obbligatorio)
—certificato	string	iOS: Percorso del file di certificato .p12
—profilo-provvisoria-ios	string	iOS: Percorso del profilo di provisioning o bundleId=path (ripetibile)
—password-p12	string	iOS: Password del certificato (facoltativo se il certificato non ha una password)
—chiave-apple	string	iOS: Percorso della chiave .p8 di App Store Connect API
—id-chiave-apple	string	iOS: ID chiave di App Store Connect API
—apple-issuer-id	string	iOS: ID emittente Apple Store Connect
—apple-team-id	string	iOS: ID team Apple Store Connect
—ios-distribution	string	iOS: Modalità di distribuzione
—apple-id	string	iOS: Indirizzo email Apple ID per l'upload di password specifiche per l'app (alternativa alla chiave API di Apple Store Connect)
—apple-app-specific-password	string	iOS: Password specifica per l'upload su TestFlight (xxxx-xxxx-xxxx-xxxx)
—apple-app-id	string	iOS: ID numerico dell'app Apple Store Connect (richiesto insieme a —apple-id e —apple-app-specific-password)
—keystore	string	Android: Percorso del file del keystore (.keystore o .jks)
—keystore-alias	string	Android: Alias della chiave del keystore
—keystore-key-password	string	Android: Password della chiave del keystore
—keystore-store-password	string	Android: Password del keystore
—play-config	string	Android: Percorso del file JSON del servizio account di Play Store
—android-flavor	string	Android: Flavore del prodotto da costruire (ad esempio produzione). Richiesto se il progetto ha più flavor.
–priorità-aggiornamento-in-app	string	Android: priorità di aggiornamento in-app di Google Play per le future versioni (intero 0–5; maggiore = più urgente). Omettere per lasciare invariato il valore esistente di Play.
–locale	boolean	Salva in .capgo-credentials.json nella cartella root del progetto al posto di ~/.capgo-credentials/
–carica-output	boolean	Carica gli output di costruzione (IPA/APK/AAB) in Capgo archiviazione e stampa i collegamenti di download
–non-carica-output	boolean	Non caricare gli output di costruzione (IPA/APK/AAB) in Capgo archiviazione
–durata-link-output	string	Durata del link di output: 1h a 7d (predefinito: 1h). Esempi: 1h, 6h, 2d
–salta-aumento-numero-di-costruzione	boolean	Saltare l'aumento automatico del numero di costruzione/versione code nelle future costruzioni
---senza-saltare-aggiornamento-numero-di-costruzione	boolean	Riabilita l'incremento automatico del numero di costruzione (comportamento predefinito)
---saltare-aggiornamento-versione-di-mkt	boolean	Saltare l'aggiornamento automatico della versione di marketing nelle future costruzioni quando l'app è già rilasciata
---senza-saltare-aggiornamento-versione-di-mkt	boolean	Riabilita l'aggiornamento automatico della versione di marketing (comportamento predefinito)

📋 Elenco

npx @capgo/cli@latest build credentials list

Elencare le credenziali di costruzione salvate (passwords mascherate). Mostra quali credenziali sono attualmente salvate (entrambe globali e locali). Esempi: npx @capgo/cli build credentials list # Elencare tutte le app npx @capgo/cli build credentials list —appId com.example.app # Elencare app specifica

Opzioni:

Parametri	Tipo	Descrizione
—appId	string	ID dell'applicazione da elencare (facoltativo, elenca tutte se omesso)
—locale	boolean	Elencare le credenziali solo dal file locale .capgo-credentials.json

🔹 Pulisci

npx @capgo/cli@latest build credentials clear

Clear saved build credentials. Remove credentials from storage. Use —appId and —platform to target specific credentials. Examples: npx @capgo/cli build credentials clear # Clear all apps (global) npx @capgo/cli build credentials clear —local # Clear local credentials npx @capgo/cli build credentials clear —appId com.example.app —platform ios

Opzioni:

Param	Tipo	Descrizione
—appId	string	ID dell'applicazione da cancellare (facoltativo, cancella tutte le app se omesso)
—piattaforma	string	Piattaforma da cancellare: ios o android (facoltativo, cancella tutte le piattaforme se omesso)
—locale	boolean	Cancella da .capgo-credentials.json locale invece che globale

🔹 Aggiorna

npx @capgo/cli@latest build credentials update

Aggiorna le credenziali specifiche senza fornire tutte di nuovo. Aggiorna le credenziali esistenti fornendo solo i campi che desideri modificare. La piattaforma viene rilevata automaticamente dalle opzioni fornite. Esempi: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —local —keystore ./new-keystore.jks

Opzioni:

Parametro	Tipo	Descrizione
App ID (rilevato automaticamente da __CAPGO_KEEP_0__.config se omesso)	string	App ID (auto-detected from capacitor.config if omitted)
Locale	string	—local
—platform	boolean	Aggiorna il file capgo-credentials.json locale anziché quello globale
—certificato	string	Percorso del file del certificato P12
—ios-profilo-di-provvista	string	Percorso del profilo di provvista o bundleId=percorso (ripetibile, aggiuntivo di default)
—sovrascrivi-mappa-ios-provvista	boolean	Sostituisci l'intera mappa di provvista anziché unire (default: unione)
—password-p12	string	Password del certificato P12
—chiave-apple	string	Percorso della chiave API di App Store Connect (.p8 file)
—id-chiave-apple	string	App Store Connect API Key ID
—apple-issuer-id	string	ID emittente App Store Connect
—apple-team-id	string	ID team App Store Connect
—apple-id	string	iOS: Email Apple ID per upload di password specifiche per app (alternativa all'ID chiave App Store Connect API)
—apple-app-specific-password	string	iOS: Password specifica per app (xxxx-xxxx-xxxx-xxxx) per upload su TestFlight
—apple-app-id	string	iOS: ID numerico dell'app App Store Connect (richiesto insieme a —apple-id e —apple-app-specific-password)
—ios-distribution	string	iOS: Modalità di distribuzione
—chiave di sicurezza	string	Percorso del file della chiave di sicurezza (.keystore o .jks)
—alias della chiave di sicurezza	string	Alias della chiave di sicurezza della chiave di sicurezza
—password della chiave di sicurezza	string	Password della chiave di sicurezza della chiave di sicurezza
—password del magazzino di sicurezza	string	Password del magazzino di sicurezza della chiave di sicurezza
—configurazione di Google Play	string	Percorso del file JSON del servizio account di Google Play
—flavore di Android	string	Android: Nome del flavor del prodotto da costruire (ad esempio la produzione). Richiesto se il progetto ha più flavor.
–aggiornamento-in-app-priorità	string	Android: Priorità di aggiornamento in-app di Google Play per le future rilasci (intero 0–5; più alto = più urgente).
–caricamento-output	boolean	Carica gli output di costruzione (IPA/APK/AAB) nel Capgo storage e stampa i collegamenti di download
–nessun-output-caricamento	boolean	Non caricare gli output di costruzione (IPA/APK/AAB) nel Capgo storage
–durata-link-output	string	Durata del link di output: 1h a 7d. Esempi: 1h, 6h, 2d
–salta-aumento-numero-di-costruzione	boolean	Saltare l'aumento automatico del numero di costruzione/versione code nelle future costruzioni
–nessun-salta-aumento-numero-di-costruzione	boolean	Riabilita l'aumento automatico del numero di build (comportamento predefinito)
–skip-marketing-version-bump	boolean	Saltare l'aumento automatico della versione di marketing nelle future build quando l'app è già stata rilasciata
–no-skip-marketing-version-bump	boolean	Riabilita l'aumento automatico della versione di marketing (comportamento predefinito)

🔹 Gestisci

npx @capgo/cli@latest build credentials manage

Gestisci interattivamente le credenziali di build salvate. Esegui una ricerca tra le credenziali archiviate, visualizza cosa è configurato, esporta un file .env pronto per il CI/CD, o cancella le credenziali di una piattaforma. Utilizza la stessa interfaccia TUI di capgo init. Esempi: npx @capgo/cli build credentials manage npx @capgo/cli build credentials manage –appId com.example.app npx @capgo/cli build credentials manage –appId com.example.app –platform ios npx @capgo/cli build credentials manage –local

Opzioni:

Parametri	Tipo	Descrizione
—appId	string	ID dell'applicazione da gestire (facoltativo, richiede di scegliere se omesso)
—piattaforma	string	Piattaforma da gestire: ios o android (facoltativo, richiede di scegliere se omesso)
—locale	boolean	Visualizza solo i file locali .capgo-credentials.json

🔹 Migrare

npx @capgo/cli@latest build credentials migrate

Migra il profilo di provisioning legacy al nuovo formato multi-target. Converte BUILD_PROVISION_PROFILE_BASE64 in CAPGO_IOS_PROVISIONING_MAP. Scopre automaticamente l'ID del bundle principale dal tuo progetto Xcode. npx @capgo/cli build credentials migrate —piattaforma ios

Esempio:

Example:

Opzioni:

Parametro	Tipo	Descrizione
—appId	string	ID dell'app (rilevato automaticamente da capacitor.config se omesso)
—piattaforma	string	Piattaforma (solo ios è supportato)
—locale	boolean	Migrare da locale .capgo-credentials.json anziché globale