Inizia

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

Cosa ti Serve

Prima di iniziare, assicurati di avere:

• A Capacitor app che si compila con successo localmente
• Installato Node.js 20 o superiore
• A Capgo account (un'offerta di prova gratuita è sufficiente per iniziare)
• La tua app già registrata in Capgo (esegui npx @capgo/cli@latest app add se non)
• (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 la tua app — ma non devi gestirle manualmente. Rispondi a un paio di domande e ti mostreremo il comando preciso da eseguire:

Esegui la tua prima costruzione

È necessario essere autenticati 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 initSe hai appena eseguito, sei già pronto — l'onboarding offre la possibilità 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 — impostato --platform su quello che 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 La costruzione 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

When 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. Preparati nel tuo CI - Costruisci il layer web, risolvi le dipendenze private e sincronizza gli asset completati nel progetto nativo.
2. Carica - Il progetto nativo preparato viene caricato in un archivio di cloud sicuro per la costruzione.
3. Esecuzione della costruzione - Capgo compila e firma il progetto nativo su infrastrutture dedicate.
4. Flusso dei log - I log in tempo reale scorrono nel tuo terminale tramite Server-Sent Events.
5. Pulizia - L'ambiente di costruzione e i dati del progetto temporanei vengono puliti dopo la costruzione; la conservazione degli output dipende dalle opzioni di selezione dell'artefatto e del servizio di consegna.

Usa Capgo Costruisci 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 il layer web e esegui npx cap sync.

Chiamare poi Capgo Build con il progetto nativo preparato. Capgo riceve il progetto pronto ios/ o android/ per compilare e firmare, quindi non ha bisogno dei tuoi credenziali di accesso privato a Nexus, CocoaPods SSH o build web. Gli asset web compilati sono già all'interno di quel progetto nativo preparato; vengono utilizzati per la costruzione anziché essere mantenuti come repository di origine

Cosa si Costruisce

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

Cosa si Carica

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

Cosa NON viene caricato

Escluso	Perché
node_modules/ (la maggior parte di essa)	Solo il plugin nativo code è incluso, non le dipendenze JS
src/	La tua fonte web code rimane locale
dist/, www/, build/ (livello radice)	Già sincronizzato nel folder nativo tramite cap sync
.git/	Storia dei controlli di versione
.gradle/, .idea/, .swiftpm/	Caché di compilazione e impostazioni IDE
.env, segreti	Non mai caricati

Nota

Il tuo pacchetto web (JS, CSS e HTML) viene caricato solo perché npx cap sync ha copiato loro nel progetto nativo. I passaggi di installazione delle dipendenze e della fonte web 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 - Risolvi registri di pacchetti privati, CocoaPods basati su SSH, SDK di dispositivi, estensioni e qualsiasi preparazione nativa personalizzata in Bitrise o nel tuo CI esistente.
2. Costruisci i tuoi pacchetti 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 nel progetto nativo preparato.
4. Richiedi la compilazione nativa Esegui ios/ o android/ il progetto preparato a Capgo Build.

Cosa gestisce Capgo Build

• Compilazione nativa iOS (Xcode, Fastlane)
• Compilazione nativa Android (Gradle)
• La firma Code con le tue credenziali
• Invio facoltativo su App Store Connect o Google Play
• Configurazioni di build native supportate e valori delle credenziali passati come variabili di ambiente

Capgo La 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 supportate e le opzioni di archiviazione.

Per una versione kiosk distribuita attraverso MDM, configura il progetto Android/build per produrre un APK. Quando richiedi la 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 preclude l'upload su Play Store anche se sono salvate le credenziali di Play; --output-upload fornisce un link temporaneo all'output firmato. Distribuisci quell'APK attraverso il tuo MDM.

Passaggi successivi

Ora che hai creato la tua prima build:

• Configura le costruzioni iOS - Configura i certificati e i profili
• Configura le costruzioni Android - Configura le chiavi e Play Store
• Risoluzione dei problemi - Problemi comuni e soluzioni
• CLI Riferimento - Documentazione completa delle istruzioni del comando

Hai bisogno di aiuto?

• Controlla il guida di risoluzione dei problemi
• Unisciti alla nostra Comunità Discord
• Supporto via email a supporto@capgo.app