🔹 Costruisci
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
🏗️ Manage native iOS/Android builds through Capgo Cloud.
Accesso e output della costruzione
Sezione intitolata “Accesso e output della 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
Sezione intitolata “Salva le credenziali per primo”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
Sottosezione intitolata “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.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrl🔹 Richiesto
Sottosezione intitolata “ 🔹 Richiesto”npx @capgo/cli@latest build neededStampa ‘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 --verboseOpzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a | string | API chiave per collegarsi al tuo account |
| -c | string | Canale di riferimento per la comparazione. Predefinito su CapacitorUpdater.defaultChannel o il canale pubblico predefinito |
| —package-json | string | Permessi per i file package.json dei monorepos (separati da virgole) |
| —node-modules | string | Permessi per i directory node_modules dei monorepos (separati da virgole) |
| —verbose | boolean | Abilita l'output dettagliato con registrazione dettagliata |
| —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) |
Alias: onboarding
npx @capgo/cli@latest build initConfigura le credenziali di costruzione interattivamente (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 | chiave API per collegarsi al tuo account |
| -p | string | Piattaforma per l'accesso (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
Sezione intitolata “ 🔹 Richiesta”npx @capgo/cli@latest build requestRichiedi una build nativa da Capgo Cloud. Questo comando comprimerà il tuo progetto e lo invierà a Capgo per la costruzione. La build sarà elaborata e inviata direttamente ai negozi di app. Le credenziali non vengono mai memorizzate sui server Capgo; vengono eliminate dopo la build. Salvali prima di richiedere una 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 del directory del progetto da costruire (predefinito: directory corrente) |
| –node-modules | string | Permessi dei directory node_modules per i monorepos (separati da virgola) |
| –platform | string | Piattaforma di destinazione: ios o android (obbligatorio) |
| —modalità di costruzione | string | Modalità di costruzione: debug o rilascio (impostazione predefinita: rilascio) |
| —base64-certificato-di-costruzione | string | iOS: Certificato .p12 codificato in base64 |
| —password-p12 | string | iOS: Password del certificato (facoltativo se il certificato non ha una password) |
| —apple-id | string | iOS: Indirizzo e-mail Apple per l'upload delle password specifiche dell'app (alternativa alla chiave App Store Connect API) |
| —apple-password-app-specifica | string | iOS: Password specifica dell'app (xxxx-xxxx-xxxx-xxxx) per gli upload su TestFlight |
| —apple-id-app | string | iOS: ID numerico di App Store Connect dell'applicazione (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: Percorso di destinazione Xcode per la lettura delle impostazioni di costruzione (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: Contenuto JSON del servizio Google Play codificato in Base64 |
| —android-flavor | string | Android: Flusso di prodotto da costruire (ad esempio, produzione). Richiesto se il progetto ha più flussi. |
| —android-track | string | Android: Tracciamento Google Play per questa pubblicazione (interno, alpha, beta, produzione). Predefinito senza —submit-to-store-review: interno. Con —submit-to-store-review e nessun tracciamento impostato: produzione. Precedenza: CLI > ambiente > credenziali salvate |
| —android-release-status | string | Android: Stato di pubblicazione 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 questa versione (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 | Ignora l'upload su Play Store per questa build (annulla la configurazione di play salvata). Richiede —output-upload. |
| —submit-to-store-review | boolean | Dopo l'upload, invia la versione per la revisione al posto di lasciarla come bozza/ build inattivo. Su Android questo predefinito è 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 build elaborata di TestFlight per la revisione della 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 dell'App Store quando si crea o si riutilizza la versione modificabile. |
| —store-release-notes | string | Note di versione di store di default. L'Android utilizza questo come changelog di Play; l'iOS lo utilizza come testo 'What’s New' di fallback della App Store. |
| —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: rilasciare automaticamente la versione dell'App Store dopo l'approvazione di Apple. Impostazione predefinita: rilascio manuale. |
| —no-ios-automatic-release | boolean | iOS: tenere la versione dell'App Store in attesa di un rilascio manuale dopo l'approvazione di Apple. |
| —output-upload | boolean | Sovrascrivere il comportamento di caricamento degli output per questa sola costruzione (abilitato). Precedenza: CLI > ambiente > credenziali salvate |
| —no-output-upload | boolean | Sovrascrivere il comportamento di caricamento degli output per questa sola costruzione (disabilitato). Precedenza: CLI > ambiente > credenziali salvate |
| —output-retention | string | Sovrascrivere la durata della vita utile dei collegamenti degli output per questa sola costruzione (1h a 7d). Esempi: 1h, 6h, 2d. Precedenza: CLI > ambiente > credenziali salvate |
| —output-record | string | Dopo un build riuscito, scrivi un record JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) in un percorso. Un QR code in formato PNG viene anche scritto accanto a quel percorso con il .qr.png Leggi i campi di nuovo con build last-output. |
| 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. |
| Saltare l'incremento della versione di marketing (CFBundleShortVersionString / versionName) quando l'app è già rilasciata. | boolean | Sincronizza la versione iOS |
| Sincronizza la versione MARKETING_VERSION di Xcode dal package.json prima di caricare il progetto. | boolean | Invia i log all'analisi AI di __CAPGO_KEEP_0__ in caso di errore di build. In terminali interattivi questo salta la conferma iniziale; in CI questo carica automaticamente e stampa l'analisi su stderr. |
| Non eseguire lo scansionamento pre-build | boolean | On build failure, send logs to Capgo AI for diagnosis. In interactive terminals this skips the upfront confirmation; in CI this auto-uploads and prints the analysis to stderr. |
| Non eseguire lo scansionamento pre-build | boolean | Non eseguire lo scansionamento pre-build |
| —prescan-ignore-fatal | boolean | Eseguire lo scansionamento pre-costruzione ma non bloccare mai la costruzione (rilascio solo) |
| —prescan-skip | string | Saltare specifiche verifiche di prescan (ripetibili o separate da virgola) per ID (ripetibili o separate da virgola). Le altre verifiche sono ancora eseguite. |
| —prescan-warn | string | Abbassare specifiche verifiche di prescan (ripetibili o separate da virgola) a avviso per ID (ripetibili o separate da virgola). La verifica è ancora eseguita. |
| —fail-on-warnings | boolean | Considerare gli avvisi di prescan come fatali |
| —send-logs-to-support | boolean | In caso di fallimento di una costruzione CI/CD, caricare automaticamente i log di costruzione su Capgo supporto (nessun indirizzo email richiesto). Capgo supporto viene informato e seguirà con un'email. Aggiuntivo a —ai-analytics. |
| —send-logs | boolean | Alias deprecato per —send-logs-to-support |
| -a | string | chiave API 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) |
| —verbose | boolean | Abilita l'output dettagliato con registrazione di logging |
🔹 Versione iOS sincronizzata
Finestra del terminalenpx @capgo/cli@latest build sync-ios-versionSincronizza la versione di marketing locale iOS Xcode dal file package.json.
Esempio:
npx @capgo/cli@latest build sync-ios-version --path .Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —path | string | Percorso del directory del progetto (predefinito: directory corrente) |
| —check | boolean | Verifica solo; esce con codice di uscita non zero quando la versione di marketing è fuori sincronia |
🔹 Scansiona
Sezione intitolata “ 🔹 Scansiona”npx @capgo/cli@latest build prescanScansiona il tuo progetto e le credenziali salvate per i problemi che impedirebbero un build cloud — prima di caricare qualsiasi cosa.
Verifica le credenziali (scadenza, password, pairing del profilo), stato del progetto (cap sync, layout di node_modules), e configurazione della piattaforma. Esegue automaticamente all'interno build request; questo comando lo esegue in modo autonomo (ad esempio in CI).
Vedi La scansiona controlla per il catalogo completo delle verifiche e come --skip / --warn le regole individuali.
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —piattaforma | string | Piattaforma di destinazione: ios o android (obbligatoria) |
| —percorso | string | Percorso del directory del progetto (default: directory corrente) |
| -a | string | API chiave per collegarsi al proprio account |
| —flavor-android | string | Android: il flavor del prodotto che il build utilizzerà |
| —dist-ios | string | iOS: modalità di distribuzione per la validazione |
| —json | boolean | Emiti un rapporto JSON leggibile da macchina |
| –falli-on-warnings | boolean | Esci con codice di uscita non zero quando sono trovate avvertenze (CI) |
| –ignora-fatale | boolean | Modalità diagnostica: segnala tutto ma esce sempre con codice 0 |
| –saltare | string | Saltare specifiche verifiche per ID (ripetibili o separati da virgola) |
| –avviso | string | Abbassare specifiche verifiche a avviso per ID (ripetibili o separati da virgola) |
| –verboso | boolean | Abilita l'output verboso con registrazione dettagliata |
| –supa-host | string | URL host personalizzato per Supabase (per l'hosting auto o lo sviluppo Capgo) |
| –supa-anon | string | Chiave anonima personalizzata per Supabase (per l'hosting auto) |
🔹 Ultimo output
Sezione intitolata “ Ultimo output”npx @capgo/cli@latest build last-outputLeggi il record di output di costruzione scritto da un precedente build request --output-record.
Stampa il JSON completo di default, un singolo campo con —field, o il QR ASCII
code con —qr. Utile in CI per recuperare l'URL di download o il QR per inviarli nuovamente
in un 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 |
|---|---|---|
| —percorso | string | Percorso del record JSON scritto da —output-record (obbligatorio) |
| —campo | string | Stampa un singolo campo (uno di: jobId, appId, piattaforma, buildMode, stato, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Stampa il codice QR ASCII code (shortcut per —campo qrCodeAscii) |
🔹 Credenziali
Sezione intitolata “ 🔹 Credenziali”Gestisci le credenziali di costruzione memorizzate localmente sul tuo computer. 🔒 SICUREZZA:
- Le credenziali salvate in ~/.capgo-credentials/credentials.json (globale) o .capgo-credentials.json (locale)
- Quando si costruisce, inviate a Capgo ma NON archiviate permanentemente
- Eliminato da Capgo immediatamente dopo la costruzione
- Potrebbero essere caricati i risultati della costruzione 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
Sottosezione intitolata “ 🔹 Chiave Apple”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyCreare una chiave API del team App Store Connect con un helper guidato per macOS (disponibile solo su macOS). Apre una finestra nativa che guida l'utente attraverso l'interfaccia utente di App Store Connect di Apple in un browser incorporato, cattura automaticamente l'ID emittente + ID chiave, intercetta il file .p8 una volta per tutte, lo valuta contro Apple e lo salva in ~/.appstoreconnect/private_keys. Le statistiche di avanzamento vengono inviate a Capgo analytics (disabilitare con CAPGO_DISABLE_TELEMETRY). npx @capgo/cli costruisce le credenziali della chiave Apple —appId com.example.app
Esempio:
Example:Opzioni:
| Param | Tipo | Descrizione |
|---|---|---|
| -a | string | API chiave per collegarsi al tuo account |
| —appId | string | Salva la chiave catturata nei credenziali di build iOS di questa app |
| —locale | boolean | Salva nella cartella per progetto .capgo-credentials.json al posto del file globale |
| ---json | boolean | Stampa le chiavi ID / ID emittente / percorso .p8 catturate in formato JSON |
🔹 Salva
Saverenpx @capgo/cli@latest build credentials saveSalva le credenziali di costruzione localmente per iOS o Android. Le credenziali sono memorizzate in:
- ~/.capgo-credentials/credentials.json (predefinito, globale)
- .capgo-credentials.json nella cartella root del progetto (con la flag --local)
⚠️ RICHIESTO PRIMA DELLA COSTRUZIONE: è necessario salvare le credenziali prima di richiedere una costruzione.
🔒 Queste credenziali non sono mai memorizzate permanentemente sui server Capgo.
Sono eliminate immediatamente dopo la costruzione si completa.
📚 Guida di configurazione:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npk @capgo/cli build credentials save —piattaforma ios
—certificato ./cert.p12 —password-p12 “password”
—profilo-di-provvisoria-ios ./profile.mobileprovision
—chiave-apple ./AuthKey.p8 —id-chiave-apple “KEY123”
—id-emittente-apple “issuer-uuid” —id-quipe-apple “team-id” Esempio di più obiettivi (app + estensione widget): npk @capgo/cli build credentials save —piattaforma ios
—profilo-di-provvisoria-ios ./App.mobileprovision
—profilo-di-provvisoria-ios com.example.widget=./Widget.mobileprovision
… npk @capgo/cli build credentials save —piattaforma android
—keystore ./release.keystore —alias-keystore “my-key”
—password-chiave-keystore “key-pass”
—configurazione-play ./service-account.json Memoria locale (per-progetto): npk @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 |
| ---prova-di-provisioning-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 |
| ---id-issuer-apple | string | iOS: ID emittente di App Store Connect |
| ---id-quipe-apple | string | iOS: ID squadra di App Store Connect |
| ---ios-distribuzione | string | IOS: Modalità di distribuzione |
| ---apple-id | string | IOS: Indirizzo e-mail Apple ID per l'upload di password specifiche per l'app (alternativa alla chiave App Store Connect API) |
| ---password-app-specifica-di-apple | string | IOS: Password specifica per l'app (xxxx-xxxx-xxxx-xxxx) per gli upload di TestFlight |
| ---apple-app-id | string | IOS: ID numerico dell'app di App 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 |
| ---chiave-di-crittografia-di-keystore | string | Android: Password della chiave di crittografia del keystore |
| ---password-del-keystore | string | Android: Password del keystore |
| ---configurazione-di-play | string | Android: Percorso del file JSON del servizio account di Play Store |
| ---flavor-di-android | string | Android: Flavore del prodotto da costruire (ad esempio produzione). Richiesto se il progetto ha più di una flavor. |
| ---priorità-di-aggiornamento-in-app | string | Android: Priorità di aggiornamento in-app di Google Play per le future rilasci (intero 0-5; maggiore = più urgente). Omettere per lasciare invariata la configurazione esistente di Play. |
| ---locale | boolean | Salva in .capgo-credentials.json nella cartella root del progetto al posto di ~/.capgo-credentials/ |
| —output-upload | boolean | Carica gli output di costruzione (IPA/APK/AAB) su Capgo archiviazione e stampa i collegamenti di download |
| —no-output-upload | boolean | Non caricare gli output di costruzione (IPA/APK/AAB) su Capgo archiviazione |
| —output-retention | string | TTL del collegamento di output: 1h a 7g (predefinito: 1h). Esempi: 1h, 6h, 2g |
| —skip-build-number-bump | boolean | Saltare l'aumento automatico del numero di costruzione/code/ nella costruzione futura |
| —no-skip-build-number-bump | boolean | Riabilitare l'aumento automatico del numero di costruzione (comportamento predefinito) |
| —skip-marketing-version-bump | boolean | Saltare l'aumento automatico della versione di marketing nella costruzione futura quando l'app è già rilasciata |
| ---senza-saltare-l'aggiornamento-di-versione-di-marketing | boolean | Riabilita l'aggiornamento automatico della versione di marketing (comportamento predefinito) |
📋 Elenco
Sezione intitolata “ 📋 Elenco”npx @capgo/cli@latest build credentials listElenco delle credenziali di costruzione salvate (passwords mascherate). Mostra quali credenziali sono attualmente salvate (entrambe globali e locali). Esempi: npx @capgo/cli build credentials list # Elenco di tutte le app npx @capgo/cli build credentials list —appId com.example.app # Elenco di app specifica
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —appId | string | ID dell'applicazione da elencare (facoltativo, elenca tutti se omesso) |
| —locale | boolean | Elenca le credenziali da solo il file locale .capgo-credentials.json |
🔹 Pulisci
Sezione intitolata “ 🔹 Pulisci”npx @capgo/cli@latest build credentials clearPulisci le credenziali di costruzione salvate. Rimuovi le credenziali dallo storage. Usa —appId e —piattaforma per targetizzare specifiche credenziali. Esempi: npx @capgo/cli build credentials clear # Pulisci tutte le app (globale) npx @capgo/cli build credentials clear —locale # Pulisci le credenziali locali npx @capgo/cli build credentials clear —appId com.example.app —piattaforma ios
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| —IDApplicazione | string | IDApplicazione 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 |
🔹 Aggiornamento
Sottosezione intitolata “ Aggiornamento”npx @capgo/cli@latest build credentials updateAggiorna le credenziali specifiche senza fornire tutte di nuovo. Aggiorna le credenziali esistenti fornendo solo i campi che vuoi modificare. La piattaforma viene rilevata automaticamente dalle opzioni che fornisci. Esempi: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —locale —keystore ./new-keystore.jks
Opzioni:
| Parametri | Tipo | Descrizione |
|---|---|---|
| —appId | string | ID dell'applicazione (auto-detectato da capacitor.config se omesso) |
| —piattaforma | string | Piattaforma: ios o android (auto-detectato dalle opzioni) |
| —locale | boolean | Aggiorna il file locale .capgo-credentials.json al posto di quello globale |
| —certificato | string | Percorso del file del certificato P12 |
| —profilo di provisioning ios | string | Percorso del profilo di provisioning o bundleId=path (ripetibile, aggiuntivo per impostazione predefinita) |
| —overwrite-ios-provisioning-map | boolean | Sostituisci l'intero mappa di provisioning al posto di unire (impostazione predefinita: unione) |
| —p12-password | string | Password del certificato P12 |
| —apple-key | string | Percorso della chiave App Store Connect API (.p8 file) |
| —apple-key-id | string | ID della chiave App Store Connect API |
| —apple-issuer-id | string | ID dell'emittente App Store Connect |
| —apple-team-id | string | ID del Team di App Store Connect |
| —apple-id | string | E-mail Apple ID per l'upload di password app-specific (alternativa all'ID del team di App Store Connect API) |
| —apple-app-specific-password | string | Password app-specific (xxxx-xxxx-xxxx-xxxx) per l'upload su TestFlight |
| —apple-app-id | string | ID numerico di App Store Connect per l'upload su iOS (richiesto insieme a —apple-id e —apple-app-specific-password) |
| —ios-distribution | string | Modalità di distribuzione per iOS |
| —keystore | string | Percorso del file del keystore (.keystore o .jks) |
| —keystore-alias | string | Alias della chiave del keystore |
| —password-chiave-keystore | string | Password della chiave del keystore |
| —password-archiviazione-keystore | string | Password di archiviazione del keystore |
| —configurazione-play | string | Percorso del file JSON del servizio account Google Play |
| —flavor-android | 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 rilasci (intero 0-5; maggiore = più urgente). |
| —upload-output | boolean | Carica gli output di costruzione (IPA/APK/AAB) su Capgo archiviazione e stampa i collegamenti di download |
| —no-output-upload | boolean | Non caricare gli output di costruzione (IPA/APK/AAB) su Capgo archiviazione |
| —output-retention | string | Durata del collegamento di output: 1h a 7d. Esempi: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Saltare l'aumento automatico del numero di costruzione/code/ nella costruzione futura |
| —no-skip-build-number-bump | boolean | Riabilitare l'aumento automatico del numero di costruzione (comportamento predefinito) |
| —skip-marketing-version-bump | boolean | Saltare l'aumento automatico della versione di marketing nella costruzione futura quando l'app è già rilasciata |
| —no-skip-marketing-version-bump | boolean | Abilita nuovamente l'aumento automatico della versione di marketing (comportamento predefinito) |
🔹 Gestisci
Sezione intitolata “ 🔹 Gestisci”npx @capgo/cli@latest build credentials manageGestisci interattivamente le credenziali di costruzione salvate.
Esegui una ricerca tra le credenziali memorizzate, 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:
| Parametro | 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
Sottosezione intitolata “ Migrare”npx @capgo/cli@latest build credentials migrateMigrare 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:
| Param | Tipo | Descrizione |
|---|---|---|
| —appId | string | ID dell'app (auto-detectato da capacitor.config se omesso) |
| —piattaforma | string | Piattaforma (solo ios è supportata) |
| —locale | boolean | Migrare da locale .capgo-credentials.json anziché globale |