Démarrage

Commencez avec Capgo Cloud Build et créez votre première build native iOS ou Android en quelques minutes.

Ce dont vous aurez besoin

Avant de commencer, assurez-vous d'avoir :

• Une application Capacitor qui se construit avec succès localement
• Node.js 20 ou une version supérieure installée
• Un compte Capgo avec une abonnement actif
• Votre application déjà enregistrée dans Capgo (exécutez bunx @capgo/cli@latest app add si ce n'est pas le cas)
• Les informations de build configurées (certificats, clés de coffre) - voir ci-dessous

Avant votre première build

⚠️ Configurez vos informations d'identification avant de commencer

Nécessaire avant la construction : Vous devez configurer vos informations d'identification de construction (certificats pour iOS, clés de magasin pour Android).

Configurez vos informations d'identification →

Démarrage rapide

1. Configuration des informations d'identification de construction

   Avant de pouvoir construire, vous devez enregistrer vos informations d'identification localement :

   Pour iOS :

   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"

   Pour Android :

   bunx @capgo/cli@latest build credentials save \
     --platform android \
     --keystore ./release.keystore \
     --keystore-alias "my-key" \
     --keystore-key-password "key-pass" \
     --keystore-store-password "store-pass"

   Voir le guide complet des informations d'identification pour plus de détails. Vérifier la construction locale

2. Tout d'abord, assurez-vous que votre application se construit localement sans erreurs :

   Fenêtre de terminal

   # Build your web assets
   bun run build
   
   # Sync with Capacitor
   bunx cap sync
   
   # Test local build (optional but recommended)
   bunx cap open ios    # For iOS
   bunx cap open android # For Android

3. Définir votre clé Capgo __CAPGO_KEEP_1__ (si elle n'est pas déjà configurée) :

   Set your Capgo API key (if not already configured):

   bunx @capgo/cli@latest login

   Ou définissez la variable d'environnement :

   export CAPGO_TOKEN=your_api_key_here

4. Exécutez votre première construction

   Commencez par une construction de débogage Android (la plus rapide pour tester) :

   bunx @capgo/cli@latest build com.example.app \
     --platform android \
     --build-mode debug

   Vous verrez des journaux en temps réel à mesure que votre construction avance :

   ✔ Creating build job...
   ✔ Uploading project (15.2 MB)...
   ✔ Build started
   
   📝 Build logs:
   → Installing dependencies...
   → Running Gradle build...
   → Signing APK...
   ✔ Build succeeded in 3m 42s

5. Vérifiez l'état de la construction

   Le CLI pollera automatiquement et affichera l'état de la construction. Une fois terminé, vous verrez :

   • Temps de construction
   • Statut de réussite/échec
   • Application soumise à l'App Store/Play Store (si les informations de connexion sont configurées)

Comprendre le Processus de Construction

Lorsque vous exécutez la commande de construction, voici ce qui se produit :

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

1. Préparation locale - Votre projet est compressé (hors node_modules et fichiers cachés)
2. Téléversement - Le zip est téléversé dans un stockage cloud sécurisé (Cloudflare R2)
3. Exécution de la Construction - Votre application se construit sur des infrastructures dédiées
4. Flux de Journalisation - Les journaux en temps réel s'affichent dans votre terminal via les événements envoyés par le serveur
5. Nettoyage Automatique - Les artefacts de construction sont supprimés (Android : instantané, iOS : 24 heures)

Infrastructure de Construction

L'exécution de la construction se déroule sur des Mac Mini Silicon M4 dédiés :

• CPU M4 à 10 noyaux (4 noyaux de performance, 6 noyaux d'efficacité)
• GPU à 10 noyaux
• Moteur Neural à 16 noyaux
• 16 Go de RAM
• macOS Tahoe 26.2

L'image de build prend en charge Xcode 26.2, Android Studio 2025 et les chargeurs de travail .NET 9/.NET 10 SDK natifs pour les pipelines de build.

Votre Première Build de Production

Une fois que vous avez vérifié que le processus fonctionne, créez une build de production :

Android

bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

Vous devez configurer les informations de signature avant de procéder. Consultez Configuration de Build Android.

iOS

bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

Les builds iOS nécessitent des certificats de signature et des profils de provisioning. Voir Configuration de Build iOS.

Qu'est-ce qui est construit

Capgo Seuls les fichiers minimum nécessaires sont téléchargés code Votre source complète code ne quitte jamais votre machine.

Qu'est-ce qui est téléchargé

Inclus	Description
ios/ ou android/	Le dossier de la plateforme native que vous êtes en train de construire
package.json, package-lock.json	Manifeste de dépendance
capacitor.config.*	Capacitor configuration
resources/	Icônes d'application, écrans de splash
Plugin natif code	Seulement le ios/ ou android/ Sous-dossier de chaque plugin Capacitor

Ce qui N'est PAS Téléchargé

Exclus	Pourquoi
node_modules/ La plupart des choses	Seule la plugin native code est incluse, pas les dépendances JS
src/	Votre source web code reste locale
dist/, www/, build/ Au niveau de base (root)	Déjà synchronisé dans le dossier natif via cap sync
.git/	Historique de contrôle de version
.gradle/, .idea/, .swiftpm/	Caches de construction et paramètres de l'IDE
.envSecrets	Jamais téléchargé

Note

Vos actifs web construits (JS, CSS, HTML) sont téléchargés - mais en tant que partie du dossier natif. Lorsque vous exécutez bunx cap sync, votre build web est copié dans ios/App/App/public/ ou android/app/src/main/assets/public/. C'est pourquoi il est nécessaire de lancer cap sync avant de construire.

Vos Responsabilités

Avant de lancer bunx @capgo/cli@latest build:

1. Construirez vos actifs web - Exécutez bun run build (ou la commande de construction de votre framework)
2. Synchroniser avec natif - Exécutez bunx cap sync pour copier les actifs web dans le projet natif
3. Commitez les dépendances - Assurez-vous que tous les plugins natifs sont dans package.json

Quelques choses que Capgo Build gère

• Compilation native iOS (Xcode, Fastlane)
• Compilation native Android (Gradle)
• Code signature avec vos informations d'identification
• Soumission de l'application sur le magasin (si configuré)

Temps de construction & Coûts

Le temps de construction est mesuré depuis le début jusqu'à la fin :

• Android: Généralement 3-5 minutes
• iOS: Généralement 5-10 minutes
• Infrastructure: Ordinateurs Mac Mini Silicon M4 exécutant macOS Tahoe 26.2

Vous ne payez que pour le temps de construction réel utilisé. Aucun frais caché.

Utilisations courantes

Intégration CI/CD

Déclenchez Capgo Build automatiquement à partir de votre GitHub workflow d'Actions — en fonction d'un push, d'une étiquette ou avec un bouton de clic manuel. Consultez la documentation dédiée GitHub Actions pour des exemples complets de workflow couvrant les déclencheurs manuels, les lancements basés sur des étiquettes et les builds de débogage continues.

Développement local

Testez les builds localement avant de les soumettre :

# Quick debug build for testing
bun run build && bunx cap sync
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

Constructions multi-plateformes

Construire pour les deux plateformes en exécutant deux commandes :

# iOS build
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

# Android build
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

Dans CI/CD, vous pouvez exécuter ces commandes en jobs parallèles pour des constructions plus rapides.

Étapes suivantes

Maintenant que vous avez créé votre première construction :

• Configurer les constructions iOS - Configurer les certificats et les profils
• Configurez les builds Android - Configurez les clés de stockage et la boutique Play
• Dépannage - Problèmes courants et solutions
• CLI Reference - Documentation complète des commandes

Besoin d'aide ?

• Vérifiez le guide de dépannage
• Rejoignez notre communauté Discord
• Soutien par email à support@capgo.app