Prise en main

Commencez avec Capgo Build Cloud et créez votre première mise en production iOS ou Android native 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 pas
• 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 construire. Si vous n'avez pas déjà :

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

Si vous venez juste de lancer build init, you’re already set — the onboarding offers to start a build for you at the end, so your first build may already be on its way. 🎉

Lancez une construction vous-même. build request — set --platform — définissez-le sur celui que vous construisez :

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 construction en direct dans votre terminal. Capgo La construction peut retourner un artefact signé ou le soumettre à App Store Connect ou Google Play lorsque vous configurez le flux de libération 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échargement - Le projet natif préparé est téléchargé 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 journalisation - Real-time logs stream to your terminal via Server-Sent Events.
5. Nettoyage - L'environnement de construction et les données de projet temporaires sont nettoyés après la construction ; la conservation de sortie dépend des options d'artefact sélectionné et de stockage-delivery.

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 : installer à partir de registres privés, résoudre les CocoaPods privés par SSH, exécuter la configuration native personnalisée, construire la couche web et exécuter npx cap sync.

Ensuite appelez Capgo Construit avec le projet natif préparé. Capgo reçoit le projet prêt ios/ ou android/ project to compile and sign, so it does not need your private Nexus, CocoaPods SSH, or web-build credentials. The compiled web assets are already inside that prepared native project; they are used for the build rather than retained as a source repository.

Qu'est-ce qui est construit

Capgo Build reçoit le projet natif préparé nécessaire à la compilation de votre application. Votre source web code, l'installation de vos dépendances privées et Capacitor restent dans votre CI.

Qu'est-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	Fichier de manifeste de dépendances
capacitor.config.*	configuration Capacitor
resources/	__CAPGO_KEEP_0__ configuration
Plugin natif code	Seulement le ios/ ou android/ une sous-dossier de chaque Capacitor plugin

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

Exclu	Pourquoi
node_modules/ (la plupart d'entre elles)	Seulement le plugin natif code est inclus, pas les dépendances JS
src/	Votre source web code reste locale
dist/, www/, build/ (au niveau racine)	Déjà synchronisé dans le dossier natif via cap sync
.git/	Histoire de contrôle de version
.gradle/, .idea/, .swiftpm/	Construire des caches et des paramètres de l'IDE
.env, secrets	Jamais téléchargés

Remarque

Vos actifs web construits (JS, CSS et HTML) ne sont téléchargés que parce que npx cap sync a copié leurs versions 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, SDKs de périphériques, extensions et toute préparation native personnalisée dans Bitrise ou votre CI existant.
2. Construisez vos actifs web - Exécutez npm run build (ou la commande de construction de votre framework).
3. Synchronisez avec natif - Exécutez npx cap sync pour copier les actifs web compilés dans le projet natif préparé.
4. Demandez la construction native - Envoyez le projet préparé ios/ ou android/ projet pour Capgo Construire.

projet à Capgo Build.

• Compilation natif iOS (Xcode, Fastlane)
• Compilation natif Android (Gradle)
• Code signing with your credentials
• Soumission facultative vers l'App Store Connect ou Google Play
• Valeurs de configuration de compilation native et de variables d'environnement prises en charge

Capgo La construction ne nécessite pas d'accès à votre registre Nexus privé ou à vos informations d'identification SSH une fois que votre CI a préparé le projet natif. Voir Configuration de la construction pour les variables d'environnement et les options de stockage supportées.

Pour une version kiosque distribuée via MDM, configurez le projet Android/la construction pour produire un APK. Lorsque vous demandez la construction, 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 Google Play même si les informations de compte sont enregistrées. --output-upload propose un lien temporaire vers le résultat signé. Distribuez cet APK par le biais de votre MDM.

É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 stockage et Google Play
• Troubleshooting - Problèmes courants et solutions
• CLI Référence - Documentation complète des commandes

Besoin d'aide ?

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