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 build di iOS e inviare le applicazioni su TestFlight da una workstation di Windows.

Questa guida mostra un flusso di lavoro 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).
Attiva un build cloud per iOS con Capgo Build.

Cosa si Costruisce Effettivamente Dove

Ci sono due costruzioni separate in un'app Capacitor:

Costruzione Web (il tuo JS/HTML/CSS): lo fai localmente su Windows.
Costruzione Nativa (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 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 TestFlight/invio all'App Store).
Il tuo account Capgo e il tuo token API (CAPGO_TOKEN).

1) Crea o Prepara la tua App Capacitor (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

Il build 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

In questo punto avrai una

bunx cap init
bunx cap add ios

directory. Committala al git. __CAPGO_KEEP_0__ Build compila ciò che è all'interno ios/ directory. Commit it to git. Capgo Build compiles what is inside ios/Install __CAPGO_KEEP_0__:

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

Tutte le volte che modifichi il tuo'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 di iOS (i file Capgo Costruiranno effettivamente compilare).

4) Installa e autentica il Capgo CLI

Capgo Costruire è 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 di 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 di App Store Connect API (AuthKey_XXXXXX.p8Esegui le operazioni e i metadati (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 utilizzo), poi ripristinali da Windows per ogni successivo build.

Una volta che hai i file localmente, salvali per il 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) Avvia un build 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 il build 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 iconi/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.

Pitfall comuni di Windows (e soluzioni)

Dimenticare cap sync: se le tue modifiche UI mancano nella build iOS, è probabile che hai costruito l'app web ma non l'hai sincronizzata in ios/.
Non commettere ios/: Capgo Build compila il progetto nativo. Se il folder non è in git (o non è nel tuo contesto di build), la build non può riprodurre la tua app.
Modifiche dei plugin senza rebuild nativo: aggiungere un plugin è una modifica nativa; pianifica un run di Capgo Build (e una sottoscrizione del negozio) successivo.

Riepilogo

Non puoi eseguire Xcode su Windows, ma puoi invece invio 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 Capgo per il workflow del prodotto in Integrations Capgo Integrazione CI/CD per il dettaglio di implementazione in Integrazione CI/CD, e Integrazione GitHub Actions per il dettaglio di implementazione in Integrazione GitHub Actions.