Démarrage

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

Ce dont vous aurez besoin

Avant de commencer, assurez-vous d'avoir :

• A une application Capacitor qui se construit avec succès localement
• Node.js 20 ou supérieur installé
• 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 déjà fait)
• Pas besoin 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à fait cela :

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éfinir --platform à l'élément 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 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 vous exécutez la commande de construction, voici ce qui se passe :

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éparez dans votre CI - Construisez la couche web, résolvez les dépendances privées et synchronisez les actifs terminés dans le projet natif.
2. Téléversez - 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 journaux - Les journaux en temps réel s'écoulent vers 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 retenue des sorties dépend des options d'artefact sélectionnées et de stockage-delivery.

Utilisez Capgo Construisez avec Bitrise ou un autre CI

Capgo Build 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 configuration native personnalisée, construction de la couche web et exécution npx cap sync.

Appelez ensuite Capgo Build avec le projet natif préparé. Capgo reçoit le projet prêt ios/ ou android/ le projet à compiler et à signer, il n'a donc pas besoin de vos informations de connexion privées pour Nexus, CocoaPods SSH ou web-build. Les actifs web compilés sont déjà à l'intérieur de ce projet natif préparé ; ils sont utilisés pour la construction plutôt que conservés en tant que référentiel source

Ce qui est construit

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

Ce qui est téléchargé

Y est inclus	La 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.*	La configuration Capacitor
resources/	Icônes d'application, écrans de splash
Le 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 d'elle)	Seule la plugin native code est incluse, pas les dépendances JS
src/	Votre source web code reste locale
dist/, www/, build/ (niveau racine)	Déjà synchronisée 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é

Remarque

Seuls vos actifs web construits (JS, CSS et HTML) sont téléchargés car npx cap sync a copié les fichiers 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, les 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 la commande de construction de votre framework).
3. Synchronisez avec le 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/ à Capgo Build.

Qu'est-ce que Capgo Build gère

• Compilation native iOS (Xcode, Fastlane)
• Compilation native Android (Gradle)
• Signature Code 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 construction ne nécessite pas d'accès à votre registre Nexus privé ou à vos credenciaux SSH une fois que votre CI a préparé le projet native. Voir Configuration de build pour les variables d'environnement et les options de stockage prises en charge.

Pour une version kiosk distribuée par MDM, configurez le projet Android/build 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 la Play Store même si les credenciaux Play sont sauvegardés ; --output-upload fournit un lien temporairement limité vers la sortie signée. Distribuez cet APK par votre MDM.

Étapes suivantes

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

• Configure les builds iOS - Configurez les certificats et les profils
• Configure les builds Android - Configurez les clés de stockage et la boutique Play
• Résolution des problèmes - Problèmes courants et solutions
• CLI Reference - Documentation complète des commandes

Aidez-moi ?

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