Avvio

Copia una riga di impostazione con i passaggi di installazione e la guida markdown completa per questo plugin.

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 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 eseguire la build. 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 build per te alla fine, quindi la tua prima build potrebbe già essere in viaggio. 🎉

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

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

CLI carica il progetto nativo preparato e invia i log di build in tempo reale nella tua finestra del terminale. Capgo Build 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]

Preparazione nel CI - Costruisci il layer web, risolvi le dipendenze private e sincronizza gli asset completati nel progetto nativo.
Caricamento - Il progetto nativo preparato viene caricato in un archivio di cloud sicuro per la costruzione.
Esecuzione della costruzione - Capgo compila e firma il progetto nativo su infrastrutture dedicate.
Flusso dei log - I log in tempo reale scorrono nel tuo terminale tramite Eventi Server-Sent.
Elimina i dati - L'ambiente di costruzione e i dati del progetto temporanei vengono eliminati dopo la costruzione; la conservazione dei dati dipende dalle opzioni selezionate per l'artefatto e la consegna.

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 la 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 padre `alternatives_cta_questions`). Pagina/area: pagina di confronto delle alternative di Capgo per l'aggiornamento in tempo reale. 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 per l'azione di alternativa). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave padre `appflow_cta_questions`). Pagina/area: pagina di confronto e 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 per l'azione di Appflow). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave padre `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 per l'azione di Capawesome). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave padre `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 e 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 Or).

il progetto per compilare e firmare, quindi non richiede i tuoi credenziali di accesso privato a Nexus, CocoaPods SSH o build web. Gli asset web compilati sono già all'interno del 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 la tua 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 del 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/` sottocartella 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
`.env`Segreti	Non sono mai stati caricati

Le tue Responsabilità

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

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

Progetto a Capgo Costruisci.

Sezione intitolata “Cosa __CAPGO_KEEP_0__ Costruisci gestisce”
La compilazione nativa di iOS (Xcode, Fastlane) e Android (Gradle)
Code firma con le tue credenziali
Invio facoltativo per App Store Connect o Google Play
Configurazioni di build nativo supportate e valori delle 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/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'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 per iOS - Imposta le certificazioni e i profili
Configura le build per Android - Imposta le chiavi e Play Store
Risoluzione dei 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 di messaggio `support_policy_troubleshooting_title` (Titolo della sezione di supporto per la risoluzione dei problemi).
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 all'indirizzo supporto@capgo.app