Costruisci un'app iOS da Windows con Capacitor e Capgo Build

Costruire un'app iOS tradizionalmente significa una cosa sola: hai bisogno di Xcode, e Xcode significa macOS. Quel vincolo è fastidioso se il tuo team intero è su Windows o Linux, o se semplicemente non vuoi mantenere una macchina di build Mac.

La combinazione di Capacitor (per generare il progetto nativo iOS) e Capgo Costruzione (per compilarlo e firmarlo in cloud) ti consente di eseguire le costruzioni iOS e le sottoscrizioni di TestFlight da un workstation Windows.

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

• Sviluppa su Windows come un normale progetto web.
• Mantieni ios/ nel tuo repository (così lo stato nativo è riproducibile).
• Esegui cap sync localmente (così la tua costruzione web viene copiata nel progetto iOS).
• Attiva una costruzione cloud iOS con Capgo Costruzione.

Cosa si Costruisce Effettivamente Dove

Ci sono due costruzioni separate in un'app Capacitor:

• Costruzione web (il tuo JS/HTML/CSS): esegui questo localmente su Windows.
• Costruzione nativa (archiviazione di Xcode, firma, caricamento): Capgo Costruzione esegue questo su Mac hardware nel cloud.

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

Requisiti preliminari

• Un'app Capacitor funzionante (qualsiasi framework va bene).
• Un account di sviluppatore Apple.
• Accesso a App Store Connect per l'app che desideri caricare (per la sottoscrizione a TestFlight/App Store).
• I tuoi account e API token Capgo (CAPGO_TOKEN).

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

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

Esempio con Vite:

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

Deve produrre asset statici (per Vite questo è dist/ 2) Aggiungi __CAPGO_KEEP_0__ e la piattaforma iOS

bun run build

Installa Capacitor:

Install Capacitor:

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

Al momento avrai un

bunx cap init
bunx cap add ios

directory. Committalo a git. __CAPGO_KEEP_0__ Build compila ciò che è all'interno ios/ directory. Commit it to git. Capgo Build compiles what is inside ios/3) Sincronizza sempre gli asset web nella piattaforma iOS prima di costruire

Ogni volta che modifichi il tuo'app web, esegui questa sequenza su Windows:

è ciò che copia i tuoi asset web costruiti nella progetto iOS nativo (i file __CAPGO_KEEP_0__ Build effettivamente compila).

bun run build
bunx cap sync ios

cap sync 4) Installa e autentica il Capgo __CAPGO_KEEP_1__

4) Installa e autentica il Capgo CLI

Costruisce Capgo 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 Cloud

Per costruire iOS hai bisogno di materiale di firma:

• Certificato di distribuzione Apple (.p12) e la sua password
• Profilo di provisioning (.mobileprovision)
• App Store Connect API key (AuthKey_XXXXXX.p8Chiave di accesso App Store Connect (

If you still need to generate these files, follow the Capgo documentation:

• Se ancora hai bisogno di generare questi file, segui la __CAPGO_KEEP_0__ documentazione: Gestione delle credenziali (cosa salvare e come)
• How to Get iOS Certificates and Provisioning Profiles

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

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 dei credenziali base64-codificati come segreti, decodificali in esecuzione, quindi esegui lo stesso comando. build credentials save 6) Trascina un Build iOS da Windows

Dal tuo cartella dell'app:

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

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.

__CAPGO_KEEP_0__ Build è per le modifiche native:

aggiungere/rimuovere Capgo plugin

• adding/removing Capacitor plugins
• modificare le autorizzazioni native
• cambiare icone/splash
• aggiornare Capacitor
• qualsiasi cambiamenti in Swift/Objective-C

Per le correzioni quotidiane di UI e le modifiche JavaScript, in generale desideri Aggiornamenti in tempo reale (OTA), quindi non ricostruisci il binario nativo ogni volta.

Un buon workflow di squadra è:

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

Comuni insidie di Windows (e soluzioni)

• Dimenticare cap sync: se le tue modifiche di UI mancano nella build iOS, è probabile che hai costruito l'app web ma non l'hai sincronizzata ios/.
• Not committing ios/: Capgo Costruisce il progetto nativo. Se il folder non è in git (o non è nel tuo contesto di build), la build non può riprodurre la tua app.
• Plugin changes without native rebuild: l'aggiunta di un plugin è un cambiamento nativo; pianifica un Capgo Build run (e una presentazione al store) successivo.

Summary

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

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

Continua a lavorare da Build un'app iOS da Windows con Capacitor e Capgo Build

Se stai utilizzando Build 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 Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrazioni, Integrazione CI/CD per i dettagli di implementazione in Integrazione CI/CD, e GitHub Azioni di integrazione per i dettagli di implementazione in GitHub Azioni di integrazione.