Construire une application iOS à partir de Windows avec Capacitor et Capgo Construction

Construire une application iOS de manière traditionnelle signifie une chose : vous avez besoin de Xcode, et Xcode signifie macOS. Cette contrainte est gênante si tout votre équipe est sur Windows ou Linux, ou si vous ne voulez simplement pas maintenir une machine de build Mac.

Le combo de Capacitor (pour générer le projet natif iOS) et Capgo Build (pour le compiler et le signer dans le cloud) vous permet de faire des builds iOS et des soumissions sur TestFlight à partir d'une station de travail Windows.

Cette guide montre un workflow pragmatique qui fonctionne bien en équipe :

Développez sur Windows comme un projet web normal.
Conservez ios/ dans votre référentiel (pour que l'état natif soit réproducible).
Exécuter cap sync localement (pour que votre build web soit copié dans le projet iOS).
Déclencher une build iOS dans le cloud avec Capgo Build.

Ce que vous construisez vraiment où

Il existe deux builds séparées dans une application Capacitor :

Build web (vos JS/HTML/CSS) : vous le faites localement sur Windows.
Build natif (archive Xcode, signature, téléchargement) : Capgo Build le fait sur du matériel Mac dans le cloud.

Cette séparation est la clé : Capgo Build compile le projet natif, mais il attend que vos actifs web soient déjà synchronisés dans ios/.

Prérequis

Une application fonctionnelle Capacitor (n'importe quel framework est acceptable).
Un compte développeur Apple.
Accès à App Store Connect pour l'application que vous souhaitez télécharger (pour la soumission à TestFlight/App Store).
Votre compte Capgo et votre jeton API (CAPGO_TOKEN).

1) Créez ou préparez votre application Capacitor (Windows)

Si vous avez déjà une application web, sautez aux étapes Capacitor.

Exemple avec Vite :

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

La construction doit produire des actifs statiques (pour Vite, c'est par défaut) : dist/ 2) Ajoutez __CAPGO_KEEP_0__ et la plateforme iOS

bun run build

Installez Capacitor :

Install Capacitor:

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

Installez __CAPGO_KEEP_0__ :

bunx cap init
bunx cap add ios

À ce stade, vous devriez avoir un ios/ répertoire. Commitez-le dans Git. Capgo Construire compile ce qui est à l'intérieur ios/donc vous voulez que cela soit versionné et réplicable.

3) Synchronisez toujours les Web Assets dans iOS avant de construire

Chaque fois que vous modifiez votre application web, effectuez cette séquence sur Windows :

bun run build
bunx cap sync ios

cap sync c'est ce qui copie vos actifs web construits dans le projet natif iOS (les fichiers Capgo Construire seront effectivement compilés).

4) Installez et authentifiez les Capgo CLI

Capgo Construire est déclenché via le Capgo CLI. Avec bun, utilisez bunx:

bunx @capgo/cli@latest login

Ou définissez votre jeton via une variable d'environnement dans votre shell/CI :

export CAPGO_TOKEN="your_api_key_here"

5) Configurez la signature iOS pour les builds Cloud

Pour construire iOS, vous avez besoin de matériel de signature :

Certificat de distribution Apple (.p12et son mot de passe
Profil de provisionnement (.mobileprovision)
Clé d'App Store Connect API (AuthKey_XXXXXX.p8et les métadonnées (ID de clé, ID émetteur, ID d'équipe)

Si vous avez toujours besoin de générer ces fichiers, suivez la Capgo documentation :

Gestion des Identifiants (ce qu'il faut sauvegarder et comment)
Comment obtenir les certificats iOS et les profils de provisionnement

La voie la plus facile est : créer/exporter ces éléments une fois (souvent en utilisant n'importe quel Mac disponible, un collègue ou un location à usage unique), puis les réutiliser depuis Windows pour chaque build ultérieur.

Une fois que vous avez les fichiers localement, enregistrez-les pour 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"

Conseil : en CI, stockez les fichiers de credenciaux encodés en base64 en tant que secrets, décodez-les en temps de exécution, puis exécutez la même commande. build credentials save Tip: in CI, store the credential files base64-encoded as secrets, decode them at runtime, then run the same

6) Déclencher une mise à jour iOS à partir de Windows

À partir de votre dossier d'application :

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

Vous verrez des journaux en temps réel dans votre terminal. Si votre clé App Store Connect est configurée, Capgo Build peut soumettre la mise à jour résultante à TestFlight automatiquement.

7) Itérer rapidement : Mises à jour en direct pour les modifications uniquement web

Capgo Build est pour les modifications natives :

ajouter/supprimer des plugins Capacitor
changer les permissions natives
changer les icônes/splash
mettre à jour Capacitor
toute modification Swift/Objective-C

Pour les ajustements de UI quotidiens et les corrections JavaScript, vous voulez généralement Mises à jour en direct Pour (OTA), vous n'avez pas à reconstruire le code natif à chaque fois.

Un bon flux de travail d'équipe est :

Utilisez les Mises à jour en temps réel pour les modifications fréquentes du site web.
Utilisez Capgo Build occasionnellement lorsque des changements natifs sont nécessaires.

Problèmes courants de Windows (et corrections)

Oublier : cap syncsi vos modifications de l'interface utilisateur manquent dans la build iOS, il est probable que vous avez construit l'application web mais n'avez pas synchronisé son contenu dans ios/.
Ne pas commiter : ios/Capgo Build compile le projet natif. Si le dossier n'est pas dans Git (ou pas dans votre contexte de build), la build ne peut pas reproduire votre application.
Changements de plugin sans reconstruction native :ajouter un plugin est un changement natif ; planifiez une exécution de Capgo Build (et une soumission de magasin) par la suite.

Résumé

Vous ne pouvez pas exécuter Xcode sur Windows, mais vous pouvez envoyer des applications iOS à partir de Windows : Enveloppez votre application web avec __CAPGO_KEEP_0__ (

Wrap your web app with Capacitor (ios/ Construirez les actifs web localement, puis
Utilisez __CAPGO_KEEP_0__ Build pour compiler, signer et soumettre votre fichier binaire iOS à partir du __CAPGO_KEEP_1__. cap sync.
Use Capgo Build to compile, sign, and submit your iOS binary from the CLI.

Créez une application iOS à partir de Windows avec Capacitor et Capgo Créez