Costruire un'app iOS da Windows con Capacitor e Capgo Costruzione

Costruire un'app per iOS tradizionalmente significa una cosa sola: hai bisogno di Xcode, e Xcode significa macOS. Quella restrizione è fastidiosa se tutto il tuo team è su Windows o Linux, o se non vuoi mantenere una macchina di build Mac.

La combinazione di Capacitor (per generare il progetto nativo di iOS) e Capgo Build (per compilare e firmarlo in cloud) ti consente di eseguire costruzioni di iOS e inviare le applicazioni su TestFlight da una workstation di Windows.

Questa guida mostra un workflow pragmatico che funziona bene in team:

Sviluppa su Windows come un normale progetto web.
Tieni ios/ in repository (così lo stato nativo è riproducibile).
Esegui cap sync localmente (così il tuo build web viene copiato nel progetto di iOS).
Avvia un build cloud per iOS con Capgo Build.

Cosa si costruisce effettivamente dove

C'è una separazione tra due “builds” in un'app Capacitor:

Build web (il tuo JS/HTML/CSS): lo fai localmente su Windows.
Build nativo (archiviazione di Xcode, firma, caricamento): Capgo Build lo fa su Mac hardware in cloud.

Questa separazione è la chiave: Capgo Build compila il progetto nativo, ma si aspetta che i tuoi asset web siano già sincronizzati in ios/.

Requisiti

Un'app Capacitor funzionante (qualsiasi framework va bene).
Un account di sviluppatore Apple.
Accesso a App Store Connect per l'app che vuoi caricare (per TestFlight/App Store submission).
La tua Capgo account e il tuo API token (CAPGO_TOKEN).

1) Crea o Prepara la tua Capacitor App (Windows)

Se già hai un'app web, saltare ai passaggi Capacitor.

Esempio con Vite:

bun create vite@latest my-app
cd my-app
bun install

Build deve produrre asset statici (per Vite questo è dist/ di default):

bun run build

2) Aggiungi Capacitor e la piattaforma iOS

Installa Capacitor:

bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cli

Inizializza e crea la cartella della piattaforma iOS:

bunx cap init
bunx cap add ios

Al momento avrai un ios/ directory. Committalo a git. Capgo Build compila ciò che è all'interno ios/, quindi desideri che sia versionato e riproducibile.

3) Sincronizza sempre gli asset web in iOS prima di costruire

Tutte le volte che modifichi la tua app web, esegui questa sequenza su Windows:

bun run build
bunx cap sync ios

cap sync è ciò che copia gli asset web costruiti nel progetto nativo iOS (i file Capgo Build saranno effettivamente compilati).

4) Installa e autenticati il Capgo CLI

Capgo Build viene attivato tramite il Capgo CLI. Con bun, utilizza bunx:

bunx @capgo/cli@latest login

O impostare il tuo token tramite variabile di ambiente nel tuo shell/CI:

export CAPGO_TOKEN="your_api_key_here"

5) Configura la firma iOS per le costruzioni in cloud

Per costruire iOS hai bisogno di materiale di firma:

certificato di distribuzione Apple (.p12) e la sua password
profilo di provisioning (.mobileprovision)
chiave App Store Connect API (AuthKey_XXXXXX.p8Esegui le operazioni di configurazione e la metadata (ID chiave, ID emittente, ID team)

Se hai ancora bisogno di generare questi file, consulta la documentazione di Capgo:

Gestione delle credenziali (cosa salvare e come)
Come ottenere i certificati e i profili di provisioning iOS

La via più facile è: crea/esporta questi file una volta (spesso utilizzando qualsiasi Mac disponibile, un team-mate o un noleggio a tempo di unico), poi ripristinali da Windows per ogni successiva compilazione.

Una volta che hai i file localmente, salvali per Capgo Build:

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./cert.p12 \
  --p12-password "password" \
  --provisioning-profile ./profile.mobileprovision \
  --apple-key ./AuthKey.p8 \
  --apple-key-id "KEY123" \
  --apple-issuer-id "issuer-uuid" \
  --apple-team-id "team-id"

Suggerimento: in CI, memorizza i file delle credenziali in formato base64 come segreti, decodificali in esecuzione, poi esegui lo stesso comando. build credentials save 6) Trasmetti una compilazione iOS da Windows

Dal tuo cartellone dell'applicazione:

Vedrai i log in tempo reale nel tuo terminale. Se il tuo chiave App Store Connect è configurata, __CAPGO_KEEP_0__ Build può inviare la compilazione risultante a TestFlight automaticamente.

bun run build
bunx cap sync ios
bunx @capgo/cli@latest build com.example.app --platform ios --build-mode release

You will see real-time logs in your terminal. If your App Store Connect key is configured, Capgo Build can submit the resulting build to TestFlight automatically.

7) Itera velocemente: Aggiornamenti in tempo reale per le modifiche esclusivamente web

Capgo La costruzione è per le modifiche native:

aggiungere/rimuovere Capacitor plugin
modificare le autorizzazioni native
modificare gli icona/splash
aggiornare Capacitor
qualsiasi cambiamento Swift/Objective-C

Per le correzioni di routine della UI e i fix JavaScript, desideri generalmente Aggiornamenti in tempo reale (OTA), quindi non ricostruisci il binario nativo ogni volta.

Un buon workflow di squadra è:

Usa gli Aggiornamenti in tempo reale per le modifiche web frequenti.
Usa Capgo Build occasionalmente quando sono necessarie modifiche native.

Difficoltà comuni su Windows (e soluzioni)

Dimenticare cap sync: se le tue modifiche UI mancano nel build iOS, è probabile che tu abbia costruito l'app web ma non l'abbia sincronizzata in ios/.
Non commettere ios/: Capgo Build compila il progetto nativo. Se la cartella non è in Git (o non è nel contesto di costruzione), il build non può riprodurre l'app.
Modifiche dei plugin senza rebuild nativo: aggiungere un plugin è una modifica nativa; pianifica un run Capgo Build (e una presentazione al store) successivo.

Riepilogo

Non puoi eseguire Xcode su Windows, ma puoi inviare app iOS da Windows:

Avvolgi la tua app web con Capacitor (ios/ nel tuo repository).
Costruisci gli asset web localmente, poi cap sync.
Usa Capgo Build per compilare, firmare e inviare il tuo binario iOS dal CLI.

Continua con l'aggiunta di un'app iOS da Windows con Capacitor e Capgo Build

Se stai utilizzando Costruisci un'app iOS da Windows con Capacitor e Capgo Build per pianificare l'automazione CI/CD, connettilo con Capgo CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD, Capgo Build Native per il flusso di lavoro del prodotto in Capgo Build Native, Integrations di Capgo per il flusso di lavoro del prodotto in Integrations di Capgo Integrazione CI/CD per il dettaglio di implementazione in Integrazione CI/CD Integrazione di azioni di GitHub per il dettaglio di implementazione in Integrazione di azioni di GitHub