Getting Started

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

Cosa ti Serve

Prima di iniziare, assicurati di avere:

• Un'app Capacitor che si costruisce con successo localmente
• Node.js 20 o superiore installato
• Un account Capgo (un trial gratuito è sufficiente per iniziare)
• La tua app già registrata in Capgo (esegui npx @capgo/cli@latest app add se non lo è)
• (Non è necessario preparare le credenziali di firma in anticipo — le configureremo nel passo successivo.)

Configura le tue credenziali di firma

Capgo richiede credenziali di firma per costruire e inviare l'applicazione — ma non devi gestirle manualmente. Rispondi a una coppia di domande e ti indicheremo il comando esatto da eseguire:

Esegui la tua prima costruzione

Hai bisogno di essere autenticato con Capgo per costruire. Se non l'hai già 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à pronto — l'onboarding offre di avviare una costruzione per te alla fine, quindi la tua prima costruzione potrebbe già essere in viaggio. 🎉

Altrimenti, avvia una costruzione da solo con build request — set --platform a qualunque cosa stai costruendo:

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

Il CLI carica il progetto nativo preparato e invia i log di costruzione in tempo reale nella tua finestra del terminale. Capgo Costruisci può restituire un artefatto firmato o inviarlo su App Store Connect o Google Play quando configuri il flusso di rilascio appropriato.

Capire il processo di costruzione

Quando esegui il comando di costruzione, 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 nel tuo CI - Costruisci la layer web, risolvi le dipendenze private e sincronizza gli asset completati nel progetto nativo.
2. Upload Il progetto nativo preparato viene caricato in un archivio di cloud sicuro per la costruzione.
3. Prepare in your CI - Capgo compila e firma il progetto nativo su infrastrutture dedicate.
4. Registrazione dei Log - I log in tempo reale scorrono nel tuo terminale tramite Eventi Server-Sent.
5. Cleanup - Vengono puliti l'ambiente di costruzione e i dati del progetto temporanei dopo la costruzione; la conservazione dell'output dipende dalle opzioni di artefatto e consegna selezionate.

Usa Capgo Build con Bitrise o un altro CI

Capgo Build non sostituisce il tuo CI esistente. Mantieni i passaggi che richiedono l'accesso privato in Bitrise o in un altro sistema CI: installa da registri privati, risolvi CocoaPods privati tramite SSH, esegui l'impostazione nativa personalizzata, costruisci la layer web e esegui npx cap sync.

Chiamare poi Capgo Build con il progetto nativo pronto. Capgo riceve il progetto pronto ios/ o android/ project to compile and sign, so it does not need your private Nexus, CocoaPods SSH, or web-build credentials. The compiled web assets are already inside that prepared native project; they are used for the build rather than retained as a source repository.

Cosa viene costruito

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

Cosa si carica

Incluso	Descrizione
ios/ o android/	La cartella del folder nativo che stai costruendo
package.json, package-lock.json	Manifesto delle dipendenze
capacitor.config.*	Capacitor configurazione
resources/	Icone dell'app, schermate di benvenuto
Plugin nativo code	Solo il ios/ o android/ La sottodirectory di ogni plugin Capacitor

Cosa NON è caricato

Escluso	Perché
node_modules/ (la maggior parte)	Solo il plugin nativo code è incluso, non le dipendenze JS
src/	La tua fonte web code rimane locale
dist/, www/, build/ (livello radice)	Sincronizzato già nella cartella nativa tramite cap sync
.git/	Storia del controllo di versione
.gradle/, .idea/, .swiftpm/	Cache di costruzione e impostazioni IDE
.env, segreti	Non sono mai stati caricati

Nota

I tuoi asset web costruiti (JS, CSS e HTML) vengono caricati solo perché npx cap sync ha copiato loro all'interno del progetto nativo. Le fasi di origine web e di installazione delle dipendenze rimangono nel tuo CI; il progetto nativo preparato viene utilizzato per costruire il binario e poi pulito.

Le tue Responsabilità

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

1. Preparati nel tuo CI Risolve 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. Costruisci i tuoi asset web - Esegui npm run build (o il comando di costruzione del tuo framework).
3. Sincronizza con il nativo - Esegui npx cap sync per copiare gli asset web compilati nella progettazione nativa preparata.
4. Richiedi il build nativo - Invia la preparazione ios/ o android/ progetto per Capgo Costruisci.

progetto a Capgo Costruisci .

• Compilazione nativa iOS (Xcode, Fastlane)
• Compilazione nativa Android (Gradle)
• Code firma con le tue credenziali
• Invio facoltativo su App Store Connect o Google Play
• Valori di configurazione e credenziali di build nativi supportati passati come variabili di ambiente

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

Per un flavour di kiosk distribuito attraverso MDM, configura il progetto Android/costruzione per produrre un APK. Quando richiedi il build, utilizza 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 previene l'upload su Play Store anche se sono salvati i credenziali di Play; --output-upload fornisce un link temporaneo al file APK firmato. Distribuisci questo APK attraverso il tuo MDM.

Next Steps

Ora che hai creato il tuo primo build:

• Configura le build iOS - Configura le certificazioni e i profili
• Configura le build Android - Configura le chiavi e Play Store
• Risolvere i problemi - Problemi comuni e soluzioni
• Riferimento CLI - Documentazione completa del comando

Aiuto?

• Controllate il guida di risoluzione dei problemi
• Unisciti a noi comunità Discord
• Contattate il supporto via supporto@capgo.app