Démarrage

Commencez avec Capgo Cloud Build et créez 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 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)
• 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 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

Si vous venez de lancer build initVous ê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 route. 🎉

Sinon, démarrer une construction vous-même avec build request — définir --platform à 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 à la boutique 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écharger - 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 des infrastructures dédiées
4. Flux de Journal - Les journaux en temps réel s'affichent dans votre terminal via les événements envoyés par le serveur
5. Suppression Automatique - Les artefacts de construction sont supprimés (Android : instant, iOS : 24 heures)

Qu'est-ce qui se construit

Capgo Construit uniquement télécharge les fichiers minimum nécessaires pour compiler votre application native. 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	Le manifeste de dépendance
capacitor.config.*	Capacitor configuration
resources/	Les icônes de l'application, les é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é

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/ (niveau de base)	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 __CAPGO_KEEP_0__ avant la construction est obligatoire.

Vos Responsabilités

Avant l'exécution 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 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
• Soutenez par email à support@capgo.app