Getting Started

Commencez avec Capgo Build Cloud et créez votre première build natif iOS ou Android en quelques minutes.

Ce dont vous aurez besoin

Avant de commencer, assurez-vous d'avoir :

• A Capacitor app that builds successfully locally
• Node.js 20 ou une version supérieure installée
• Un compte Capgo (un essai gratuit suffit pour commencer)
• Your app already registered in Capgo (run npx @capgo/cli@latest app add si pas
• 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 à 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 de lancer build init, vous ê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 vers laquelle 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

When you run the build command, here’s what happens:

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 - 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'artifact sélectionnées et de stockage-delivery.

Utilisez Capgo Build avec Bitrise ou un autre CI

Capgo Build ne remplace pas votre CI existant. Conservez les étapes nécessitant 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 configuration native personnalisée, construction de la couche web et exécution npx cap sync.

Ensuite, appelez Capgo Build 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 receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

Qu'est-ce qui est téléchargé

Included	Description
ios/ ou android/	The native platform folder you’re building
package.json, package-lock.json	Fichier de manifeste de dépendances
capacitor.config.*	configuration Capacitor
resources/	La configuration __CAPGO_KEEP_0__
Plugin natif code	Seulement le ios/ ou android/ sous-dossier de chaque plugin Capacitor

Sous-dossier de chaque plugin __CAPGO_KEEP_0__

Exclu	Pourquoi
node_modules/ (la plupart d'elle)	Seul 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é

Remarque

Seules vos actifs web construits (JS, CSS et HTML) sont téléchargés car npx cap sync a copié les a copié 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. Construire vos actifs web - Exécutez npm run build (ou votre commande de build de framework).
3. Synchronisez avec le natif - Exécutez npx cap sync - Copiez 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.

- Construisez Capgo.

• - Qu'est-ce que __CAPGO_KEEP_0__ construit ?
• - La compilation native iOS (Xcode, Fastlane)
• Code signing with your credentials
• Soumission facultative vers l'App Store Connect ou Google Play
• Supported native build configuration and credential values passed as environment variables

Capgo La build n'a pas besoin d'accéder à votre registre Nexus privé ou à vos credenciaux SSH une fois que votre CI a préparé le projet native. Consultez Configuration de build for supported environment variables and store options.

Pour une version kiosque distribuée par 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 prevents Play Store upload even if Play credentials are saved; --output-upload propose un lien temporairement accessible vers la sortie signée. Distribuez cet APK par votre MDM.

Étapes suivantes

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

• Configurez les builds iOS Configurez les builds Android
• Résolution des problèmes Résolution des problèmes
• Troubleshooting __CAPGO_KEEP_0__ Référence
• Référence de CLI Documentation de la commande complète

Aidez-moi ?

• Vérifiez le Paramétrez les builds Android
• Rejoignez notre Communauté Discord
• Contactez le support par support@capgo.app