Prise en main

Commencez avec Capgo Cloud Build et créez votre premier build natif iOS ou Android en quelques minutes.

Ce dont vous avez besoin

Avant de commencer, assurez-vous d'avoir :

• Une application Capacitor qui compile correctement en local
• Node.js 20 ou version supérieure installé
• Un compte Capgo (un essai gratuit suffit pour commencer)
• Votre app déjà enregistrée dans Capgo (exécutez npx @capgo/cli@latest app add sinon)
• (Pas besoin de préparer les identifiants de signature à l’avance — nous les configurerons à l’étape suivante.)

Configurer vos identifiants de signature

Capgo a besoin d’identifiants de signature pour compiler et soumettre votre application — mais pas besoin de les gérer manuellement. Répondez à quelques questions et nous vous indiquerons la commande exacte à exécuter :

Lancer votre premier build

Vous devez être authentifié auprès de Capgo pour compiler. Si ce n’est pas encore le cas :

npx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

Si vous venez d’exécuter build init, vous êtes déjà prêt — l'onboarding propose de lancer un build pour vous à la fin, votre premier build est donc peut-être déjà en cours. 🎉

Sinon, lancez votre propre build avec build request — configurez --platform selon ce que vous compilez :

npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

CLI effectue l'upload du projet natif préparé et diffuse les logs de build en direct dans votre terminal. Capgo Build peut renvoyer un artefact signé ou le soumettre à App Store Connect ou Google Play lorsque vous configurez le workflow de release adapté.

Comprendre le processus de build

Lorsque vous lancez la commande de build, voici ce qui se passe :

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Préparer dans votre CI - Compiler la couche web, résoudre les dépendances privées et synchroniser les assets compilés dans le projet natif.
2. Envoyer - Le projet natif préparé est envoyé vers un stockage cloud sécurisé pour le build.
3. Exécution du build - Capgo compile et signe le projet natif sur une infrastructure dédiée.
4. Flux de logs - Les logs en temps réel sont diffusés vers votre terminal via Server-Sent Events.
5. Nettoyage - L’environnement de build et les données de projet temporaires sont nettoyés après le build ; la rétention des artefacts dépend des options de livraison sur les stores sélectionnées.

Utiliser Capgo Build avec Bitrise ou un autre CI

Capgo Build ne remplace pas votre CI existant. Conservez les étapes qui nécessitent un accès privé dans Bitrise ou un autre système de CI : installation depuis des registres privés, résolution de CocoaPods privés via SSH, exécution de la configuration native personnalisée, build de la couche web et exécution de npx cap sync.

Ensuite, appelez Capgo Build avec le projet natif préparé. Capgo reçoit le ios/ ou android/ un projet à compiler et signer, il n’a donc pas besoin de vos identifiants Nexus privés, SSH CocoaPods ou de build web. Les assets web compilés se trouvent déjà dans ce projet natif préparé ; ils servent au build plutôt que d’être conservés comme dépôt source.

Ce qui est compilé

Capgo Build reçoit le projet natif préparé nécessaire pour compiler votre application. Votre source web code, l’installation de vos dépendances privées et la synchronisation Capacitor restent dans votre CI.

Ce qui est uploadé

Inclus	Description
ios/ ou android/	Le dossier de la plateforme native que vous compilez
package.json, package-lock.json	Manifeste des dépendances
capacitor.config.*	Configuration Capacitor
resources/	Icônes d’application, écrans de démarrage
Plugin natif code	Seul le ios/ ou android/ sous-dossier de chaque plugin Capacitor

Ce qui n’est pas envoyé

Exclus	Pourquoi
node_modules/ (la plupart)	Seuls les plugins natifs code sont inclus, pas les dépendances JS
src/	Votre source web code reste locale
dist/, www/, build/ (niveau racine)	Déjà synchronisé dans le dossier natif via cap sync
.git/	Historique du contrôle de version
.gradle/, .idea/, .swiftpm/	Caches de build et configurations IDE
.env, secrets	Jamais uploadés

Remarque

Vos assets web compilés (JS, CSS et HTML) sont uploadés uniquement parce que npx cap sync les a copiés dans le projet natif. Les étapes de source web et d’installation des dépendances restent dans votre CI ; le projet natif préparé est utilisé pour compiler le binaire, puis nettoyé.

Vos responsabilités

Avant l'exécution npx @capgo/cli@latest build request:

1. Préparer dans votre CI - Gérez les registres de packages privés, les CocoaPods via SSH, les SDK d'appareils, les extensions et toute préparation native personnalisée dans Bitrise ou votre CI existante.
2. Compiler vos assets web - Exécutez npm run build (ou la commande de build de votre framework).
3. Synchroniser vers le natif - Exécutez npx cap sync pour copier les assets web compilés dans le projet natif préparé.
4. Demander le build natif - Envoyer le projet préparé ios/ ou android/ projet vers Capgo Build.

Ce que Capgo Build gère

• Compilation native iOS (Xcode, Fastlane)
• Compilation native Android (Gradle)
• Signature Code avec vos identifiants
• Publication facultative sur App Store Connect ou Google Play
• Valeurs de configuration de build natif et d’identifiants prises en charge, transmises en variables d’environnement

Capgo Build n’a pas besoin d’accéder à votre registre Nexus privé ni à vos identifiants SSH une fois que votre CI a préparé le projet natif. Voir Configuration de build pour les variables d’environnement et options de store prises en charge.

Pour une variante kiosque distribuée via MDM, configurez le projet/build Android pour produire un APK. Lors de la demande de build, utilisez les deux flags pour ignorer Google Play et récupérer l’artefact signé :

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload empêche l’upload sur le Play Store même si les identifiants Play sont enregistrés ; --output-upload fournit un lien à durée limitée vers l’artefact signé. Distribuez cet APK via votre MDM.

Étapes suivantes

Maintenant que vous avez créé votre premier build :

• Configurer les builds iOS - Configurer les certificats et profils
• Configurer les builds Android - Configurer les keystores et le Play Store
• Troubleshooting - Problèmes courants et solutions
• Référence CLI - Documentation complète des commandes

Besoin d'aide ?

• Consultez la guide de dépannage
• Rejoignez notre communauté Discord
• Contactez le support par e-mail à support@capgo.app