Démarrage

Démarrer avec Capgo Cloud Build et créer 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
• A un compte Capgo (un essai gratuit suffit pour commencer)
• Votre application est déjà enregistrée dans 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à :

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

If vous venez de lancer build initVous êtes déjà prêt — l'assistant de démarrage vous propose de lancer une construction pour vous à la fin, donc votre première construction peut déjà être en cours.

Sinon, lancez une construction vous-même avec build request — définissez --platform sur celui que vous construisez :

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 au magasin automatiquement.

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éversement - Le zip est téléversé 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)

Qu'est-ce qui se Construit

Capgo Seule la mise à jour de construction télécharge 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 êtes en train de construire
package.json, package-lock.json	Le manifeste de dépendance
capacitor.config.*	Capacitor configuration
resources/	Icônes d'applications, écrans de démarrage
Plugin natif code	Seulement le ios/ ou android/ sous-dossier de chaque plugin Capacitor

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

Exclu	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/ (root level)	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
.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 cap sync est requise 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. Commit des dépendances - Assurez-vous que tous les plugins natifs soient dans package.json

Quel est 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 :

• Configurez les builds iOS - Configurez les certificats et les profils
• - Configurez les builds Android - Configurez les clés de coffre et la Play Store
• Résolution des problèmes - Problèmes courants et solutions
• CLI Référence - Documentation complète des commandes

Aidez-moi?

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