Demarrer

Commencez avec Capgo Cloud Build et créez votre première build 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 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 la commande exacte à 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 de build init, vous êtes déjà prêt — l'inscription vous propose de démarrer une build pour vous à 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 celui 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 des résultats dépend des options d'artefact et de livraison sélectionnées.

Utilisez Capgo Construire avec Bitrise ou un autre CI

Capgo Construire 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.

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

Le projet à compiler et à signer est déjà à l'intérieur du projet natif préparé ; 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 dépôt source.

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.

__CAPGO_KEEP_0__ Construire reçoit le projet natif préparé requis pour compiler votre application. Votre source web __CAPGO_KEEP_1__, l'installation de dépendances privées et __CAPGO_KEEP_2__ restent dans votre CI.

Compris	Description
ios/ ou android/	contexte : texte fragment HTML d'une chaîne de dialogue Capgo plus longue (clé parente `alternatives_cta_questions`). Page/zone : page de comparaison des alternatives de mise à jour en direct de Capacitor. Rôle : long paragraphe de marketing ou juridique. Voir dans : page alternatives.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `alternatives_cta_questions` (Questions de CTA Alternatives). | Texte fragment HTML d'une chaîne de dialogue Capgo plus longue (clé parente `appflow_cta_questions`). Page/zone : page de comparaison et de migration de Appflow. Rôle : long paragraphe de marketing ou juridique. Voir dans : page ionic-appflow.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `appflow_cta_questions` (Questions de CTA Appflow). | Texte fragment HTML d'une chaîne de dialogue Capgo plus longue (clé parente `capwesome_cta_questions`). Page/zone : page de comparaison de Capawesome. Rôle : long paragraphe de marketing ou juridique. Voir dans : page capwesome.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `capwesome_cta_questions` (Questions de CTA Capwesome). | Texte fragment HTML d'une chaîne de dialogue Capgo plus longue (clé parente `consulting_faq_subtitle`). Page/zone : page de services de consultation. Rôle : sous-titre ou slogan de section. Voir dans : page consulting.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `consulting_faq_subtitle` (Sous-titre FAQ de consultation). | Page/zone : page de comparaison et de migration de Appflow. Rôle : étiquette de navigation ou élément de navigation court. Voir dans : page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Clé de message `appflow_plugins_or` (Appflow Plugins ou).
package.json, package-lock.json	Le dossier de plateforme native que vous êtes en train de construire
capacitor.config.*	Capacitor configuration
resources/	__CAPGO_KEEP_0__ configuration
Native plugin code	Plugin natif __CAPGO_KEEP_0__ ios/ Seulement le android/ subfolder of each Capacitor plugin

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

Exclu	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/	Histoire de contrôle de version
.gradle/, .idea/, .swiftpm/	Caches de construction et paramètres de l'IDE
.envSecrets	N'ont jamais été téléchargés

Remarque

Seuls vos actifs web construits (JS, CSS et HTML) sont télé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, les CocoaPods basés sur SSH, les SDKs 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 intitulé « Quelques choses que __CAPGO_KEEP_0__ Build gère »
• Compilation native iOS (Xcode, Fastlane)
• Code signature avec vos informations d'identification
• Soumission facultative sur l'App Store Connect ou Google Play
• Configuration de build native prise en charge et valeurs de jetons transmises sous forme de variables d'environnement

Capgo La build n'a pas besoin d'accéder à votre registre privé Nexus ou à vos informations 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 prises en charge.

Pour une version kiosque distribuée via MDM, configurez le projet Android/ build pour produire un fichier 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 la Play Store même si les informations de compte Play sont enregistrées ; --output-upload fournit un lien temporaire vers la sortie signée. Distribuez cet APK via 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 la boutique Play
• Résolution des problèmes context : Page/zone : Support / support premium ou section de support du pied de page. Rôle : Titre de section ou de page. Vu dans : page support-policy.astro. Clé de message `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