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.

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

Construire des applications iOS sans posséder un Mac

Capgo Build compile et signe votre Capacitor application iOS sur des machines Mac en nuage. Exécutez une seule commande CLI à partir de Windows, Linux ou CI, et la build signée est téléchargée sur App Store Connect pour TestFlight.

2–3 min

construction native native

iOS + Android

à partir du même CLI

TestFlight

téléchargement direct vers App Store Connect

Capgo Build

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 Cloud

Les builds iOS fonctionnent sur des Mac mini M4 dédiés. Vous les démarrez depuis l'ordinateur que vous utilisez déjà.

Signé et téléchargé

Le build est signé avec votre certificat et téléchargé 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 une build iOS sur son propre ordinateur.

La signature vit sur un seul ordinateur portable

Les certificats et les profils sont souvent stockés sur un Mac. Lorsque la personne concernée est absente ou que le profil expire, la mise à jour attend.

Un CI macOS auto-hébergé est son propre projet

Un exécuteur macOS loué nécessite encore des mises à jour Xcode, des voies Fastlane, des secrets de signature et des débogages lorsqu'Apple change quelque chose.

Le travail caché

Quelle chose un build de release nécessite en plus d'un Mac

Acheter un Mac ne résout que la partie matérielle. Vous aurez toujours besoin de configurer un compte Apple, de signer des fichiers et d'outils de construction qui continuent à évoluer.

Configuration de compte Apple

Un compte développeur Apple avec des droits administrateurs, un ID de bundle, un enregistrement d'application App Store Connect et une clé API pour les téléchargements.

Signez des fichiers et des profils

Une distribution certificat exporté sous forme de .p12, un profil de provisionnement pour chaque ID de bundle, et des renouvellements lorsqu'ils expirent.

Outils de construction

La bonne version d'Xcode, CocoaPods ou Swift Package Manager, Fastlane, et un endroit pour conserver des secrets pour la CI.

Comment ça marche

Comment les développeurs Windows et Linux expédient l'iOS avec Capgo

Vous avez besoin d'une application Capacitor, d'un compte Capgo, et d'un compte développeur Apple. Chaque commande ci-dessous provient des documents Capgo CLI.

Configurer la signature iOS une fois

Capgo lit votre projet Capacitor, crée le certificat de distribution et le profil de provisioning, puis les sauvegarde sur votre machine.
```
npx @capgo/cli@latest build init --platform ios
```
Guide de construction iOS

Sauvegardez les fichiers de signature que vous avez déjà.

Si votre équipe a déjà un certificat et un profil, sauvez-les avec votre clé API App Store Connect. Ils restent dans un fichier de crédentiels 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

Gestion des identifiants

Demander la construction

Pour synchroniser votre build web dans le projet iOS, demandez ensuite la construction. Les journaux s'affichent dans votre terminal, et le build signé est envoyé à App Store Connect pour TestFlight.
```
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
```
Guide de construction initial
Exécuter la même commande dans CI

Exporter vos identifiants sauvegardés en tant que secrets CI avec la gestion des identifiants de construction, définir CAPGO_TOKEN, et exécuter la demande de construction dans GitHub Actions, CI GitLab, ou tout runner.
```
npx @capgo/cli@latest build credentials manage
# in your CI job
npx @capgo/cli@latest build request com.example.app --platform ios
```
Configuration d'Actions GitHub

La Solution

Quoi que Capgo Build gère pour vous

Native builds run in the cloud when native code changes. Web changes keep shipping as live updates between store releases.

Cloud Macs only when you build

iOS builds run on dedicated Mac mini M4 machines with Xcode installed. Your Windows or Linux laptop, or a CI runner, sends the request from the terminal.

Capgo Aperçu de la construction

Signature de l'iOS guidée

build init creates the distribution certificate and provisioning profile for you. It uses an App Store Connect API key, which you create in your browser when you are on Windows or Linux.

Guide de construction iOS

La même commande localement et en CI

Enregistrez vos informations d'identification une fois, puis exécutez la demande de build à partir d'un terminal, GitHub Actions, GitLab CI ou tout autre pipeline.

Référence de la commande de construction

Constructions natives plus mises à jour en temps réel

Use Capgo Build when plugins, permissions, icons, or the Capacitor version change. Ship JavaScript, CSS, and asset changes as live updates after users install the store build.

Live update ou construction native ?

Modèle de confiance

Utilisez le matériel cloud sans remettre vos code et vos clés

Credentials stay on your machine or in your CI secrets. Capgo only holds them while a build runs.

Seule la projet native est téléchargé

CLI télécharge le dossier de la plateforme native et les dépendances natives. Votre répertoire complet reste sur votre machine.

Logs s'écoulent dans votre terminal

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

Les identifiants existent uniquement pendant l'exécution

Les certificats et les profils sont utilisés en mémoire pendant l'exécution et supprimés lorsque cela est terminé. Chaque build s'exécute dans un environnement isolé qui est détruit ensuite.

Des applications construites avec Capacitor

Applications opérationnels ne devraient pas attendre sur un Mac local.

Les applications scolaires, de transport et de support nécessitent toujours des versions mobiles signées lorsque l'équipe est principalement web, support ou opérations. Les workflows de build hébergés suppriment le bouchon de la machine unique tout en gardant les étapes de signature répétitives.

Éducation

IRIS ParentMail

Application de communication scolaire où les équipes non natives ont besoin de versions signées fiables.

Installs sur Google Play: 1,2M; Installs sur Google Play
Note de notation de magasin: 2.8; Note de notation de magasin

TRAVEL AND LOCAL

KAI Access : Réservation de train

Application de réservation de transport où la livraison de la version ne doit pas dépendre d'une seule machine de développeur.

Installs sur Google Play: 13,5M; Installs sur Google Play
Note de notation de magasin: 3.6; Évaluation de l'application

Outils

Suporte Technique Virtuel

Support technique où les équipes d'opérations ont besoin de dossiers de construction mobiles répétables.

Installs Google Play: 10,3M; Installs Google Play
Évaluation de l'application: 4.3; Évaluation de l'application

Prochaine voie de mise à jour

Utilisez les mêmes contrôles de version pour votre application.

Créez un canal de déploiement contrôlé, publiez une mise à jour web limitée et préparez-vous à annuler dès la première version.

Signature répétable iOS et Android
Transmission de mise en production sans matériel local
Enregistrements de construction gérés par CI

Preuves de clients

Ce que les équipes qui utilisent Capgo disent

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

sikafanka

Conception, rayon 5

«Capgo Build nous a aidés à simplifier notre processus de lancement de l'application Capacitor. Nous pouvons construire et envoyer des applications iOS et Android à partir d'un flux de travail clair et cohérent. »

Mikołaj Wilczek

Ingénieur principal de la plateforme mobile, Tellent

« Nous avons découvert Capgo à travers ses plugins, et cela s'est avéré être un excellent point d'entrée dans un processus de lancement plus efficace pour notre équipe. »

FAQ

Questions relatives à la construction d'iOS sans Mac

Quels développeurs Windows et Linux demandent avant leur première build cloud iOS.

Faut-il avoir un Mac à un moment donné ?

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.

Guide de build iOS

Combien de temps prend une build iOS ?

Une build native typique prend 2 à 3 minutes. Les journaux s'affichent dans votre terminal pendant qu'elle s'exécute, vous voyez donc les erreurs comme elles se produisent.

Premier guide de build

La build peut-elle aller directement à 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.

Configuration de build

Où sont mes certificats stockés ?

Sur votre machine, dans ~/.capgo-credentials/credentials.json par défaut, ou dans vos secrets CI. Ils sont envoyés à Capgo uniquement pour la durée d'une build et supprimés ensuite.