🔹 build
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
🏗️ Gestisci i build nativi iOS/Android tramite Capgo Cloud.
Accesso e output dei build
Sezione intitolata “Accesso e output dei build”I build nativi in cloud sono disponibili su ogni piano Capgo. Le credenziali di build non vengono mai salvate sui server di Capgo: vengono usate solo per il build e poi eliminate. Gli output dei build possono essere caricati facoltativamente con link di download a tempo limitato.
Salva prima le credenziali
Sezione intitolata “Salva prima le credenziali”npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidCattura un URL di output in CI
Sezione intitolata “Cattura un URL di output in CI”Passa --output-record per persistere l'URL di download e il QR code, quindi usa build last-output per leggerlo:
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrl🔹 Necessario
Sezione intitolata “ 🔹 Necessario”npx @capgo/cli@latest build needed🧭 Stampa “yes” ed esce con code 1 se è richiesto un Native Build; altrimenti stampa “no” ed esce con code 0. In caso di errore del comando, l'uscita sarà code 2.
Esempio:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOpzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a | string | chiave API per collegarti al tuo account |
| -c | string | Canale di confronto. Default: CapacitorUpdater.defaultChannel o il canale pubblico predefinito |
| —package-json | string | Percorsi dei file package.json per monorepo (separati da virgola) |
| —node-modules | string | Percorsi delle directory node_modules per monorepo (separati da virgola) |
| —verbose | boolean | Abilita l'output verbose con log dettagliati |
| —supa-host | string | URL host Supabase personalizzato (per self-hosting o sviluppo Capgo) |
| —supa-anon | string | Chiave anon Supabase personalizzata (per self-hosting) |
Alias: onboarding
npx @capgo/cli@latest build initConfigura le credenziali di build in modo interattivo (iOS: certificati + profili automatizzati; Android: keystore + Google OAuth configurano service account GCP e invito Play Console)
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a | string | chiave API per collegarti al tuo account |
| -p | string | Platform per l'onboarding (ios o android). Se omesso, viene rilevata automaticamente se esiste una sola cartella native; altrimenti, viene richiesto un prompt. |
| —supa-host | string | URL host Supabase personalizzato (per self-hosting o sviluppo Capgo) |
| —no-analytics | boolean | Disabilita l'analytics di onboarding del build e il terminal replay per questa esecuzione |
🔹 Richiesta
Sezione: “ 🔹 Request”npx @capgo/cli@latest build requestRichiedi un Native Build da Capgo Cloud. Questo comando zipherà la directory del progetto e la caricherà su Capgo per il build. Il build verrà elaborato e inviato direttamente agli app store. Le credenziali non vengono mai salvate sui server di Capgo; vengono eliminate dopo il build. Salvale prima di richiedere un build:
npx @capgo/cli build credentials save --appId APP_ID --platform iosEsempio:
npx @capgo/cli@latest build request com.example.app --platform ios --path .Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —path | string | Percorso della directory di progetto da buildare (default: directory corrente) |
| —node-modules | string | Percorsi delle directory node_modules per monorepo (separati da virgola) |
| —platform | string | Piattaforma target: ios o android (obbligatorio) |
| —build-mode | string | Modalità di build: debug o release (default: release) |
| —build-certificate-base64 | string | iOS: Certificato .p12 codificato in Base64 |
| —p12-password | string | iOS: Password del certificato (opzionale se il certificato non ha password) |
| —apple-id | string | iOS: email dell'Apple ID per l'upload di app-specific password (alternativa alla chiave API di App Store Connect) |
| —apple-app-specific-password | string | iOS: Password specifica per l'app (xxxx-xxxx-xxxx-xxxx) per l'upload su TestFlight |
| —apple-app-id | string | iOS: ID numerico dell'app su App Store Connect (necessario insieme a —apple-id e —apple-app-specific-password) |
| —apple-key-id | string | iOS: Key ID API di App Store Connect |
| —apple-issuer-id | string | iOS: Issuer ID di App Store Connect |
| —apple-key-content | string | iOS: Chiave API di App Store Connect codificata in Base64 (.p8) |
| —app-store-connect-team-id | string | iOS: Team ID di App Store Connect |
| —ios-scheme | string | iOS: Scheme Xcode da buildare (default: App) |
| —ios-target | string | iOS: Target Xcode per leggere le build settings (default: uguale allo scheme) |
| —xcode-version | string | iOS: build su una macchina con questa versione di Xcode (es. 26, 26.0.1, 27). Una major version accetta qualsiasi minor. Default: qualsiasi macchina. Precedenza: CLI > env (CAPGO_IOS_XCODE_VERSION) > credenziali salvate |
| —ios-distribution | string | iOS: Modalità di distribuzione |
| —ios-provisioning-profile | string | iOS: Percorso del provisioning profile o mapping bundleId=path (ripetibile) |
| —android-keystore-file | string | Android: File keystore codificato in Base64 |
| —keystore-key-alias | string | Android: Alias della chiave keystore |
| —keystore-key-password | string | Android: Password della chiave keystore |
| —keystore-store-password | string | Android: Password del keystore store |
| —play-config-json | string | Android: JSON dell'account di servizio Google Play codificato in Base64 |
| —android-flavor | string | Android: Product flavor da buildare (es. production). Obbligatorio se il progetto ha più flavor. |
| —android-track | string | Android: Google Play track per questo upload (internal, alpha, beta, production). Default senza —submit-to-store-review: internal. Con —submit-to-store-review e nessun track impostato: production. Precedenza: CLI > env > credenziali salvate |
| —android-release-status | string | Android: Stato del rilascio su Google Play (draft, completed, inProgress, halted). Default senza —submit-to-store-review: draft. Con —submit-to-store-review e nessuno status impostato: completed. Precedenza: CLI > env > credenziali salvate |
| —in-app-update-priority | string | Android: Priorità in-app update di Google Play per questo rilascio (intero 0–5; più alto = più urgente). Vedi https://developer.android.com/guide/playcore/in-app-updates. Precedenza: CLI > env > credenziali salvate |
| —no-playstore-upload | boolean | Salta l'upload su Play Store per questa build (azzera la config Play salvata). Richiede —output-upload. |
| —submit-to-store-review | boolean | Dopo l'upload, invia la release allo store per la revisione invece di lasciarla come build in bozza o inattiva. Su Android, questo imposta di default il canale di produzione con release_status completato (sovrascrivibile con —android-track / PLAY_STORE_TRACK e —android-release-status / PLAY_STORE_RELEASE_STATUS). Su iOS, invia la build elaborata su TestFlight per la revisione dell'App Store. |
| —store-release-name | string | Nome o etichetta della versione per lo store. Android lo invia come version_name di Google Play; iOS lo usa come versione dell'App Store durante la creazione o il riutilizzo di una versione modificabile. |
| —store-release-notes | string | Note di rilascio predefinite per lo store. Android le usa come changelog di Play; iOS le usa come testo di fallback per la sezione "Novità" dell'App Store. |
| —store-release-notes-locale | string | Note di rilascio localizzate (ripetibili), ad esempio —store-release-notes-locale en-US="Bug fixes" —store-release-notes-locale it-IT="Correzioni". |
| —ios-testflight-groups | string | iOS: nomi o ID dei gruppi esterni di TestFlight, separati da virgola, per la distribuzione beta esterna. |
| —ios-automatic-release | boolean | iOS: rilascia automaticamente la versione dell'App Store dopo l'approvazione di Apple. Il default è il rilascio manuale. |
| —no-ios-automatic-release | boolean | iOS: lascia la versione dell'App Store in attesa di rilascio manuale dopo l'approvazione di Apple. |
| —output-upload | boolean | Sovrascrive il comportamento di upload dell'output solo per questa build (abilita). Precedenza: CLI > env > credenziali salvate |
| —no-output-upload | boolean | Sovrascrive il comportamento di upload dell'output solo per questa build (disabilita). Precedenza: CLI > env > credenziali salvate |
| —output-retention | string | Sovrascrive il TTL del link di output solo per questa build (da 1h a 7d). Esempi: 1h, 6h, 2d. Precedenza: CLI > env > credenziali salvate |
| —output-record | string | Al termine di una build riuscita, scrive un record JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) in un percorso. Viene scritto anche un QR code PNG accanto a quel percorso con il .qr.png suffisso. Rileggi i campi con build last-output. |
| —no-cache | boolean | Salta il ripristino della build cache e non salva una nuova voce cache per questa build. La build cache è abilitata di default per ogni app. |
| —cache-key | string | Partiziona la build cache per ambiente, branch o Android flavor (ad esempio prod, staging). Omettilo per usare una cache predefinita condivisa per app. |
| —no-skip-build-number-bump | boolean | Sovrascrive le credenziali salvate per riabilitare l'incremento automatico del build number solo per questa build. |
| —skip-marketing-version-bump | boolean | Salta l'incremento automatico della marketing version (CFBundleShortVersionString / versionName) se l'app è già stata rilasciata. |
| —sync-ios-version | boolean | iOS: sincronizza la MARKETING_VERSION di Xcode da package.json prima di caricare il progetto. |
| —ai-analytics | boolean | In caso di build fallita, invia i log all'AI di Capgo per la diagnosi. Nei terminali interattivi salta la conferma iniziale; in CI esegue l'upload automatico e stampa l'analisi su stderr. |
| —no-prescan | boolean | Salta la scansione automatica pre-build |
| —prescan-ignore-fatal | boolean | Esegue la scansione pre-build ma non blocca mai il build (solo report) |
| —prescan-skip | string | Salta check di prescan specifici per id (ripetibile o separati da virgola). Gli altri check vengono comunque eseguiti. |
| —prescan-warn | string | Trasforma i controlli prescan in warning tramite ID (ripetibili o separati da virgola). Il controllo verrà comunque eseguito. |
| —fail-on-warnings | boolean | Tratta i warning del prescan come fatali |
| —send-logs-to-support | boolean | In caso di errore durante la build in CI/CD, carica automaticamente i log di build al supporto di Capgo (senza bisogno di email). Il supporto di Capgo verrà notificato e ti ricontatterà via email. Si aggiunge a —ai-analytics. |
| —send-logs | boolean | Alias deprecato per —send-logs-to-support |
| -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) |
| —verbose | boolean | Abilita l'output verbose con log dettagliati |
Cache di build: Di default, Capgo ripristina e salva gli artefatti nativi compilati (CocoaPods, Gradle e output correlati) per ogni app. Usa --cache-key per mantenere separati i cache di RC e produzione; usa --no-cache per una build pulita una tantum. Le integrazioni API possono passare cache_key o cache_enabled: false nel payload della richiesta di build. Vedi Cache di build e Troubleshooting: ripristino cache errato.
🔹 Sync-ios-version
Sezione intitolata “ 🔹 Sync-ios-version”npx @capgo/cli@latest build sync-ios-versionSincronizza la MARKETING_VERSION locale di Xcode da package.json.
Esempio:
npx @capgo/cli@latest build sync-ios-version --path .Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —path | string | Percorso della directory di progetto (default: directory corrente) |
| —check | boolean | Solo controllo; esce con codice non zero se MARKETING_VERSION è fuori sincrono |
🔹 Prescan
Sezione intitolata “ 🔹 Prescan”npx @capgo/cli@latest build prescanScansiona il progetto e le credenziali salvate alla ricerca di problemi che farebbero fallire una cloud build — prima di caricare qualsiasi cosa.
Controlla le credenziali (scadenza, password, pairing del profilo), lo stato del progetto (cap sync, layout node_modules) e la config della piattaforma. Viene eseguito automaticamente all'interno di build request; questo comando lo esegue in standalone (es. in CI).
Consulta Controlli prescan per l'elenco completo dei controlli e come --skip / --warn le singole regole.
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —platform | string | Piattaforma target: ios o android (obbligatorio) |
| —path | string | Percorso della directory di progetto (default: directory corrente) |
| -a | string | chiave API per collegarti al tuo account |
| —android-flavor | string | Android: product flavor da utilizzare per la build |
| —ios-dist | string | iOS: modalità di distribuzione per la validazione |
| —json | boolean | Genera un report JSON leggibile dalle macchine |
| —fail-on-warnings | boolean | Uscita con errore se vengono trovati warning (CI) |
| —ignore-fatal | boolean | Modalità diagnostica: riporta tutto ma esce sempre con codice 0 |
| —skip | string | Salta check specifici tramite ID (ripetibile o separato da virgola) |
| —warn | string | Trasforma check specifici in warning tramite ID (ripetibile o separato da virgola) |
| —verbose | boolean | Abilita l'output verbose con log dettagliati |
| —supa-host | string | URL host Supabase personalizzato (per self-hosting o sviluppo Capgo) |
| —supa-anon | string | Chiave anon Supabase personalizzata (per self-hosting) |
🔹 Last-output
Sezione intitolata “ 🔹 Last-output”npx @capgo/cli@latest build last-outputLegge il record dell'output di build scritto da un precedente build request --output-record.
Di default stampa il JSON completo, un singolo campo con —field, o il QR ASCII
code con —qr. Utile in CI per recuperare l'URL di download o il QR da postare
su una PR o un issue.
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 |
|---|---|---|
| —path | string | Percorso del file JSON generato da —output-record (obbligatorio) |
| —field | string | Stampa un singolo campo (tra: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Stampa il QR code in formato ASCII (scorciatoia per —field qrCodeAscii) |
🔹 Credentials
Sezione intitolata “ 🔹 Credentials”Gestisci le credenziali di build salvate localmente sulla tua macchina. 🔒 SECURITY:
- Credentials salvate in ~/.capgo-credentials/credentials.json (globali) o .capgo-credentials.json (locali)
- When building, sent to Capgo but NEVER stored permanently
- Eliminati da Capgo subito dopo la build
- Gli output della build possono essere caricati per generare link di download temporanei 📚 DOCUMENTAZIONE: Configurazione iOS: https://capgo.app/docs/cli/cloud-build/ios/ Configurazione Android: https://capgo.app/docs/cli/cloud-build/android/
🔹 Chiave Apple
Sezione intitolata “ 🔹 Chiave Apple”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyCrea una chiave team App Store Connect API con un helper guidato su macOS (solo macOS). Apre una finestra nativa che ti guida nell'interfaccia App Store Connect di Apple tramite un browser integrato, cattura automaticamente Issuer ID + Key ID, intercetta il file .p8 una tantum, lo valida con Apple e lo salva in ~/.appstoreconnect/private_keys. Le statistiche di avanzamento sono inviate alle analytics di Capgo (disabilita con CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key —appId com.example.app
Esempio:
Example:Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a | string | chiave API per collegarti al tuo account |
| —appId | string | Salva la chiave catturata nelle credenziali di build iOS di questa app |
| —local | boolean | Salva nel file .capgo-credentials.json del progetto invece che nel file globale |
| —json | boolean | Stampa il Key ID / Issuer ID / percorso .p8 catturato in formato JSON |
🔹 Salva
Sezione intitolata “ 🔹 Save”npx @capgo/cli@latest build credentials saveSalva le credenziali di build localmente per iOS o Android. Le credenziali sono salvate in:
- ~/.capgo-credentials/credentials.json (default, globale)
- .capgo-credentials.json nella root del progetto (con flag —local)
⚠️ OBBLIGATORIO PRIMA DELLA BUILD: Devi salvare le credenziali prima di richiedere una build.
🔒 Queste credenziali NON vengono MAI salvate permanentemente sui server di Capgo.
Vengono eliminate immediatamente al termine della build.
📚 Guide alla configurazione:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save —piattaforma ios
—certificate ./cert.p12 —p12-password “password”
—ios-provisioning-profile ./profile.mobileprovision
—apple-key ./AuthKey.p8 —apple-key-id “KEY123”
—apple-issuer-id “issuer-uuid” —apple-team-id “team-id” Esempio multi-target (app + widget extension): npx @capgo/cli build credentials save —platform ios
—ios-provisioning-profile ./App.mobileprovision
—ios-provisioning-profile com.example.widget=./Widget.mobileprovision
… npx @capgo/cli build credentials save —piattaforma android
—keystore ./release.keystore —keystore-alias “my-key”
—keystore-key-password “key-pass”
—play-config ./service-account.json Storage locale (per-project): npx @capgo/cli build credentials save —local —platform ios …
Esempio:
iOS Example:Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —appId | string | App ID (es. com.example.app) (obbligatorio) |
| —platform | string | Platform: ios o android (obbligatorio) |
| —certificate | string | iOS: Percorso del file del certificato .p12 |
| —ios-provisioning-profile | string | iOS: Percorso provisioning profile o bundleId=path (ripetibile) |
| —p12-password | string | iOS: Password del certificato (opzionale se il certificato non ha password) |
| —apple-key | string | iOS: Percorso della chiave API .p8 di App Store Connect |
| —apple-key-id | string | iOS: Key ID API di App Store Connect |
| —apple-issuer-id | string | iOS: Issuer ID di App Store Connect |
| —apple-team-id | string | iOS: Team ID di App Store Connect |
| --ios-distribution | string | iOS: Modalità di distribuzione |
| --apple-id | string | iOS: email dell'Apple ID per l'upload di app-specific password (alternativa alla chiave API di App Store Connect) |
| --apple-app-specific-password | string | iOS: Password specifica per l'app (xxxx-xxxx-xxxx-xxxx) per l'upload su TestFlight |
| --apple-app-id | string | iOS: ID numerico dell'app su App Store Connect (necessario insieme a —apple-id e —apple-app-specific-password) |
| --keystore | string | Android: Percorso del file keystore (.keystore o .jks) |
| --keystore-alias | string | Android: Alias della chiave Keystore |
| —keystore-key-password | string | Android: Password della chiave Keystore |
| —keystore-store-password | string | Android: Password del keystore |
| —play-config | string | Android: Percorso del JSON del service account Play Store |
| —android-flavor | string | Android: Product flavor da buildare (es. production). Obbligatorio se il progetto ha più flavor. |
| —in-app-update-priority | string | Android: Priorità dell'aggiornamento in-app di Google Play per i prossimi rilasci (intero 0–5; più alto = più urgente). Ometti per non modificare il valore attuale di Play. |
| —local | boolean | Salva in .capgo-credentials.json nella root del progetto invece di ~/.capgo-credentials/ globale |
| —output-upload | boolean | Carica gli output di build (IPA/APK/AAB) su Capgo e stampa i link per il download |
| —no-output-upload | boolean | Non caricare gli output della build (IPA/APK/AAB) su Capgo |
| —output-retention | string | TTL del link: da 1h a 7d (default: 1h). Esempi: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Salta l'incremento automatico del build number/versione code nelle build future |
| —no-skip-build-number-bump | boolean | Riabilita l'incremento automatico del build number (comportamento di default) |
| —skip-marketing-version-bump | boolean | Salta l'incremento automatico della versione marketing nei prossimi build se l'app è già stata rilasciata |
| —no-skip-marketing-version-bump | boolean | Riabilita l'incremento automatico della versione marketing (comportamento predefinito) |
📋 Elenco
Sezione intitolata “ 📋 Elenco”npx @capgo/cli@latest build credentials listElenca le credenziali di build salvate (password oscurate). Mostra le credenziali attualmente salvate (sia globali che locali). Esempi: npx @capgo/cli build credentials list # Elenca tutte le app npx @capgo/cli build credentials list —appId com.example.app # Elenca una specifica app
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —appId | string | App ID da elencare (opzionale, elenca tutto se omesso) |
| —local | boolean | Elenca le credenziali solo dal file locale .capgo-credentials.json |
npx @capgo/cli@latest build credentials clearCancella le credenziali di build salvate. Rimuove le credenziali dallo storage. Usa —appId e —platform per puntare a credenziali specifiche. Esempi: npx @capgo/cli build credentials clear # Cancella tutte le app (globale) npx @capgo/cli build credentials clear —local # Cancella le credenziali locali npx @capgo/cli build credentials clear —appId com.example.app —platform ios
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —appId | string | App ID da cancellare (opzionale, cancella tutte le app se omesso) |
| —platform | string | Piattaforma da cancellare: ios o android (opzionale, cancella tutte le piattaforme se omesso) |
| —local | boolean | Cancella dal file locale .capgo-credentials.json invece che da quello globale |
🔹 Aggiornamento
Sezione intitolata “ 🔹 Update”npx @capgo/cli@latest build credentials updateAggiorna credenziali specifiche senza doverle fornire tutte di nuovo. Aggiorna le credenziali esistenti fornendo solo i campi che vuoi cambiare. La piattaforma viene rilevata automaticamente in base alle 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 |
|---|---|---|
| —appId | string | App ID (rilevato automaticamente da capacitor.config se omesso) |
| —platform | string | Platform: ios o android (rilevata automaticamente dalle opzioni) |
| —local | boolean | Aggiorna il file locale .capgo-credentials.json invece di quello globale |
| —certificate | string | Percorso del file del certificato P12 |
| —ios-provisioning-profile | string | Percorso del provisioning profile o bundleId=path (ripetibile, aggiuntivo di default) |
| —overwrite-ios-provisioning-map | boolean | Sostituisce l'intera mappa di provisioning invece di unirla (default: merge) |
| —p12-password | string | Password del certificato P12 |
| —apple-key | string | Percorso della chiave API di App Store Connect (file .p8) |
| —apple-key-id | string | Key ID della API di App Store Connect |
| —apple-issuer-id | string | Issuer ID di App Store Connect |
| —apple-team-id | string | Team ID di App Store Connect |
| —apple-id | string | iOS: email dell'Apple ID per l'upload di app-specific password (alternativa alla chiave API di App Store Connect) |
| —apple-app-specific-password | string | iOS: Password specifica per l'app (xxxx-xxxx-xxxx-xxxx) per l'upload su TestFlight |
| —apple-app-id | string | iOS: ID numerico dell'app su App Store Connect (necessario insieme a —apple-id e —apple-app-specific-password) |
| —ios-distribution | string | iOS: Modalità di distribuzione |
| —keystore | string | Percorso del file keystore (.keystore o .jks) |
| —keystore-alias | string | Alias della chiave Keystore |
| —keystore-key-password | string | Password della chiave Keystore |
| —keystore-store-password | string | Password del keystore |
| —play-config | string | Percorso del file JSON dell'account di servizio Google Play |
| —android-flavor | string | Android: Product flavor da buildare (es. production). Obbligatorio se il progetto ha più flavor. |
| —in-app-update-priority | string | Android: priorità dell'aggiornamento in-app di Google Play per i prossimi rilasci (intero 0–5; più alto = più urgente). |
| —output-upload | boolean | Carica gli output di build (IPA/APK/AAB) su Capgo e stampa i link per il download |
| —no-output-upload | boolean | Non caricare gli output della build (IPA/APK/AAB) su Capgo |
| —output-retention | string | TTL del link di output: da 1h a 7d. Esempi: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Salta l'incremento automatico del build number/versione code nelle build future |
| —no-skip-build-number-bump | boolean | Riabilita l'incremento automatico del build number (comportamento predefinito) |
| —skip-marketing-version-bump | boolean | Salta l'incremento automatico della marketing version nelle build future se l'app è già rilasciata |
| —no-skip-marketing-version-bump | boolean | Riabilita l'incremento automatico della marketing version (comportamento predefinito) |
🔹 Gestisci
Sezione intitolata “ 🔹 Gestisci”npx @capgo/cli@latest build credentials manageGestisci in modo interattivo le credenziali di build salvate.
Esplora le credenziali, visualizza la configurazione, esporta un file .env pronto per la CI/CD
o elimina le credenziali di una piattaforma. Utilizza la stessa 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:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —appId | string | App ID da gestire (opzionale, se omesso viene richiesto) |
| —platform | string | Piattaforma da gestire: ios o android (opzionale, se omesso viene richiesto) |
| —local | boolean | Visualizza solo i file locali .capgo-credentials.json |
🔹 Migrate
Sezione intitolata “ 🔹 Migrate”npx @capgo/cli@latest build credentials migrateMigra i vecchi provisioning profile nel nuovo formato multi-target. Converte BUILD_PROVISION_PROFILE_BASE64 in CAPGO_IOS_PROVISIONING_MAP. Rileva automaticamente il bundle ID principale dal tuo progetto Xcode. npx @capgo/cli build credentials migrate —platform ios
Esempio:
Example:Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —appId | string | App ID (rilevato automaticamente da capacitor.config se omesso) |
| —platform | string | Platform (supportata solo ios) |
| —local | boolean | Migra dalle credenziali locali in .capgo.json invece di quelle globali |