🔹 build

🏗️ Gestisci costruzioni native iOS/Android tramite Capgo Cloud.

🚀 Inizializza

Alias: onboarding

npx @capgo/cli@latest build init

Configura i credenziali di costruzione iOS interattivamente (crea automaticamente certificati e profili). Su macOS, può anche creare la tua chiave App Store Connect API per te, guidato.

🔹 Richiedi

npx @capgo/cli@latest build request

Richiedi una costruzione nativa da Capgo Cloud. Questo comando comprimerà il tuo directory di progetto e lo invierà a Capgo per la costruzione. La costruzione sarà elaborata e inviata direttamente ai negozi di app. 🔒 SICUREZZA: Le credenziali non vengono mai memorizzate sui server di Capgo . Vengono eliminate automaticamente dopo la completamento della costruzione. I risultati di costruzione possono essere caricati facoltativamente per collegamenti di download a tempo limitato. 📋 REQUISITO PRECOSTRIZIONE: Salva le credenziali prima con: npx @capgo/cli build credentials save --appId <app-id> --platform <ios|android>

Esempio:

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)
---piattaforma	string	Piattaforma di destinazione: ios o android (obbligatoria)
---modalità-di-costruzione	string	Modalità di costruzione: debug o release (predefinito: release)
---certificato-base64-di-base	string	IOS: Certificato .p12 in codifica Base64
---password-p12	string	IOS: Password del certificato (facoltativa se il certificato non ha password)
---id-apple	string	IOS: Indirizzo email Apple per l'upload della password app-specifica (alternativa alla chiave App Store Connect API)
---password-app-specifica-di-apple	string	iOS: Password dell'applicazione (xxxx-xxxx-xxxx-xxxx) per le pubblicazioni su TestFlight
—apple-app-id	string	iOS: ID numerico dell'applicazione App Store Connect (richiesto insieme a —apple-id e —apple-app-specific-password)
—apple-key-id	string	iOS: ID chiave App Store Connect API
—apple-issuer-id	string	iOS: ID rilasciatore 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 team App Store Connect
—ios-scheme	string	iOS: Schema Xcode per la costruzione (predefinito: App)
__CAPGO_KEEP_0__	string	iOS: Schema Xcode per la lettura delle impostazioni di costruzione (predefinito: stesso schema)
__CAPGO_KEEP_0__	string	iOS: Modalità di distribuzione
__CAPGO_KEEP_0__	string	iOS: Percorso del profilo di provisioning o bundleId=path mapping (ripetibile)
__CAPGO_KEEP_0__	string	Android: File di keystore codificato in Base64
__CAPGO_KEEP_0__	string	Android: Alias del keystore
__CAPGO_KEEP_0__	string	Android: Password della chiave del keystore
__CAPGO_KEEP_0__	string	Android: Password del keystore
__CAPGO_KEEP_1__	string	Android: JSON codificato in base64 del servizio Google Play account
__CAPGO_KEEP_2__	string	Android: Flavore del prodotto da costruire (ad esempio produzione). Richiesto se il progetto ha più flavor.
__CAPGO_KEEP_3__	boolean	Saltare l'upload su Play Store per questa costruzione (annulla la configurazione di Play salvata). Richiede —output-upload.
Invia la versione caricata per la revisione della store: Android completa la versione di Play; iOS invia la costruzione elaborata di TestFlight per la revisione della App Store.	boolean	__CAPGO_KEEP_4__
—nome di rilascio della store	string	Nome della versione di rilascio/numero. L'Android lo utilizza come nome di rilascio di Google Play; l'iOS lo utilizza come versione di App Store.
—note di rilascio della store	string	Note di rilascio della store di default. L'Android lo utilizza come changelog di Play; l'iOS lo utilizza come testo 'Cosa è nuovo' di fallback di App Store.
—note di rilascio della store localizzata	string	Note di rilascio della store localizzate, ripetibili come locale=notes, ad esempio —store-release-notes-locale “fr-FR=Corrections”.
—gruppi di TestFlight per iOS	string	Solo iOS: nomi o ID dei gruppi di TestFlight esterni separati da virgole per la distribuzione beta.
—rilascio automatico di iOS	boolean	Solo iOS: rilasciare automaticamente la versione di App Store dopo l'approvazione di Apple. Il valore predefinito è il rilascio manuale.
—nessun rilascio automatico di iOS	boolean	Solo iOS: tenere la versione di App Store approvata in attesa di un rilascio manuale.
—output-upload	boolean	Sovrascrivi il comportamento di caricamento degli output per questa costruzione solo (abilita). Precedenza: CLI > ambiente > credenziali salvate
—no-output-upload	boolean	Sovrascrivi il comportamento di caricamento degli output per questa costruzione solo (disabilita). Precedenza: CLI > ambiente > credenziali salvate
—output-retention	string	Sovrascrivi il TTL del collegamento degli output per questa costruzione solo (1h a 7d). Esempi: 1h, 6h, 2d. Precedenza: CLI > ambiente > credenziali salvate
—skip-build-number-bump	boolean	Saltare l'aumento automatico del numero di costruzione/versione code. Utilizza la versione già presente nei file del progetto.
—no-skip-build-number-bump	boolean	Sovrascrivi le credenziali salvate per riabilitare l'aumento automatico del numero di costruzione per questa costruzione solo.
-a,	string	API chiave per collegarsi al proprio account
—supa-host	string	URL host personalizzato di Supabase (per l'hosting self o lo sviluppo Capgo)
—supa-anon	string	Chiave anonima personalizzata di Supabase (per l'hosting self)
—verbose	boolean	Abilita l'output verboso con registrazione dettagliata

--submit-to-store-review, --store-release-name, --store-release-notese --store-release-notes-locale lavora su entrambi Android e iOS. Utilizza --store-release-notes come testo di fallback, quindi ripeti --store-release-notes-locale "locale=notes" per ogni localizzazione del negozio:

npx @capgo/cli@latest build request com.example.app \
  --platform ios \
  --build-mode release \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales" \
  --no-ios-automatic-release

In CI puoi anche fornire le stesse note localizzate come JSON con CAPGO_STORE_RELEASE_NOTES_LOCALIZED, ad esempio {"en-US":"General improvements","nl-NL":"Algemene verbeteringen"}.

🔹 Credenziali

npx @capgo/cli@latest build credentials

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 archiviate permanentemente
• Cancellate da Capgo immediatamente dopo la costruzione
• I risultati di costruzione possono essere caricati facoltativamente per collegamenti di download a tempo limitato 📚 DOCUMENTAZIONE: iOS setup: https://capgo.app/docs/builder/ios/ Configurazione Android: https://capgo.app/docs/builder/android/

Continua con l'edizione

Se stai utilizzando build per pianificare l'automazione CI/CD, connettilo con Capgo CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD, Capgo Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrations, Integrazione CI/CD per la dettaglio di implementazione in Integrazione CI/CD, e GitHub Azioni di integrazione per la dettaglio di implementazione in GitHub Azioni di integrazione.