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:

• 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 bunx @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 una coppia di domande e ti indicheremo il comando esatto da eseguire:

Esegui la tua prima build

È necessario essere autenticati con Capgo per costruire. Se non l'hai già fatto:

bunx @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'assistenza all'avvio 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:

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

Il CLI carica il tuo progetto, invia i log di costruzione in tempo reale nella tua finestra del terminale e — una volta configurati i tuoi credenziali — invia automaticamente il risultato al negozio.

Capire il processo di costruzione

Quando esegui il comando di costruzione, ecco cosa succede:

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

1. Preparazione locale - Il tuo progetto è compresso (escluso node_modules e file dotfile)
2. Carica - Il file zip viene caricato in un archivio cloud sicuro (Cloudflare R2)
3. Esecuzione di Build - La tua app si costruisce su infrastrutture dedicate
4. Flusso dei Log - I log in tempo reale scorrono nel tuo terminale tramite Server-Sent Events
5. Pulizia Automatica - Gli artefatti di costruzione vengono eliminati (Android: istantaneo, iOS: 24 ore)

Cosa Si Costruisce

Capgo Build only uploads the file minimi necessari per compilare il tuo app nativa. La tua fonte completa code non lascia mai la tua macchina.

Cosa viene caricato

Incluso	Descrizione
ios/ o android/	La cartella del sistema operativo 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/ sottofolder di ogni plugin Capacitor

Cosa NON viene caricato

Escluso	Perché
node_modules/ (la maggior parte di esso)	Solo il plugin nativo code viene 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 dell'IDE
.env, segreti	Non caricato mai

Nota

I tuoi asset web costruiti (JS, CSS, HTML) sono caricati - ma come parte della cartella nativa. Quando esegui bunx cap sync, il tuo build web viene copiato in ios/App/App/public/ o android/app/src/main/assets/public/. Ecco perché è necessario eseguire prima di costruire. cap sync è richiesto prima di costruire.

Le Tue Responsabilità

Prima di eseguire bunx @capgo/cli@latest build:

1. Costruisci i tuoi asset web - Esegui bun run build (o il comando di costruzione del tuo framework)
2. Sincronizza con nativo - Esegui bunx cap sync per copiare gli asset web nel progetto nativo
3. Comita le dipendenze - Assicurati che tutti i plugin nativi siano in package.json

Cosa Capgo Build Gestisce

• Compilazione nativa iOS (Xcode, Fastlane)
• Compilazione nativa Android (Gradle)
• Code firma con le tue credenziali
• Invio all'app store (se configurato)

Passaggi successivi

Ora che hai creato il tuo primo build:

• Configura le compilazioni iOS - Configura le certificazioni e i profili
• Configura edizioni Android - Configura chiavi e Store Play
• Risoluzione dei problemi - Problemi comuni e soluzioni
• CLI Riferimento - Documentazione completa per i comandi

Hai bisogno di aiuto?

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