Inizia a utilizzare

Inizia con Capgo Cloud Build e crea il tuo primo build nativo 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 lo è)
• (Non è necessario preparare le credenziali di firma in anticipo — le configureremo nel passaggio successivo.)

Configura le tue credenziali di firma

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

Esegui il tuo primo build

Hai bisogno di essere autenticato 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'onboarding offre di avviare un build per te alla fine, quindi il tuo primo build potrebbe già essere in viaggio. 🎉

Altrimenti, avvia un build da solo con build request — impostalo --platform To qualunque 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 allo store.

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 viene compresso (escluso node_modules e file di sistema
2. Carica - Il file zip viene caricato in un archivio di 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 Costruisci solo carica i file minimi necessari per compilare la tua 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 nativo che stai costruendo
package.json, package-lock.json	Manifesto di dipendenza
capacitor.config.*	Capacitor configurazione
resources/	Icone dell'app, schermate di benvenuto
Plugin nativo code	Solo il ios/ o android/ Sottoalbero 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)	Già sincronizzato nel folder nativo tramite cap sync
.git/	Storia dei controlli di versione
.gradle/, .idea/, .swiftpm/	Caché di compilazione e impostazioni dello sviluppatore IDE
.envsecrets	Non sono mai stati caricati

Nota

I tuoi asset web costruiti (JS, CSS, HTML) sono caricati - ma come parte della cartella nativa. Quando esegui bunx cap sync, i tuoi file web costruiti vengono copiati in ios/App/App/public/ o android/app/src/main/assets/public/. Quindi è necessario eseguire cap sync prima di costruire.

I tuoi 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. Comitare 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 dell'applicazione su 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 le compilazioni Android - Configura le chiavi e Play Store
• Risoluzione dei problemi - Problemi comuni e soluzioni
• CLI Riferimento - Documentazione completa della riga di comando

Aiuto necessario?

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