Per iniziare

Inizia con Capgo Cloud Build e crea la tua prima build nativa per iOS o Android in pochi minuti.

Cosa ti serve

Prima di iniziare, assicurati di avere:

• Un'app Capacitor che builda correttamente in locale
• Node.js 20 o superiore installato
• Un account Capgo (basta una prova gratuita per iniziare)
• La tua app è già registrata in Capgo (esegui npx @capgo/cli@latest app add se non)
• (Non serve preparare le credenziali di firma in anticipo: le configureremo nel passaggio successivo.)

Configura le tue credenziali di firma

Capgo richiede le credenziali di firma per buildare e pubblicare la tua app, ma non devi gestirle a mano. Rispondi a un paio di domande e ti indicheremo il comando esatto da eseguire:

Esegui la tua prima build

Devi essere autenticato con Capgo per buildare. Se non l'hai ancora fatto:

npx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

Se hai appena eseguito build init, sei già a posto: l'onboarding ti propone di avviare una build per te alla fine, quindi la tua prima build potrebbe essere già partita. 🎉

Altrimenti, avvia tu stesso una build con build request — imposta --platform per la piattaforma che stai buildando:

npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

CLI carica il progetto nativo preparato e mostra i log di build in tempo reale nel terminale. Capgo Build può restituire un artifact firmato o inviarlo ad App Store Connect o Google Play quando configuri il flusso di rilascio appropriato.

Capire il processo di build

Quando esegui il comando di build, ecco cosa succede:

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Preparazione nella tua CI - Esegui il build del layer web, risolvi le dipendenze private e sincronizza gli asset finali nel progetto nativo.
2. Carica - Il progetto nativo preparato viene caricato su uno storage cloud sicuro per la build.
3. Esecuzione della build - Capgo compila e firma il progetto nativo su infrastruttura dedicata.
4. Streaming dei log - I log in tempo reale vengono trasmessi al terminale tramite Server-Sent Events.
5. Pulizia - L'ambiente di build e i dati temporanei del progetto vengono puliti dopo la build; la conservazione dell'output dipende dall'artefatto selezionato e dalle opzioni di consegna allo store.

Usa Capgo Build con Bitrise o un'altra CI

Capgo Build non sostituisce il tuo CI esistente. Mantieni in Bitrise o in un altro sistema CI i passaggi che richiedono accesso privato: installazione da registri privati, risoluzione di CocoaPods privati via SSH, esecuzione di setup nativi personalizzati, build del layer web ed esecuzione di npx cap sync.

Poi chiama Capgo Build con il progetto nativo preparato. Capgo riceve il progetto pronto ios/ oppure android/ un progetto da compilare e firmare, quindi non richiede le tue credenziali private per Nexus, SSH CocoaPods o web-build. Gli asset web compilati sono già inclusi nel progetto nativo preparato; vengono usati per la build invece di essere conservati come repository sorgente.

Cosa viene compilato

Capgo Build riceve il progetto nativo preparato necessario per compilare la tua app. Il tuo codice sorgente web code, l'installazione delle dipendenze private e la sincronizzazione Capacitor restano nella tua CI.

Cosa viene caricato

Incluso	Descrizione
ios/ oppure android/	La cartella della piattaforma nativa che stai compilando
package.json, package-lock.json	Manifest delle dipendenze
capacitor.config.*	Configurazione Capacitor
resources/	Icone app e splash screen
Plugin nativo code	Solo la ios/ oppure android/ sottocartella di ogni plugin Capacitor

Cosa NON viene caricato

Esclusi	Perché
node_modules/ (la maggior parte)	Viene incluso solo il plugin nativo code, non le dipendenze JS
src/	La tua sorgente web code resta locale
dist/, www/, build/ (livello radice)	Già sincronizzata nella cartella nativa tramite cap sync
.git/	Cronologia del versionamento
.gradle/, .idea/, .swiftpm/	Cache di build e impostazioni IDE
.env, segreti	Mai caricati

Nota

I tuoi asset web compilati (JS, CSS e HTML) vengono caricati solo perché npx cap sync li ha copiati nel progetto nativo. La sorgente web e i passaggi di installazione delle dipendenze restano nella tua CI; il progetto nativo preparato viene usato per compilare il binario e poi ripulito.

Le tue responsabilità

Prima di eseguire npx @capgo/cli@latest build request:

1. Preparazione nella tua CI - Risolvi registri di pacchetti privati, CocoaPods basati su SSH, SDK per dispositivi, estensioni e qualsiasi preparazione nativa personalizzata in Bitrise o nel tuo CI esistente.
2. Compila i tuoi asset web - Esegui npm run build (o il comando di build del tuo framework).
3. Sincronizza con il nativo - Esegui npx cap sync per copiare gli asset web compilati nel progetto nativo preparato.
4. Richiedi la build nativa - Invia quanto preparato ios/ oppure android/ progetto per Capgo Build.

Cosa gestisce Capgo Build

• Compilazione nativa iOS (Xcode, Fastlane)
• Compilazione nativa Android (Gradle)
• Firma Code con le tue credenziali
• Invio opzionale su App Store Connect o Google Play
• Configurazione di build nativa supportata e valori delle credenziali passati come variabili d'ambiente

Capgo Build non richiede l'accesso al tuo registro Nexus privato o alle credenziali SSH una volta che la tua CI ha preparato il progetto nativo. Vedi Configurazione build per le variabili d'ambiente e le opzioni di store supportate.

Per una variante kiosk distribuita tramite MDM, configura il progetto/build Android per generare un APK. Quando richiedi la build, usa entrambi i flag per saltare Google Play e recuperare l'output firmato:

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload impedisce l'upload su Play Store anche se le credenziali Play sono salvate; --output-upload fornisce un link temporaneo all'output firmato. Distribuisci quell'APK tramite il tuo MDM.

Prossimi passi

Ora che hai creato la tua prima build:

• Configura le build iOS - Configura certificati e profili
• Configura le build Android - Configura keystore e Play Store
• Risoluzione problemi - Problemi comuni e soluzioni
• Riferimento CLI - Documentazione completa dei comandi

Serve aiuto?

• Consulta la guida alla risoluzione dei problemi
• Unisciti al community Discord
• Supporto via email a support@capgo.app