🔹 construction

🏗️ Gérez les builds natifs iOS/Android à travers Capgo Cloud.

🚀 Init

Alias : onboarding

npx @capgo/cli@latest build init

Configurez les informations de build iOS interactivement (créez des certificats et des profils automatiquement). Sur macOS, cela peut également créer votre clé App Store Connect API pour vous, guidé.

🔹 Demande

npx @capgo/cli@latest build request

Demander une mise en construction native à Capgo Cloud. Cette commande va compresser votre répertoire de projet et l'envoyer à Capgo pour la construction. La construction sera traitée et envoyée directement aux magasins d'applications. 🔒 SÉCURITÉ : Les informations d'identification ne sont jamais stockées sur les serveurs de Capgo . Elles sont supprimées automatiquement après la fin de la construction. Les sorties de construction peuvent être envoyées optionnellement pour des liens de téléchargement à temps limité. 📋 PRÉREQUISITE : Enregistrer les informations d'identification d'abord avec : npx @capgo/cli build credentials save --appId <app-id> --platform <ios|android>

Exemple :

npx @capgo/cli@latest build request com.example.app --platform ios --path .

Options :

Paramètre	Type	Description
—chemin	string	Chemin vers le répertoire du projet à construire (par défaut : répertoire courant)
—plateforme	string	Plateforme cible : ios ou android (obligatoire)
—mode de construction	string	Mode de construction : debug ou release (par défaut : release)
—certificat de base64 de construction	string	iOS : Certificat de base64 .p12
—mot de passe de certificat	string	iOS : Mot de passe du certificat (facultatif si certificat n'a pas de mot de passe)
—identifiant Apple	string	iOS : Adresse e-mail de l'identifiant Apple pour les téléchargements de mot de passe d'application (alternative à la clé App Store Connect API)
—mot de passe d'application spécifique	string	iOS: Mot de passe de l'application (xxxx-xxxx-xxxx-xxxx) pour les téléchargements TestFlight
—apple-app-id	string	iOS: Identifiant d'application numérique App Store Connect (obligatoire avec —apple-id et —apple-app-specific-password)
—apple-key-id	string	iOS: Identifiant de clé App Store Connect API
—apple-issuer-id	string	iOS: Identifiant émetteur App Store Connect
—apple-key-content	string	iOS: Clé App Store Connect API encodée en Base64 (.p8)
—app-store-connect-team-id	string	iOS: Identifiant de l'équipe App Store Connect
—ios-scheme	string	iOS : Schéma Xcode pour la construction (par défaut : App)
—ios-target	string	iOS : Cible Xcode pour la lecture des paramètres de construction (par défaut : même que le schéma)
—ios-distribution	string	iOS : Mode de distribution
—ios-provisioning-profile	string	iOS : Chemin du profil de provisionnement ou bundleId=path mapping (répétable)
—android-keystore-file	string	Android : Fichier de clé de stockage encodé en Base64
—keystore-key-alias	string	Android : Alias de clé de stockage
—keystore-key-password	string	Android: Mot de passe de la clé de magasin
__CAPGO_KEEP_0__	string	Android: Mot de passe de magasin
__CAPGO_KEEP_1__	string	Android: JSON encodé en Base64 du compte de service Google Play
__CAPGO_KEEP_2__	string	Android: Saveur de produit à construire (par exemple, production). Obligatoire si votre projet a plusieurs saveurs.
__CAPGO_KEEP_3__	boolean	Éviter l'envoi vers la Play Store pour cette construction (annule la configuration de magasin sauvegardée). Exige —output-upload.
Soumettre la mise à jour téléchargée pour examen de la boutique : Android termine la mise à jour de Play ; iOS soumet la mise à jour de TestFlight traitée à l'examen de la boutique d'App Store.	boolean	__CAPGO_KEEP_4__
Nom de la mise à jour de la boutique	string	Nom de version de magasin/numéro de version. L'Android l'utilise comme nom de version de Google Play ; iOS l'utilise comme numéro de version de l'App Store.
—notes de version de magasin	string	Notes de version de magasin par défaut. L'Android l'utilise comme journal des changements de Play ; iOS l'utilise comme texte de ce qui est nouveau par défaut de l'App Store.
—notes de version de magasin localisées	string	Notes de version de magasin localisées, répétables comme locale=notes, par exemple —store-release-notes-locale “fr-FR=Corrections”.
—groupes de TestFlight iOS	string	Seulement iOS : noms ou identifiants de groupes de TestFlight externes séparés par des virgules facultatifs pour la distribution bêta.
—lancement automatique de l'App Store iOS	boolean	Seulement iOS : lancer automatiquement la version de l'App Store après l'approbation d'Apple. La valeur par défaut est le lancement manuel.
—ne pas lancer automatiquement l'App Store iOS	boolean	Seulement iOS : garder la version de l'App Store approuvée en attente d'un lancement manuel.
—sortie-téléchargement	boolean	Modifier le comportement de téléchargement de sortie pour cette construction uniquement (activer). Prépondérance : CLI > env > identifiants enregistrés
—pas-de-sortie-téléchargement	boolean	Modifier le comportement de téléchargement de sortie pour cette construction uniquement (désactiver). Prépondérance : CLI > env > identifiants enregistrés
—rétention-sortie	string	Modifier la durée de vie de la liaison de sortie pour cette construction uniquement (1h à 7j). Exemples : 1h, 6h, 2j. Prépondérance : CLI > env > identifiants enregistrés
—passer-en-rebrousse-poil-de-numéro-de-construction	boolean	Ignorer l'incrémentation automatique du numéro de construction/version code. Utilisez la version qui est déjà dans les fichiers du projet.
—pas-de-passer-en-rebrousse-poil-de-numéro-de-construction	boolean	Remettre les identifiants enregistrés pour réactiver l'incrémentation automatique du numéro de construction pour cette construction uniquement.
-a,	string	API clé pour se connecter à votre compte
—supa-host	string	URL de l'hôte Supabase personnalisée (pour l'hébergement autonome ou le développement Capgo)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement autonome)
—verbose	boolean	Activer l'affichage détaillé avec des journaux de débogage

--submit-to-store-review, --store-release-name, --store-release-notes, et --store-release-notes-locale travailler sur les deux Android et iOS. Utilisez --store-release-notes comme texte de fallback, puis répétez --store-release-notes-locale "locale=notes" pour chaque localisation de magasin :

npx @capgo/cli@latest build request com.example.app \
  --platform ios \
  --build-mode release \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales" \
  --no-ios-automatic-release

Dans CI, vous pouvez également fournir les mêmes notes localisées sous forme de JSON avec CAPGO_STORE_RELEASE_NOTES_LOCALIZED, par exemple {"en-US":"General improvements","nl-NL":"Algemene verbeteringen"}.

🔹 Credentials

npx @capgo/cli@latest build credentials

Gérer les informations d'identification de build stockées localement sur votre machine. 🔒 SÉCURITÉ :

• Informations d'identification sauvegardées dans ~/.capgo-credentials/credentials.json (global) ou .capgo-credentials.json (local)
• Lors de la construction, envoyées à Capgo mais N'EN PAS stockées de manière permanente
• Supprimées de Capgo immédiatement après la construction
• Les sorties de construction peuvent être téléchargées optionnellement pour des liens de téléchargement à temps limité 📚 DOCUMENTATION: iOS setup : https://capgo.app/docs/builder/ios/ Configuration Android : https://capgo.app/docs/builder/android/

Continuez à partir de la construction

Si vous utilisez la construction pour planifier l'automatisation CI/CD, connectez-le avec Capgo CI/CD pour le flux de workflow du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de workflow du produit dans Capgo Builds natifs, Capgo Intégrations pour le flux de produit dans Capgo Intégrations, Intégration CI/CD pour le détail d'implémentation dans Intégration CI/CD, et GitHub Intégration d'Actions pour le détail d'implémentation dans GitHub Intégration d'Actions.