Salta al contenuto principale

Per sviluppatori Windows e Linux

Crea app iOS senza un Mac

Capgo Il build compila e firma la tua app iOS Capacitor su mac cloud. Esegui un comando CLI da Windows, Linux o CI, e il build firmato viene caricato su App Store Connect per TestFlight.

2–3 min
tipica build nativa
iOS + Android
dallo stesso CLI
TestFlight
upload diretto su App Store Connect
Build Capgo 
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

Mac basati su Cloud

Le build iOS girano su Mac mini M4 dedicati. Le avvii dal computer che già utilizzi.

Firmato e caricato

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

Il problema

Xcode funziona solo su macOS

Niente Mac, niente build iOS

Gli strumenti di build di Apple richiedono macOS. Uno sviluppatore su Windows o Linux non può compilare o firmare un build iOS sulla propria macchina.

La firma è vincolata a un laptop

Certificati e profili spesso risiedono sul Mac di una sola persona. Se quella persona non c'è o un profilo scade, il rilascio si ferma.

Gestire un macOS CI self-hosted è un progetto a sé

Un runner macOS a noleggio richiede comunque aggiornamenti di Xcode, lane di Fastlane, segreti di firma e debugging quando Apple cambia qualcosa.

Il lavoro nascosto

Cosa serve per un release build oltre a un Mac

Comprare un Mac risolve solo la parte hardware. Dovrai comunque configurare l'account Apple, firmare i file e gestire i tool di build che richiedono manutenzione costante.

1

Configurazione account Apple

Un account Apple Developer con permessi admin, un bundle ID, un record app su App Store Connect e una chiave API per gli upload.

2

Firma di file e profili

Un certificato di distribuzione esportato in .p12, un provisioning profile per ogni bundle ID e i rinnovi quando scadono.

3

Tooling di build

La versione corretta di Xcode, CocoaPods o Swift Package Manager, Fastlane e un posto sicuro per i segreti della CI.

Come funziona

Come gli sviluppatori Windows e Linux rilasciano iOS con Capgo

Ti servono un'app Capacitor, un account Capgo e un account Apple Developer. Ogni comando qui sotto viene dalla documentazione Capgo CLI.

  1. Configura la firma iOS una volta sola

    L'onboarding legge il tuo progetto Capacitor, crea il certificato di distribuzione e il provisioning profile, e li salva sulla tua macchina.

    npx @capgo/cli@latest build init --platform ios
    Guida build iOS

  2. Oppure salva i file di signing che hai già

    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 credenziali

  3. Richiedi la build

    Sincronizza la tua web build nel progetto iOS, quindi richiedi la build. I log scorrono nel terminale e la build firmata viene caricata su App Store Connect per TestFlight.

    npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
    Guida alla prima build

  4. Esegui lo stesso comando in CI

    Esporta le credenziali salvate come segreti CI con build credentials manage, imposta CAPGO_TOKEN ed esegui build request 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
    Setup GitHub Actions

La soluzione

Cosa gestisce Capgo Build

I Native Build girano in cloud quando cambiano i code nativi. Le modifiche web continuano ad arrivare come Live Update tra un rilascio e l'altro.

Mac in cloud solo per la build

Le build iOS girano su Mac mini M4 dedicati con Xcode installato. Il tuo laptop Windows o Linux, o un runner CI, invia la richiesta dal terminale.

Panoramica Capgo Build

Firma iOS guidata

build init crea automaticamente il certificato di distribuzione e il provisioning profile. Utilizza una API key di App Store Connect, che puoi creare via browser se usi Windows o Linux.

Guida build iOS

Stesso comando in locale e in CI

Salva le credenziali una sola volta, poi avvia la richiesta di build da terminale, GitHub Actions, GitLab CI o qualsiasi altra pipeline.

Riferimento comandi build

Native Build e Live Update

Usa Capgo Build quando cambiano plugin, permessi, icone o la versione Capacitor. Distribuisci modifiche a JavaScript, CSS e asset come live updates dopo che gli utenti hanno installato la build dallo store.

Live update o Native Build?

Modello di fiducia

Usa hardware in cloud senza cedere code e chiavi

Le credenziali restano sulla tua macchina o nei secret della tua CI. Capgo le conserva solo durante il build.

Viene caricato solo il progetto nativo

CLI carica la cartella della piattaforma nativa e le dipendenze native. Il tuo repository completo resta sulla tua macchina.

I log arrivano in streaming nel tuo terminale

I log di build vengono trasmessi in tempo reale durante l'esecuzione e non vengono salvati sui server di Capgo.

Le credenziali esistono solo durante il build

Certificati e profili vengono usati in memoria durante il build e cancellati al termine. Ogni build viene eseguito in un ambiente isolato che viene distrutto subito dopo.

App buildate con Capacitor

Le app operative non dovrebbero dipendere da un singolo Mac locale

App per scuole, trasporti e supporto richiedono comunque release mobile firmate, anche se il team è composto principalmente da web, supporto o operations. I workflow di build ospitati eliminano il collo di bottiglia del singolo Mac, mantenendo i passaggi di firma ripetibili.

Icona dell'app IRIS ParentMail Istruzione

IRIS ParentMail

App per comunicazioni scolastiche dove i team non-native necessitano comunque di release firmate affidabili.

Installazioni Google Play
1,2M
Valutazione store
2.8
Icona dell'app KAI Access: Train Booking App VIAGGI E LOCALI

Accesso KAI: App per la prenotazione di treni

App di prenotazione trasporti in cui il rilascio non deve dipendere dalla macchina di un singolo sviluppatore.

Installazioni Google Play
13,5M
Valutazione store
3.6
Assistente Tecnico Virtuale – Supporto App Strumenti

Assistente Virtuale – Supporto Tecnico

Utility di supporto per team operations che necessitano di record ripetibili per i build mobile.

Installazioni Google Play
10,3M
Valutazione store
4.3

Cosa dicono i clienti

Cosa dicono i team che rilasciano con Capgo

5.0/5 valutato dai team di sviluppatori 9,400+ team Leggi le recensioni

sikafanka

Design, raggio 5

“Capgo Build ci ha aiutato a semplificare il processo di rilascio delle nostre app Capacitor. Possiamo buildare e rilasciare app iOS e Android con un unico workflow chiaro.”

Ritratto di Mikołaj Wilczek

Mikołaj Wilczek

Principal Mobile Platform Engineer presso Tellent

“Abbiamo scoperto Capgo inizialmente grazie ai suoi plugin, e si è rivelato un ottimo punto d'ingresso per un processo di rilascio molto più efficiente per il nostro team.”

FAQ

Domande sulla build iOS senza un Mac

I dubbi più comuni degli sviluppatori Windows e Linux prima della prima cloud iOS build.

Mi servirà un Mac in qualche momento?

Non per compilare, firmare o fare l'upload. Le build vengono eseguite sulle macchine Mac mini M4 di Capgo. Avrai comunque bisogno di un account Apple Developer. Su Windows o Linux, crei la API di App Store Connect dal browser, poi la CLI gestisce certificati e profili.

Guida build iOS

Quanto tempo richiede una build iOS?

Un tipico Native Build richiede 2–3 minuti. I log vengono trasmessi al terminale durante l'esecuzione, così puoi vedere gli errori in tempo reale.

Guida alla prima build

La build può andare direttamente su TestFlight?

Sì. Con una chiave API di App Store Connect nelle tue credenziali, la build firmata viene caricata su App Store Connect, dove puoi testarla in TestFlight e inviarla alla revisione dell'App Store. Aggiungi --output-upload se vuoi anche un link per scaricare l'IPA.

Configurazione build

Dove vengono salvati i miei certificati?

Sulla tua macchina, di default in ~/.capgo-credentials/credentials.json, oppure nei secret della tua CI. Vengono inviati a Capgo solo per la durata di una build e cancellati subito dopo.

Gestione credenziali

Serve una nuova build per ogni modifica?

No. Modifiche a plugin, permessi, icone o alla versione di Capacitor richiedono un nuovo Native Build. Le modifiche a JavaScript, HTML, CSS e asset possono essere distribuite come live update agli utenti che hanno già la build dello store.

Live update o Native Build?

Pubblica su iOS senza comprare un Mac

Esegui il tuo primo build iOS firmato durante la prova gratuita di 14 giorni, poi aggiungi Android, CI e Live Update quando ne avrai bisogno. Avvia il tuo primo build iOS firmato con una garanzia di rimborso di 14 giorni, poi aggiungi Android, CI e Live Update quando ne avrai bisogno.