Do I need a Mac at any point?

Not to compile, sign, or upload. Builds run on Capgo's Mac mini M4 machines. You still need an Apple Developer account. On Windows or Linux, you create the App Store Connect API key in your browser, then the CLI handles certificates and profiles.

How long does an iOS build take?

A typical native build takes 2–3 minutes. Logs stream to your terminal while it runs, so you see errors as they happen.

Can the build go straight to TestFlight?

Yes. With an App Store Connect API key in your credentials, the signed build uploads to App Store Connect, where you test it in TestFlight and submit it for App Store review. Add --output-upload if you also want a download link for the IPA.

Where are my certificates stored?

On your machine, in ~/.capgo-credentials/credentials.json by default, or in your CI secrets. They are sent to Capgo only for the duration of a build and deleted afterwards.

Do I need a new build for every change?

No. Plugin, permission, icon, and Capacitor version changes need a new native build. JavaScript, HTML, CSS, and asset changes can ship as live updates to users who already have the store build.

Pour les développeurs Windows et Linux

Compilez des apps iOS sans posséder de Mac

Capgo Le build compile et signe votre app iOS Capacitor sur des machines Mac dans le cloud. Exécutez une commande CLI depuis Windows, Linux ou votre CI, et le build signé est envoyé sur App Store Connect pour TestFlight.

2–3 min

build natif classique

iOS + Android

depuis le même CLI

TestFlight

upload direct vers 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

Machines Mac dans le cloud

Les builds iOS s'exécutent sur des Mac mini M4 dédiés. Lancez-les depuis l'ordinateur que vous utilisez déjà.

Signé et envoyé

Le build est signé avec votre certificat et envoyé sur App Store Connect, prêt pour TestFlight.

Le problème

Xcode ne fonctionne que sur macOS

Pas de Mac, pas de build iOS

Les outils de build d'Apple nécessitent macOS. Un développeur sur Windows ou Linux ne peut pas compiler ou signer un build iOS sur sa propre machine.

La signature dépend d'un seul laptop

Les certificats et profils sont souvent sur le Mac d'une seule personne. Si cette personne est absente ou si un profil expire, la release est bloquée.

La CI macOS auto-hébergée est un vrai projet

Un runner macOS loué nécessite toujours des mises à jour Xcode, des lanes Fastlane, des secrets de signature et du débogage dès qu'Apple change quelque chose.

Le travail invisible

Ce qu'un build de release nécessite en plus d'un Mac

Acheter un Mac ne règle que la partie matérielle. Il vous faut encore configurer le compte Apple, gérer les fichiers de signature et maintenir des outils de build.

Configuration du compte Apple

Un compte Apple Developer avec des droits d'admin, un bundle ID, une fiche d'app App Store Connect et une clé API pour les uploads.

Fichiers de signature et profils

Un certificat de distribution exporté au format .p12, un profil de provisionnement pour chaque bundle ID et leur renouvellement à l'expiration.

Outils de build

La bonne version de Xcode, CocoaPods ou Swift Package Manager, Fastlane, et un endroit où stocker les secrets de CI.

Comment ça marche

Comment les développeurs Windows et Linux déploient sur iOS avec Capgo

Vous avez besoin d'une app Capacitor, d'un compte Capgo et d'un compte Apple Developer. Chaque commande ci-dessous provient de la documentation Capgo CLI.

Configurer la signature iOS une seule fois

L'onboarding lit votre projet Capacitor, crée le certificat de distribution et le profil de provisionnement, puis les enregistre sur votre machine.
```
npx @capgo/cli@latest build init --platform ios
```
Guide de build iOS

Ou sauvegardez vos fichiers de signature existants

Si votre équipe possède déjà un certificat et un profil, sauvegardez-les avec votre clé API App Store Connect. Ils resteront dans un fichier d'identifiants local.

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

Gérer les identifiants

Lancez le build

Synchronisez votre build web dans le projet iOS, puis lancez le build. Les logs s'affichent dans votre terminal, et le build signé est envoyé sur App Store Connect pour TestFlight.
```
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
```
Guide du premier build
Exécutez la même commande en CI

Exportez vos identifiants sauvegardés en tant que secrets CI avec build credentials manage, configurez CAPGO_TOKEN, et lancez la demande de build via GitHub Actions, GitLab CI ou n'importe quel runner.
```
npx @capgo/cli@latest build credentials manage
# in your CI job
npx @capgo/cli@latest build request com.example.app --platform ios
```
Configuration GitHub Actions

La solution

Ce que Capgo gère pour vous

Les builds natifs s'exécutent dans le cloud lors de changements code natifs. Les changements web continuent d'être déployés via des live updates entre deux releases sur les stores.

Des Mac dans le cloud uniquement pour vos builds

Les builds iOS s'exécutent sur des Mac mini M4 dédiés avec Xcode installé. Votre ordinateur Windows ou Linux, ou un runner CI, envoie la requête depuis le terminal.

Aperçu de Capgo Build

Signature iOS guidée

build init crée le certificat de distribution et le profil de provisionnement pour vous. Il utilise une clé API App Store Connect, que vous créez via votre navigateur sous Windows ou Linux.

Guide de build iOS

Même commande en local et en CI

Enregistrez vos identifiants une seule fois, puis lancez une requête de build depuis un terminal, GitHub Actions, GitLab CI ou n'importe quel autre pipeline.

Référence de la commande build

Builds natifs et live updates

Utilisez Capgo Build lorsque les plugins, permissions, icônes ou la version Capacitor changent. Déployez les modifications de JavaScript, CSS et assets via des live updates après l'installation du build du store par les utilisateurs.

Live update ou build natif ?

Modèle de confiance

Utilisez du matériel cloud sans céder votre code et vos clés

Les identifiants restent sur votre machine ou dans vos secrets CI. Capgo ne les conserve que pendant l'exécution d'un build.

Seul le projet natif est envoyé

CLI effectue l'upload du dossier de la plateforme native et des dépendances natives. Votre dépôt complet reste sur votre machine.

Les logs sont diffusés dans votre terminal

Les logs de build sont diffusés en direct pendant l'exécution et ne sont pas stockés sur les serveurs de Capgo.

Les identifiants n'existent que durant le build

Les certificats et profils sont utilisés en mémoire pendant le build et supprimés une fois celui-ci terminé. Chaque build s'exécute dans un environnement isolé qui est détruit par la suite.

Apps développées avec Capacitor

Les apps critiques ne devraient pas dépendre d'un seul Mac local

Les apps d'éducation, de transport ou de support ont toujours besoin de releases mobiles signées, même quand l'équipe est principalement web ou ops. Les workflows de build hébergés éliminent le goulot d'étranglement d'une machine unique tout en rendant les étapes de signature reproductibles.

Éducation

IRIS ParentMail

Application de communication scolaire où les équipes sans Mac ont besoin de releases signées fiables.

Installations Google Play: 1,2 M; Installations Google Play
Note du store: 2.8; Note du store

VOYAGES ET LOCAL

KAI Access : application de réservation de trains

Une application de réservation de transports où le transfert de release ne doit pas dépendre du poste d'un seul développeur.

Installations Google Play: 13,5 M; Installations Google Play
Note du store: 3.6; Note du store

Outils

Technicien virtuel – Support technique

Outil de support pour les équipes opérationnelles ayant besoin de registres de build mobile reproductibles.

Installations Google Play: 10,3 M; Installations Google Play
Note du store: 4.3; Note du store

Témoignages clients

Ce que disent les équipes qui déploient avec Capgo

5.0/5 noté par les équipes de développeurs 9,400+ équipes Lire les avis

sikafanka

Design, rayon 5

“Capgo Build nous a aidés à simplifier notre processus de release de l’app Capacitor. Nous pouvons compiler et déployer des apps iOS et Android depuis un workflow unique et clair.”

Mikołaj Wilczek

Ingénieur principal des plateformes mobiles, Tellent

« Nous avons découvert Capgo au départ grâce à ses plugins, et cela s'est révélé une excellente porte d'entrée vers un processus de release bien plus efficace pour notre équipe. »

FAQ

Questions sur le build iOS sans Mac

Ce que les développeurs Windows et Linux demandent avant leur premier build cloud iOS.

Ai-je besoin d'un Mac à un moment donné ?

Pas pour compiler, signer ou envoyer. Les builds s'exécutent sur les Mac mini M4 de Capgo. Il vous faut quand même un compte Apple Developer. Sur Windows ou Linux, vous créez la clé API App Store Connect dans votre navigateur, puis le CLI gère les certificats et les profils.

Guide de build iOS

Combien de temps prend un build iOS ?

Un build natif classique prend 2 à 3 minutes. Les logs s'affichent en continu dans votre terminal pendant l'exécution pour voir les erreurs en temps réel.

Guide du premier build

Le build peut-il être envoyé directement sur TestFlight ?

Oui. Avec une clé API App Store Connect dans vos credentials, le build signé est envoyé sur App Store Connect, où vous pouvez le tester via TestFlight et le soumettre pour examen sur l'App Store. Ajoutez --output-upload si vous souhaitez également obtenir un lien de téléchargement pour l'IPA.

Configuration du build

Où sont stockés mes certificats ?

Par défaut, sur votre machine dans ~/.capgo-credentials/credentials.json, ou dans les secrets de votre CI. Ils ne sont envoyés à Capgo que pour la durée du build, puis supprimés.

Gestion des credentials

Ai-je besoin d'un nouveau build pour chaque modification ?

Non. Les changements de plugin, de permission, d'icône ou de version Capacitor nécessitent un nouveau build natif. Les modifications JavaScript, HTML, CSS et les assets peuvent être déployées via des live updates auprès des utilisateurs possédant déjà la version du store.