How long does an iOS build take?

A typical native build takes 2–3 minutes. Logs stream to your terminal while it runs, so you see errors as they happen.

Can the build go straight to TestFlight?

Yes. With an App Store Connect API key in your credentials, the signed build uploads to App Store Connect, where you test it in TestFlight and submit it for App Store review. Add --output-upload if you also want a download link for the IPA.

Where are my certificates stored?

On your machine, in ~/.capgo-credentials/credentials.json by default, or in your CI secrets. They are sent to Capgo only for the duration of a build and deleted afterwards.

Do I need a new build for every change?

No. Plugin, permission, icon, and Capacitor version changes need a new native build. JavaScript, HTML, CSS, and asset changes can ship as live updates to users who already have the store build.

Per gli sviluppatori di Windows e Linux

Costruisci app iOS senza possedere un Mac

Esegui Capgo Build che compila e firma la tua Capacitor app iOS sulle macchine Mac in cloud. Esegui un solo comando CLI da Windows, Linux o CI, e il build firmato carica su App Store Connect per TestFlight.

2-3 min

costruzione nativa tipica

iOS + Android

costrui con lo stesso CLI

TestFlight

Carica direttamente su App Store Connect

Capgo Build

npx @capgo/cli@latest build init --platform ios
npx @capgo/cli@latest build request --platform ios
# signed build runs on an ephemeral Mac runner
# logs stream back to your terminal

Costrui senza Mac

I build iOS vengono eseguiti su Mac mini M4 dedicati. Li avvii dal computer che già utilizzi.

Firmato e caricato

Il build è firmato con il tuo certificato e caricato su App Store Connect, pronto per TestFlight.

Il Problema

Nessun Mac, nessun build iOS

Costruire senza Mac

Gli strumenti di build di Apple richiedono macOS. Un sviluppatore su Windows o Linux non può compilare o firmare un build iOS sul proprio computer.

La firma vive su un solo portatile

I certificati e i profili spesso si trovano su un solo Mac. Quando quella persona non è presente o un profilo scade, la release attende.

Un CI macOS auto-hosted è il suo stesso progetto

Un runner macOS noleggiato richiede comunque aggiornamenti di Xcode, Fastlane, segreti di firma e debug quando Apple cambia qualcosa.

Il lavoro nascosto

Cosa serve per una rilascia oltre un Mac

Acquistare un Mac risolve solo il problema hardware. È necessario comunque configurare un account Apple, firmare i file e utilizzare strumenti di build che qualcuno aggiorna.

Configurazione di Apple

Un account Apple Developer con diritti di amministratore, un ID bundle, un record dell'applicazione App Store Connect e una chiave API per le upload.

Firma di file e profili

Un certificato di distribuzione esportato come .p12, un profilo di provisioning per ogni ID di bundle e rinnovi quando scadono.

Strumenti di costruzione

La versione giusta di Xcode, CocoaPods o Swift Package Manager, Fastlane e un posto per tenere i segreti per il CI.

Come funziona

How Windows and Linux developers ship iOS with Capgo

Avete bisogno di un'app Capacitor, un account Capgo e un account Apple Developer. Ogni comando riportato di seguito proviene dai documenti Capgo CLI di Capgo

Configura la firma iOS una volta

Il processo di onboarding legge il tuo progetto Capacitor, crea il certificato di distribuzione e il profilo di provisioning, e li salva sul tuo computer.
```
npx @capgo/cli@latest build init --platform ios
```
Guida di costruzione iOS

O salvare i file di firma che già hai

Se il tuo team ha già un certificato e un profilo, salvali con la tua chiave API di App Store Connect. Restano in un file di credenziali locale

npx @capgo/cli@latest build credentials save --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key ./AuthKey_XXXXX.p8 \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate ./certificate.p12 \
  --ios-provisioning-profile ./profile.mobileprovision

Gestione delle credenziali

Richiedi la costruzione

Sincronizza la tua costruzione web nel progetto iOS, quindi richiedi la costruzione. I log scorrono nel tuo terminale, e la costruzione firmata viene caricata su App Store Connect per TestFlight
```
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
```
Prima guida di costruzione
Esegui la stessa richiesta in CI

Esporta le tue credenziali salvate come segreti di CI con build credentials manage, imposta CAPGO_TOKEN, e esegui richiesta di build in GitHub Actions, GitLab CI, o qualsiasi runner.
```
npx @capgo/cli@latest build credentials manage
# in your CI job
npx @capgo/cli@latest build request com.example.app --platform ios
```
GitHub Actions setup

La Soluzione

Cosa Capgo Build gestisce per te

Costruzioni native vengono eseguite in cloud quando cambiano i code. Le modifiche web continuano a essere distribuite come aggiornamenti live tra le rilasci delle store.

Cloud Mac solo quando si costruisce

Le costruzioni iOS eseguono su Mac mini M4 dedicati con Xcode installato. Il tuo laptop Windows o Linux, o un esecutore CI, invia la richiesta dalla riga di comando.

Capgo Build overview

Guida all'iscrizione iOS

build init crea il certificato di distribuzione e il profilo di provisioning per te. Utilizza una chiave API App Store Connect, che crei nel tuo browser quando sei su Windows o Linux.

Guida alla costruzione iOS

Stessa riga di comando localmente e in CI

Salva le credenziali una volta e poi esegui la richiesta di build da un terminale, GitHub Azioni, GitLab CI o qualsiasi altra pipeline.

Riferimento comando di costruzione

Costruzioni native più aggiornamenti in tempo reale

Usa Costruzione Capgo quando i plugin, le autorizzazioni, gli iconi o la versione Capacitor cambiano. Invia modifiche JavaScript, CSS e asset come aggiornamenti in tempo reale dopo che gli utenti installano la costruzione del negozio.

Live update o costruzione nativa?

Modello di fiducia

Usa hardware cloud senza cedere le tue code e le chiavi

Il tuo repository rimane sul tuo computer. Capgo tiene i dati solo durante l'esecuzione della costruzione.

Solo il progetto nativo viene caricato

CLI carica la cartella di piattaforma nativa e le dipendenze native. Il tuo repository completo rimane sul tuo computer.

Istruzioni dei log scorrono sul tuo terminale

Build logs stream live while the build runs and are not stored on Capgo servers.

Le credenziali esistono solo durante la costruzione

Certificates and profiles are used in memory during the build and deleted when it finishes. Each build runs in an isolated environment that is destroyed afterwards.

Applicazioni costruite con Capacitor

Le applicazioni operative non dovrebbero attendere un Mac locale

Gli app di scuola, trasporto e supporto ancora richiedono rilasci mobili firmati quando il team è prevalentemente web, supporto o operazioni. I flussi di costruzione ospitati eliminano il bottleneck della singola macchina mentre mantengono i passaggi di firma ripetibili.

Educazione

IRIS ParentMail

L'app di comunicazioni scolastiche dove i team non nativi ancora richiedono rilasci firmati affidabili.

Instalazioni Google Play: 1,2M; Instalazioni Google Play
Valutazione della store: 2.8; Valutazione della store

TRASPORTI E LOCALI

KAI Access: App di prenotazione biglietti ferroviari

L'app di prenotazione dei trasporti dove la consegna della versione non dovrebbe dipendere da una sola macchina del developer.

Instalazioni Google Play: 13,5M; Instalazioni Google Play
Valutazione della store: 3.6; Valutazione della store

Strumenti

Tecnico Virtuale – Supporto Tecnico

Supporto utilità dove le squadre di operazioni hanno bisogno di registrazioni di build mobili ripetibili.

Installa su Google Play: 10,3M; Installa su Google Play
Valutazione della store: 4.3; Valutazione della store

Canale di rilascio successivo

Usa gli stessi controlli di rilascio per la tua app.

Creare un canale di rilascio controllato, pubblicare un piccolo aggiornamento web e tenere pronto il rollback dal primo rilascio.

Segnalazione ripetibile di iOS e Android
Rilascio senza hardware locale
Registrazioni di build di proprietà della CI

Prova dei clienti

Ciò che gli squadre che utilizzano Capgo dicono

5.0/5 valutato da squadre di sviluppatori 9,400+ Squadre Leggi le recensioni

sikafanka

Design, raggio 5

“Capgo Build ci ha aiutato a semplificare il nostro processo di rilascio dell'app Capacitor. Possiamo costruire e distribuire app iOS e Android da un flusso di lavoro chiaro e unico.”

Mikołaj Wilczek

Ingegnere principale di piattaforma mobile, Tellent

“Abbiamo scoperto Capgo inizialmente attraverso i suoi plugin, e questo si è rivelato un ottimo punto di ingresso in un processo di rilascio più efficiente per il nostro team.”

FAQ

Domande sui costruttori nativi

Quali sviluppatori Windows e Linux chiedono prima del loro primo build iOS cloud.

Devo avere un Mac in alcun momento?

Not to compile, sign, or upload. Builds run on Capgo's Mac mini M4 machines. You still need an Apple Developer account. On Windows or Linux, you create the App Store Connect API key in your browser, then the CLI handles certificates and profiles.

Guida di costruzione per iOS

Quanto tempo ci vuole per un build iOS?

Un build nativo tipico richiede 2-3 minuti. I log vengono trasmessi alla tua finestra di comando mentre si esegue, quindi vedi gli errori mentre si verificano.

Primo build guida

Posso far sì che il build vada direttamente a TestFlight?

Sì. Con una chiave App Store Connect API nelle tue credenziali, il build firmato viene caricato su App Store Connect, dove puoi testarlo in TestFlight e inviarlo per la revisione dell'App Store. Aggiungi --output-upload se desideri anche un link di download per l'IPA.

Configurazione del build

Dove sono archiviati i miei certificati?

Sui tuoi dispositivi, in ~/.capgo-credentials/credentials.json di default, o nei segreti del tuo CI. Vengono inviati a Capgo solo per la durata di un build e cancellati successivamente.