Avvio

Inizia subito 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 periodo di prova gratuito è 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 l'app — ma non devi gestirle manualmente. Rispondi a una coppia di domande e ti indicheremo il comando esatto da eseguire:

Esegui la tua prima costruzione

Devi essere autenticato con Capgo per compilare. 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'assistenza all'uso offre di avviare una compilazione per te alla fine, quindi la tua prima compilazione potrebbe già essere in viaggio. 🎉

Altrimenti, avvia una compilazione da solo con build request — impostalo su quello che stai costruendo: --platform Fermata dei comandi

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

The CLI uploads the prepared native project and streams build logs live in your terminal. Capgo Build can return a signed artifact or submit it to App Store Connect or Google Play when you configure the appropriate release flow.

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. Caricamento - 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. Eliminazione - L'ambiente di costruzione e i dati del progetto temporanei vengono eliminati dopo la costruzione; la conservazione dell'output dipende dalle opzioni di artefatto e consegna selezionate.

Usa Capgo Costruisci con Bitrise o un altro CI

Capgo Costruisci 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.

Quindi chiama Capgo Costruisci con il progetto nativo preparato. Capgo riceve il progetto pronto ios/ o android/ contesto: frammento di testo HTML da una stringa di Capgo UI più lunga (chiave genitoriale `alternatives_cta_questions`). Pagina/area: pagina di confronto delle alternative di aggiornamento live di Capacitor. Ruolo: paragrafo di marketing o legale lungo. Visto in: pagina alternatives.astro. Preservare i termini di prodotto e marchio di Capgo e i termini di sviluppatore esattamente. Chiave di messaggio `alternatives_cta_questions` (Domande di azione per le alternative). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave genitoriale `appflow_cta_questions`). Pagina/area: pagina di confronto/migrazione di Appflow. Ruolo: paragrafo di marketing o legale lungo. Visto in: pagina ionic-appflow.astro. Preservare i termini di prodotto e marchio di Capgo e i termini di sviluppatore esattamente. Chiave di messaggio `appflow_cta_questions` (Domande di azione per Appflow). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave genitoriale `capwesome_cta_questions`). Pagina/area: pagina di confronto di Capawesome. Ruolo: paragrafo di marketing o legale lungo. Visto in: pagina capwesome.astro. Preservare i termini di prodotto e marchio di Capgo e i termini di sviluppatore esattamente. Chiave di messaggio `capwesome_cta_questions` (Domande di azione per Capwesome). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave genitoriale `consulting_faq_subtitle`). Pagina/area: pagina dei servizi di consulenza. Ruolo: sottotitolo o didascalia di sezione. Visto in: pagina consulting.astro. Preservare i termini di prodotto e marchio di Capgo e i termini di sviluppatore esattamente. Chiave di messaggio `consulting_faq_subtitle` (Sottotitolo delle domande frequenti per la consulenza). | Pagina/area: pagina di confronto/migrazione di Appflow. Ruolo: etichetta di navigazione o elemento di navigazione breve. Visto in: pagina ionic-appflow.astro, pagina ionic-enterprise-plugins.astro, pagina soluzioni/ionic-enterprise-plugins.astro. Chiave di messaggio `appflow_plugins_or` (Appflow Plugins O).

progetto per compilare e firmare, quindi non richiede i tuoi credenziali di accesso privato per 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 conservati come repository di origine.

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

__CAPGO_KEEP_0__ Costruisci riceve il progetto nativo preparato richiesto per compilare il tuo app. La tua fonte web __CAPGO_KEEP_1__, l'installazione delle dipendenze private e __CAPGO_KEEP_2__ rimangono nel tuo CI.

Incluso	Descrizione
ios/ o android/	La cartella di piattaforma nativa che si sta 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/ La cartella di piattaforma nativa che si sta costruendo è un sottodirectory 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 del controllo di versione
.gradle/, .idea/, .swiftpm/	Cache delle costruzioni e impostazioni dell'IDE
.envSegreti	Non sono mai stati caricati

Nota

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

Le tue Responsabilità

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

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

progetto a Capgo Costruisci.

• Sottotitolo della sezione “Cosa __CAPGO_KEEP_0__ Costruisci Gestisce”
• La compilazione nativa di iOS (Xcode, Fastlane)
• Code firma con le tue credenziali
• Invio facoltativo per App Store Connect o Google Play
• Configurazioni di build native supportate e valori di credenziali passati come variabili di ambiente

Capgo La build non richiede l'accesso al tuo registro privato Nexus 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 una versione kiosk distribuita attraverso MDM, configura il progetto Android/costruzione 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'invio sul Play Store anche se sono salvate le credenziali di Play; --output-upload fornisce un collegamento a tempo limitato all'output firmato. Distribuisci quell'APK attraverso il tuo MDM.

Passaggi successivi

Ora che hai creato la tua prima build:

• Configura le build iOS - Configura le certificazioni e i profili
• Configura le build Android - Configura le chiavi e Play Store
• Risolvere i problemi context":"Pagina/area: Supporto / sezione di supporto premium o sezione di supporto del footer. Ruolo: Intestazione di sezione o pagina. Visualizzato in: pagina support-policy.astro. Chiave messaggio `support_policy_troubleshooting_title` (Titolo di supporto per la risoluzione dei problemi della politica di supporto)."
• CLI Reference __CAPGO_KEEP_0__ Riferimento

- Documentazione completa delle comandi

• Controlla il guida di risoluzione dei problemi
• Unisciti alla nostra comunità Discord
• Contattaci tramite email a supporto@capgo.app