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 (un essai gratuit suffit pour commencer)
• Votre application déjà enregistrée sur Capgo (exécutez bunx @capgo/cli@latest app add si ce n'est pas le cas)
• (Il n'est pas nécessaire de préparer les informations de signature à l'avance — nous les configurerons au prochain étape.)

Configurez vos informations de signature

Capgo nécessite des informations de signature pour construire et soumettre votre application — mais vous n'avez pas besoin de les gérer manuellement. Répondez à quelques questions et nous vous indiquerons l'exacte commande à exécuter :

Exécutez votre première construction

Vous devez être authentifié avec Capgo pour construire. Si vous n'avez pas déjà fait cela :

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

Si vous venez de faire build init, vous êtes déjà prêt — l'inscription vous propose de démarrer une construction pour vous à la fin, donc votre première construction peut déjà être en cours. 🎉

Sinon, démarrez une construction vous-même avec build request — définissez --platform quel que soit votre projet :

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

Le CLI télécharge votre projet, diffuse les journaux de construction en direct dans votre terminal, et — une fois vos informations d'identification configurées — soumet le résultat au magasin automatiquement.

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échargé dans un stockage cloud sécurisé (Cloudflare R2)
3. Exécution de la construction - Votre application se construit sur une infrastructure dédiée
4. Flux de journaux - 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 : instant, iOS : 24 heures)

Ce qui est construit

Capgo La construction ne télécharge que les fichiers minimum nécessaires pour compiler votre application native. Votre source complète code ne quitte jamais votre machine.

Ce qui est téléchargé

Inclus	Description
ios/ ou android/	Le dossier de la plateforme native que vous construisez
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/ répertoire sous-dossier de chaque Capacitor plugin

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

Exclu	Pourquoi
node_modules/ (la plupart d'elle)	Seul le plugin natif code est inclus, pas les dépendances JS
src/	Votre source web code reste locale
dist/, www/, build/ (niveau de base)	Déjà synchronisé dans le dossier natif via cap sync
.git/	L'historique de contrôle de version
.gradle/, .idea/, .swiftpm/	Les caches de construction et les paramètres de l'IDE
.envles secrets	Jamais téléchargés

Remarque

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 d'exécuter bunx @capgo/cli@latest build:

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

Qu'est-ce que Capgo Build Gère

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

Étapes suivantes

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

• Configuration des builds iOS - Configurez les certificats et les profils
• Configuration des builds Android - Configurez les clés de stockage et l'App Store
• Dépannage - Problèmes courants et solutions
• CLI Référence - Documentation complète de la commande

Aidez-moi ?

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