Commencer

Démarrer avec Capgo Cloud Build et créer votre première mise en production 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 démarrer)
• Votre application est déjà enregistrée dans Capgo (exécutez bunx @capgo/cli@latest app add si ce n'est pas le cas)
• (Aucune nécessité 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 la commande exacte à exécuter :

Exécutez votre première construction

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

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

Si vous venez de l'exécuter 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émarrer une construction vous-même avec build request — définir --platform à celui que vous êtes en train de construire :

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 de connexion configurées — soumet le résultat automatiquement au magasin.

Comprendre le Processus de Construction

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

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écharger - Le zip est téléchargé vers 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 logs - Les logs 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 Se Construit

Capgo Construit uniquement télécharge les fichiers minimums nécessaires pour compiler votre application native. Votre source complète __CAPGO_KEEP_0__ ne quitte jamais votre machine. to compile your native app. Your full source code never leaves your machine.

Section intitulée “Qu'est-ce qui est téléchargé”

Description	ou
ios/ Le dossier de la plateforme native que vous êtes en train de construire android/	Le manifeste de dépendance
package.json, package-lock.json	__CAPGO_KEEP_0__ configuration
capacitor.config.*	Capacitor configuration
resources/	App icons, splash screens
Plugin natif code	Seulement le ios/ ou android/ sous-dossier de chaque plugin Capacitor

Qu’est-ce qui N’EST PAS téléchargé

Exclus	Pourquoi
node_modules/ (la plupart de cela)	Seulement 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/	Histoire de contrôle de version
.gradle/, .idea/, .swiftpm/	Cache de construction et paramètres de l'IDE
.env, secrets	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 l'exécution avant la construction est requise. cap sync avant de construire est requis.

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. Commit des dépendances - Assurez-vous que tous les plugins natifs soient en place package.json

Quel 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 l'app store (si configuré)

Étapes suivantes

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

• Configurer les builds iOS - Configurez 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
• Support par email à support@capgo.app