Commencer

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 supérieur installé
• Un compte Capgo avec un abonnement actif
• Votre application est déjà enregistrée dans Capgo (exécutez npx @capgo/cli@latest app add sinon)
• Certains d’identification de build configurés (certificats, magasins de clés) - voir ci-dessous

Avant votre première construction

⚠️ Configurez d'abord les informations d'identification

Obligatoire avant la construction : Vous devez configurer vos informations d’identification de construction (certificats pour iOS, magasins de clés pour Android).

Configurer les informations d’identification →

Démarrage rapide

1. Configurer les informations d’identification de build

   Avant de pouvoir créer, vous devez enregistrer vos informations d’identification localement :

   Pour iOS :

   npx @capgo/cli 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 :

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

   Consultez le guide complet des informations d’identification pour plus de détails.

2. Vérifier la version locale

   Tout d’abord, assurez-vous que votre application est construite localement sans erreurs :

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

3. Authentifiez-vous auprès de Capgo

   Définissez votre clé Capgo API (si elle n’est pas déjà configurée) :

   npx @capgo/cli@latest login

   Ou définissez la variable d’environnement :

   export CAPGO_TOKEN=your_api_key_here

4. Exécutez votre première build

   Commencez par une version de débogage Android (la plus rapide à tester) :

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

   Vous verrez des journaux en temps réel au fur et à mesure de la progression de votre build :

   ✔ 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érifier l’état de la construction

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

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

Comprendre le processus de construction

Lorsque vous exécutez la commande build, voici ce qui se passe :

flowchart LR
    A[Votre machine] -->|1. Projet Zip| B[Température locale]
    B -->|2. Télécharger| C[Capgo Nuage]
    C -->|3. Construire| D[Construire le serveur]
    D -->|4. Flux de journaux| Un
    D -->|5. Nettoyage| E[Suppression automatique]

1. Préparation locale - Votre projet est compressé (hors node_modules et dotfiles)
2. Télécharger - Le zip est téléchargé sur un stockage cloud sécurisé (Cloudflare R2)
3. Build Execution – Votre application s’appuie sur une infrastructure dédiée
4. Log Streaming - Les journaux en temps réel sont diffusés sur votre terminal via les événements envoyés par le serveur.
5. Nettoyage automatique - Les artefacts de build sont supprimés (Android : instantané, iOS : 24 heures)

Votre première version de production

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

Android

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

Vous devrez d’abord configurer les informations de signature. Voir Android Configuration de construction.

iOS

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

Les builds iOS nécessitent la signature de certificats et de profils de provisionnement. Voir iOS Configuration de construction.

Ce qui est construitCapgo Build télécharge uniquement le minimum de fichiers requis pour compiler votre application native. Votre code source complet ne quitte jamais votre machine.

Ce qui est téléchargé

Inclus	Descriptif
ios/ ou android/	Le dossier de plateforme natif que vous créez
package.json, package-lock.json	Manifeste de dépendance
capacitor.config.*	Configuration Capacitor
resources/	Icônes d’applications, écrans de démarrage
Code du plugin natif	Seul le sous-dossier ios/ ou android/ de chaque plugin Capacitor

Ce qui n’est PAS téléchargé

Exclus	Pourquoi
node_modules/ (la plupart)	Seul le code natif du plugin est inclus, pas les dépendances JS
src/	Votre code source Web reste local
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/	Construire des caches et des paramètres IDE
.env, secrets	Jamais téléchargé

Note

Vos ressources Web créées (JS, CSS, HTML) sont téléchargées - mais dans le cadre du dossier natif. Lorsque vous exécutez npx 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 d’exécuter « cap sync » avant la construction.

Vos responsabilités

Avant d’exécuter npx @capgo/cli build :

1. Créez vos ressources Web - Exécutez npm run build (ou la commande build de votre framework)
2. Synchroniser avec le natif – Exécutez npx cap sync pour copier les ressources Web dans le projet natif
3. Dépendances de validation - Assurez-vous que tous les plugins natifs sont dans package.json

Quelles sont les poignées de construction de Capgo

• Compilation native iOS (Xcode, Fastlane)
• Compilation native Android (Gradle)
• Signature de code avec vos informations d’identification
• Soumission de l’App Store (si configuré)

Temps et coûts de construction

Le temps de construction est mesuré du début à la fin :

• Android : généralement 3 à 5 minutes (1 × multiplicateur de facturation)
• iOS : généralement 5 à 10 minutes (multiplicateur de facturation 2 × en raison des coûts matériels Mac)

Vous ne payez que pour le temps de construction réellement utilisé. Pas de frais cachés.

Cas d’utilisation courants

Intégration CI/CD

Ajoutez à votre workflow d’actions GitHub :

- name: Build native app
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
  run: |
    npm run build
    npx cap sync
    npx @capgo/cli@latest build ${{ secrets.APP_ID }} \
      --platform both \
      --build-mode release

Développement Local

Testez les builds localement avant de les valider :

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

Constructions multiplateformes

Créez pour les deux plates-formes en exécutant deux commandes :

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

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

Dans CI/CD, vous pouvez les exécuter dans des tâches parallèles pour des builds plus rapides.

Prochaines étapes

Maintenant que vous avez créé votre premier build :

• Configurer les builds iOS - Configurer les certificats et les profils
• Configurer les builds Android - Configurer les magasins de clés et Play Store
• Dépannage - Problèmes courants et solutions
• CLI Référence - Documentation complète des commandes

Besoin d’aide ?

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