Prise en main

Commencez avec Capgo Build Cloud et créez votre première build iOS ou Android natif 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 dans Capgo (exécutez npx @capgo/cli@latest app add si ce n'est pas le cas)
• Nous n'avons pas besoin de préparer les informations de signature à l'avance — nous les configurerons dans l'étape suivante.

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 effectuer une build. Si vous n'avez pas déjà fait cela :

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

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

Sinon, démarrez une build vous-même avec build request — définissez --platform sur celle que vous êtes en train de construire :

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

Le CLI télécharge le projet natif préparé et diffuse les journaux de build en direct dans votre terminal. Capgo Build peut retourner un artefact signé ou le soumettre à App Store Connect ou Google Play lorsque vous configurez le flux de publication approprié.

Comprendre le Processus de Construction

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

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Préparation dans votre CI - Construire la couche web, résoudre les dépendances privées et synchroniser les actifs terminés dans le projet natif.
2. Téléversement - Le projet natif préparé est téléversé dans un stockage cloud sécurisé pour la construction.
3. Exécution de la Construction - Capgo compile et signe le projet natif 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 - L'environnement de construction et les données de projet temporaires sont nettoyés après la construction ; la conservation de l'output dépend des options d'artefact sélectionnées et de stockage.

Utilisez Capgo Construire avec Bitrise ou un autre CI

Capgo Construit ne remplace pas votre CI existant. Gardez les étapes qui nécessitent votre accès privé dans Bitrise ou un autre système CI : installation à partir de registres privés, résolution de CocoaPods privés par SSH, exécution de la mise en place native personnalisée, construction de la couche web et exécution npx cap sync.

Ensuite, appelez Capgo Construit avec le projet natif préparé. Capgo reçoit le projet prêt ios/ ou android/ ou

ou

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

ou

Inclus	Description
ios/ ou android/	La sous-dossier natif de la plateforme que vous êtes en train de construire
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 les ios/ ou android/ Le sous-dossier de chaque plugin Capacitor

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

Exclus	Pourquoi
node_modules/ (la plupart d'entre elles)	Seule la plugin native code est incluse, 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
.envSecrets	N'ont jamais été chargés

Note

Seuls vos actifs web construits (JS, CSS et HTML) sont chargés car npx cap sync a copié leurs contenus dans le projet natif. Les étapes de source web et d'installation de dépendances restent dans votre CI ; le projet natif préparé est utilisé pour construire le binaire et ensuite nettoyé.

Vos Responsabilités

Avant de lancer npx @capgo/cli@latest build request:

1. Préparez dans votre CI - Résolvez les registres de packages privés, CocoaPods basés sur SSH, les SDK de périphériques, les extensions et toute préparation native personnalisée dans Bitrise ou votre CI existant.
2. Construire vos actifs web - Exécutez npm run build ou votre commande de construction de framework.
3. Sync avec natif - Exécutez npx cap sync pour copier les actifs web compilés dans le projet natif préparé.
4. Demander la construction native - Envoyez le projet préparé ios/ ou android/ project to Capgo Build.

projet à Capgo Build.

• Sous-titre de section intitulé « Qu'est-ce que __CAPGO_KEEP_0__ Build Gère »
• Compilation native iOS (Xcode, Fastlane)
• Code signature avec vos informations d'identification
• Soumission facultative vers l'App Store Connect ou Google Play
• Configuration de build native prise en charge et valeurs de credenciaux transmises sous forme de variables d'environnement

Capgo La build n'a pas besoin d'accéder à votre registre privé Nexus ou à vos informations d'identification SSH une fois que votre CI a préparé le projet native. Consultez Configuration de build pour les variables d'environnement et les options de magasin pris en charge.

Pour une version kiosk distribuée via MDM, configurez le projet Android/ build pour produire un APK. Lorsque vous demandez la build, utilisez les deux drapeaux pour ignorer Google Play et récupérer la sortie signée :

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload empêche l'envoi vers le Play Store même si les informations d'identification de Play sont enregistrées ; --output-upload fournit un lien temporairement accessible vers la sortie signée. Distribuez cet APK via votre MDM.

Étapes suivantes

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

• Configurer les builds iOS - Configurer les certificats et les profils
• Configurer les builds Android - Configurer les clés de stockage et la Play Store
• Résolution des problèmes context : Page/zone : Support / page de support premium ou section de support du pied de page. Rôle : En-tête de section ou de page. Vu dans : page support-policy.astro. Message clé `support_policy_troubleshooting_title` (Titre de la politique de support - Résolution des problèmes).
• CLI Reference __CAPGO_KEEP_0__ Reference

- Documentation complète des commandes

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