🔹 Costruisci
Copia un prompt di impostazione con i passaggi di installazione e la guida markdown completa per questo plugin.
🏗️ Gestisci costruzioni native per iOS/Android tramite Capgo Cloud.
Accesso e output di costruzione
Sezione intitolata “Accesso e output di costruzione”Le costruzioni cloud native sono disponibili su ogni piano Capgo. I credenziali di costruzione non vengono mai memorizzate sui server Capgo: vengono utilizzate solo per la costruzione e poi cancellate. Gli output di costruzione possono essere caricati optionalmente con link di download a tempo limitato.
Salva le credenziali per primo
Section titled “Save credentials first”npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidSezione intitolata “Cattura un URL di output in CI”
Cattura un URL di output nel CIPass --output-record persistere l'URL di download e il QR code, quindi utilizzare 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
Sezione intitolata “ 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 --verboseOpzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a | string | API chiave per collegarsi al tuo account |
| -c | string | Canale da confrontare. Predefinito su CapacitorUpdater.defaultChannel o il canale pubblico predefinito |
| —package-json | string | Periferiche per file package.json per progetti monorepo (separate da virgole) |
| —node-modules | string | Periferiche per directory node_modules per progetti monorepo (separate da virgole) |
| —verbose | boolean | Abilita l'output verboso con registrazione dettagliata |
| —supa-host | string | URL host personalizzato per Supabase (per hosting self o Capgo sviluppo) |
| – supa-anon | string | Chiave anonima personalizzata per Supabase (per hosting self) |
🚀 Inizia
Sezione intitolata “ 🚀 Inizia”Alias: onboarding
npx @capgo/cli@latest build initConfigura le credenziali di build interattivamente (iOS: certificati + profili automatizzati; Android: keystore + Google OAuth fornisce account del servizio GCP e invita alla console di gioco)
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| -a | string | API chiave per collegarsi al tuo account |
| -p | string | Piattaforma da abilitare (ios o android). Se omesso, auto-detecta quando esiste solo una cartella nativa; sollecita altrimenti. |
| —supa-host | string | URL host personalizzato di Supabase (per hosting self o Capgo sviluppo) |
| —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 costruzione nativa da Capgo Cloud. Questo comando comprimerà il tuo directory di progetto e lo invierà a Capgo per la costruzione. La costruzione verrà elaborata e inviata direttamente ai negozi di app. Le credenziali non vengono mai memorizzate sui server di Capgo; vengono eliminate dopo la costruzione. Salvali prima di richiedere una costruzione:
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 |
|---|---|---|
| —percorso | string | Percorso del directory del progetto da costruire (predefinito: directory corrente) |
| —node-modules | string | Percorsi dei directory node_modules per i monorepos (separati da virgola) |
| —piattaforma | string | Piattaforma di destinazione: ios o android (obbligatoria) |
| —build-mode | string | Modalità di costruzione: debug o release (predefinito: release) |
| —certificato-base64-di-costruzione | string | iOS: Certificato .p12 in codice Base64 |
| —password-p12 | string | iOS: Password del certificato (facoltativa se il certificato non ha password) |
| —apple-id | string | iOS: indirizzo email Apple ID per upload password app-specifica (alternativa alla chiave App Store Connect API) |
| —apple-app-specific-password | string | iOS: password specifica per l'upload su TestFlight (xxxx-xxxx-xxxx-xxxx) |
| —apple-app-id | string | iOS: ID numerico di App Store Connect per l'app (richiesto 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 App Store Connect API codificata in Base64 (.p8) |
| —app-store-connect-team-id | string | iOS: ID della squadra di App Store Connect |
| —ios-scheme | string | iOS: schema Xcode per la costruzione (predefinito: App) |
| —ios-target | string | iOS: obiettivo Xcode per la lettura delle impostazioni di compilazione (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 del keystore codificato in Base64 |
| —keystore-key-alias | string | Android: Alias chiave keystore |
| —chiave-password-keystore | string | Android: Password chiave keystore |
| —password-magazzino-keystore | string | Android: Password magazzino keystore |
| —json-config-play | string | Android: JSON Google Play servizio account codificato in Base64 |
| —flavor-android | string | Android: Flavore prodotto da costruire (ad esempio, produzione). Richiesto se il progetto ha più gusti. |
| —track-android | 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 |
| —stato-rilascio-android | string | Android: stato di pubblicazione su Google Play (bozza, completato, in corso, interrotto). Predefinito senza —submit-to-store-review: bozza. Con —submit-to-store-review e nessun stato impostato: completato. Precedenza: CLI > ambiente > credenziali salvate |
| —priorità di aggiornamento in-app | string | Android: priorità di aggiornamento in-app per questa versione (intero 0–5; maggiore = più urgente). Vedi https://developer.android.com/guide/playcore/in-app-updates. Precedenza: CLI > ambiente > credenziali salvate |
| —no-playstore-upload | boolean | Evita l'upload su Play Store per questa build (nullifica la configurazione salvata di Play). Richiede --output-upload. |
| —submit-to-store-review | boolean | After upload, submit the store release for review instead of leaving it as a draft/inactive build. On Android this defaults to the production track with release_status completed (override with —android-track / PLAY_STORE_TRACK and —android-release-status / PLAY_STORE_RELEASE_STATUS). On iOS this submits the processed TestFlight build to App Store review. |
| —store-release-name | string | Store release name/version label. Android sends this as the Google Play version_name; iOS uses it as the App Store version when creating or reusing the editable version. |
| —store-release-notes | string | Nota di rilascio dello store predefinito. L'Android utilizza questo come il changelog di Play; l'iOS lo utilizza come testo "Cosa è nuovo" dello store App. |
| —store-release-notes-locale | string | Nota di rilascio dello store localizzata (ripetibile), ad esempio —store-release-notes-locale en-US=“Bug fixes” —store-release-notes-locale fr-FR=“Correzioni”. |
| —ios-testflight-gruppi | string | iOS: nomi o ID dei gruppi di TestFlight esterni separati da virgole per la distribuzione beta esterna. |
| —ios-automatic-release | boolean | iOS: rilascia automaticamente la versione per l'App Store dopo l'approvazione di Apple. Predefinito: rilascio manuale. |
| —no-ios-automatic-release | boolean | iOS: conserva la versione dell'App Store in attesa di una rilascio manuale dopo l'approvazione di Apple. |
| —output-upload | boolean | Sovrascrivi il comportamento di caricamento dell'output per questa sola costruzione (abilitato). Precedenza: CLI > ambiente > credenziali salvate |
| —no-output-upload | boolean | Override il comportamento di caricamento degli output per questa costruzione solo (disabilita). Precedenza: CLI > ambiente > credenziali salvate |
| –output-retention | string | Override il TTL del collegamento degli output per questa costruzione solo (1h a 7d). Esempi: 1h, 6h, 2d. Precedenza: CLI > ambiente > credenziali salvate |
| –output-record | string | Dopo una costruzione riuscita, scrivi un record JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) in un percorso. Un PNG QR code viene anche scritto accanto a quel percorso con il .qr.png suffix. Leggi i campi di nuovo con build last-output. |
| –no-cache | boolean | Saltare il ripristino della cache di costruzione e Non salvare un nuovo elemento di cache per questa build. La cache dei build è abilitata per impostazione predefinita per ogni app. |
| –cache-key | string | Dividi la cache di costruzione per ambiente, branch o flavor Android (ad esempio prod, staging. Omettere per una cache condivisa predefinita per app. |
| —no-skip-build-number-bump | boolean | Sostituisci le credenziali salvate per riabilitare l'aumento automatico del numero di build per questo build solo. |
| —skip-marketing-version-bump | boolean | Saltare l'aumento automatico della versione di marketing (CFBundleShortVersionString / versionName) se l'app è già stata rilasciata. |
| —sync-ios-version | boolean | IOS: sincronizza MARKETING_VERSION di Xcode da package.json prima di caricare il progetto. |
| —ai-analytics | boolean | In caso di errore di build, invia i log a Capgo AI per la diagnosi. In terminali interattivi questo salta la conferma iniziale; in CI questo carica automaticamente e stampa l'analisi su stderr. |
| —no-prescan | boolean | Saltare lo scansionamento pre-blocco automatico |
| —prescan-ignore-fatal | boolean | Esegui lo scan pre-costruzione ma non blocca mai la costruzione (rilascia solo rapporti) |
| ---prescan-skip | string | Evita specifiche verifiche di prescan con id (ripetibili o separate da virgola). Le altre verifiche proseguono comunque. |
| ---prescan-warn | string | Abbassare la priorità di specifiche verifiche prescan a avviso tramite ID (ripetibili o separati 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, invia automaticamente i log di costruzione a 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 collegare il tuo account |
| —supa-host | string | URL host personalizzato di Supabase (per hosting self o Capgo sviluppo) |
| —supa-anon | string | chiave anon personalizzata di Supabase (per hosting self) |
| —verbose | boolean | Abilita l'output dettagliato con registrazione di logging |
Cache 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 un costruzione pulita unica. Le integrazioni API possono passare cache_key o cache_enabled: false nel payload della richiesta di costruzione. Vedi Build cache e Risoluzione dei problemi: ripristino cache errato.
🔹 Sync-ios-version
Sezione intitolata “ 🔹 Sync-ios-version”npx @capgo/cli@latest build sync-ios-versionSincronizza la versione iOS Xcode MARKETING_VERSION da package.json.
Esempio:
npx @capgo/cli@latest build sync-ios-version --path .Opzioni:
| Param | Tipo | Descrizione |
|---|---|---|
| —path | string | Percorso del directory del progetto (default: directory corrente) |
| —check | boolean | Verifica solo; esce con codice non zero quando MARKETING_VERSION è fuori sincronia |
🔹 Prescan
Finestra del terminalenpx @capgo/cli@latest build prescanScansiona il tuo progetto e le credenziali salvate per problemi che fallirebbero una costruzione cloud — prima di caricare qualsiasi cosa.
Controlla 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 Scansioni di prescan per la verifica completa del catalogo e come fare --skip / --warn le regole individuali.
Opzioni:
| Parametro | Tipo | context |
|---|---|---|
| Descrizione | string | Piattaforma di destinazione: ios o android (obbligatoria) |
| —path | string | Percorso del directory del progetto (predefinito: 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 | Esegui un rapporto JSON leggibile da macchina |
| —uscita-zero-al-warn | boolean | Uscire con codice 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 (ripetibili o separate da virgola) |
| —avviso | string | Abbassare specifiche verifiche a avviso (ripetibili o separate da virgola) |
| —verboso | boolean | Abilita l'output verboso con registrazione dettagliata |
| —host-supabase | string | URL host personalizzato di Supabase (per hosting self o Capgo sviluppo) |
| —supa-anon | string | Chiave anon personalizzata di Supabase (per hosting self) |
🔹 Ultimo output
Sezione intitolata “ 🔹 Ultimo output”npx @capgo/cli@latest build last-outputLeggi il record dell'output di costruzione scritto da un precedente build request --output-record.
Stampa il JSON completo per impostazione predefinita, 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 inviarlo 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 | context |
|---|---|---|
| Descrizione | string | Percorso del record JSON scritto da —output-record (obbligatorio) |
| —field | string | Stampa un campo singolo (uno di: jobId, appId, piattaforma, buildMode, stato, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Stampa il codice QR ASCII code (abbreviazione di —field qrCodeAscii) |
🔹 Credentials
Sezione intitolata “ 🔹 Credenziali”Gestisci le credenziali di costruzione memorizzate localmente sul tuo computer. 🔒 SICUREZZA:
- Credenziali salvate in ~/.capgo-credentials/credentials.json (globale) o .capgo-credentials.json (locale)
- Eliminate da Capgo immediatamente dopo la costruzione
- Rimosso da Capgo immediatamente dopo la costruzione
- Output dei build possono essere caricati facoltativamente per collegamenti di download a tempo limitato 📚 DOCUMENTAZIONE: configurazione iOS: https://capgo.app/docs/cli/costruzione-cloud/ios/ Setup Android: https://capgo.app/docs/cli/costruzione-cloud/android/
🔹 Chiave Apple
Sezione intitolata “ Chiave Apple”Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyCreare una chiave API per un team App Store Connect con un helper guidato per macOS (solo 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 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 (disabilitare 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 collegarsi al tuo account |
| —appId | string | Salva la chiave catturata nei credenziali di build iOS di questa app |
| —locale | boolean | Salva nella file per-progetto .capgo-credentials.json anziché nel file globale |
| —json | boolean | Stampa la chiave ID / Issuer ID / percorso della chiave .p8 in formato JSON |
npx @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 il flag —local)
⚠️ RICHIESTO PRIMA DELLA COSTRUZIONE: Devi salvare le credenziali prima di richiedere una costruzione.
🔒 Queste credenziali sono mai memorizzate permanentemente sui server Capgo.
Sono eliminate immediatamente dopo la costruzione si completa.
📚 Guida di configurazione:
iOS: https://capgo.it/docs/cli/costruzione-cloud/ios/
Android: https://capgo.app/docs/cli/costruzione-cloud/android/
npx @capgo/cli build credentials save —piattaforma ios
—certificato ./cert.p12 —p12-password “password”
—profilo di provisioning iOS ./profile.mobileprovision
—chiave dell'Apple ./AuthKey.p8 —chiave dell'Apple-id “KEY123”
—apple-issuer-id “identificativo-uuid-emittente” —apple-team-id “codice-di-team” Esempio di destinazione multipla (app + estensione widget): npx @capgo/cli build credentials save —piattaforma ios
—profilo di provisioning iOS ./App.mobileprovision
—ios-provisioning-profile com.example.widget=./Widget.mobileprovision
… npx @capgo/cli build credentials save —piattaforma android
—keystore ./release.keystore —keystore-alias “nome-chiave”
—keystore-key-password “password-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 App (ad esempio, com.esempio.app) (obbligatorio) |
| —piattaforma | string | Piattaforma: ios o android (obbligatorio) |
| —certificato | string | iOS: Percorso del file del certificato .p12 |
| —profilo-di-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 App Store Connect API |
| —chiave-apple-id | string | iOS: ID chiave App Store Connect API |
| —apple-issuer-id | string | iOS: ID rilasciatore App Store Connect |
| —apple-team-id | string | iOS: ID team App Store Connect |
| —distribuzione-ios | string | iOS: Modalità di distribuzione |
| —apple-id | string | iOS: Indirizzo e-mail Apple ID per l'upload di password per applicazioni (alternativa alla chiave App Store Connect API) |
| —apple-app-specific-password | string | iOS: Password specifica dell'app (xxxx-xxxx-xxxx-xxxx) per le pubblicazioni su 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 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 al file JSON del servizio account di Store |
| —flavor-di-android | string | Android: Flavore del prodotto da costruire (ad esempio la produzione). Richiesto se il tuo progetto ha più gusti. |
| —priorità-di-aggiornamento-in-app | string | Priorità di aggiornamento in-app per Google Play per rilasci futuri (intero 0–5; maggiore = più urgente). Omettere per lasciare invariato il valore esistente di Play. |
| —locale | boolean | Salva in .capgo-credentials.json nella radice del progetto al posto di ~/.capgo-credentials/ |
| —carica-output | boolean | Carica output di costruzione (IPA/APK/AAB) su Capgo archiviazione e stampa collegamenti di download |
| —non-carica-output | boolean | Non caricare gli output di costruzione (IPA/APK/AAB) su Capgo archiviazione |
| ---output-retention | string | Durata link TTL: 1h a 7g (predefinito: 1h). Esempi: 1h, 6h, 2g |
| ---skip-build-number-bump | boolean | Saltare l'aumento automatico del numero di build/versione code nelle future costruzioni |
| ---no-skip-build-number-bump | boolean | Riabilitare l'aumento automatico del numero di build (comportamento predefinito) |
| ---skip-marketing-version-bump | boolean | Saltare l'aumento automatico della versione di marketing nelle future costruzioni quando l'app è già rilasciata |
| ---no-skip-marketing-version-bump | boolean | Riabilitare l'aumento automatico della versione di marketing (comportamento predefinito) |
📋 Elenco
Scheda 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 specifiche
Opzioni:
| Parametro | Tipo | context |
|---|---|---|
| Descrizione | string | ID dell'applicazione da elencare (facoltativo, elenca tutti se omesso) |
| —local | boolean | Elenca le credenziali dal file locale .capgo-credentials.json solo |
npx @capgo/cli@latest build credentials clearPulisci le credenziali di costruzione salvate. Elimina le credenziali dallo storage. Utilizza —appId e —platform per selezionare le credenziali specifiche. 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 | context |
|---|---|---|
| Descrizione | string | ID dell'applicazione da cancellare (facoltativo, cancella tutte le app se omesso) |
| —platform | string | Piattaforma da cancellare: ios o android (facoltativo, cancella tutte le piattaforme se omesso) |
| —locale | boolean | Elimina le credenziali locali da .capgo-credentials.json anziché globali |
🔹 Aggiorna
Sezione intitolata “ Aggiorna”npx @capgo/cli@latest build credentials updateAggiorna le credenziali specifiche senza fornire tutte le informazioni 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 —locale —keystore ./new-keystore.jks
Opzioni:
| Parametro | Tipo | Descrizione |
|---|---|---|
| ID dell'app | string | ID App (determinato automaticamente da capacitor.config se omesso) |
| —piattaforma | string | Piattaforma: ios o android (determinato automaticamente dalle opzioni) |
| —locale | boolean | Aggiorna il file locale .capgo-credentials.json anziché 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 di default) |
| —sovrascrivi-mappa-di-provisioning-ios | boolean | Sostituisci l'intera mappa di provisioning al posto di unirsi (default: unione) |
| —password-p12 | string | Password del certificato P12 |
| —chiave-apple | string | Percorso della chiave App Store Connect API (.p8 file) |
| —chiave-apple-id | string | ID chiave App Store Connect API |
| —apple-issuer-id | string | ID emittente App Store Connect |
| —apple-team-id | string | ID team App Store Connect |
| —apple-id | string | iOS: indirizzo email Apple ID per upload password app-specifiche (alternativa alla chiave App Store Connect API) |
| —apple-app-specific-password | string | iOS: Password dell'applicazione (xxxx-xxxx-xxxx-xxxx) per le pubblicazioni su TestFlight |
| —apple-app-id | string | iOS: ID numerico dell'applicazione di App Store Connect (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 |
| —keystore-key-password | string | Password della chiave del keystore |
| —keystore-store-password | string | Password del keystore di archiviazione |
| ---play-config | string | Percorso del file JSON del servizio account Google Play |
| ---android-flavor | string | Android: Nome del flavor di prodotto da costruire (ad esempio, produzione). Richiesto se il progetto ha più flavor. |
| ---in-app-update-priority | string | Android: Priorità dell'aggiornamento in-app di Google Play per le future rilasci (intero 0–5; più alto = più urgente). |
| ---output-upload | boolean | Carica output di build (IPA/APK/AAB) su Capgo archiviazione e stampa collegamenti di download |
| ---no-output-upload | boolean | Non caricare gli output di costruzione (IPA/APK/AAB) nel Capgo storage |
| ---output-retention | string | Durata link TTL: 1h a 7d. Esempi: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | Saltare l'aggiornamento automatico del numero di costruzione/versione code nelle future costruzioni |
| ---no-skip-build-number-bump | boolean | Riabilitare l'aggiornamento automatico del numero di costruzione (comportamento predefinito) |
| —skip-marketing-version-bump | boolean | Saltare l'aggiornamento automatico della versione di marketing nelle future costruzioni quando l'app è già rilasciata |
| ---no-skip-marketing-version-bump | boolean | Riabilire il comportamento di versione di marketing automatico (comportamento predefinito) |
🔹 Gestisci
Scheda intitolata “ 🔹 Gestisci”npx @capgo/cli@latest build credentials manageGestisci interattivamente le credenziali di costruzione salvate.
Esegui una ricerca tra le credenziali archiviate, visualizza cosa è configurato, esporta un file .env pronto per la 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) |
| —platform | string | Piattaforma da gestire: ios o android (facoltativo, richiede di scegliere se omesso) |
| —local | boolean | Solo esplora file locali .capgo-credentials.json |
npx @capgo/cli@latest build credentials migrateMigra 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'applicazione (auto-detectato da capacitor.config se omesso) |
| —piattaforma | string | Piattaforma (solo ios è supportata) |
| —locale | boolean | Migrare da locale .capgo-credentials.json al posto di globale |