đč build
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
đïž GĂ©rez les builds natifs iOS/Android via Capgo Cloud.
AccĂšs au build et sortie
Section intitulĂ©e « AccĂšs aux builds et sorties »Les builds cloud natifs sont disponibles sur tous les plans Capgo. Les identifiants de build ne sont jamais stockĂ©s sur les serveurs Capgo : ils ne servent quâau build, puis sont supprimĂ©s. Les sorties de build peuvent ĂȘtre uploadĂ©es en option, avec des liens de tĂ©lĂ©chargement Ă durĂ©e limitĂ©e.
Enregistrez d'abord vos identifiants
Section intitulĂ©e « Enregistrer dâabord les identifiants »npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidRĂ©cupĂ©rer une URL de sortie en CI
Section intitulĂ©e « Capturer une URL de sortie en CI »Passer --output-record pour conserver lâURL de tĂ©lĂ©chargement et le QR code, puis utiliser build last-output pour le lire :
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrlđč NĂ©cessaire
Section intitulĂ©e « đč NĂ©cessaire »npx @capgo/cli@latest build neededđ§ Affiche « yes » et quitte avec code 1 si un build natif est requis ; sinon affiche « no » et quitte avec code 0. Les Ă©checs de commande quittent avec code 2.
Exemple :
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOptions :
| ParamĂštre | Type | Description |
|---|---|---|
| -a | string | Clé API pour lier votre compte |
| -c | string | Canal auquel se comparer. Par défaut, CapacitorUpdater.defaultChannel ou le canal public par défaut |
| âpackage-json | string | Chemins des fichiers package.json pour les monorepos (sĂ©parĂ©s par des virgules) |
| ânode-modules | string | Chemins des rĂ©pertoires node_modules pour les monorepos (sĂ©parĂ©s par des virgules) |
| âverbose | boolean | Activer la sortie verbose avec des logs dĂ©taillĂ©s |
| âsupa-host | string | URL d'hĂŽte Supabase personnalisĂ©e (pour l'auto-hĂ©bergement ou le dĂ©veloppement Capgo) |
| âsupa-anon | string | ClĂ© anon Supabase personnalisĂ©e (pour l'auto-hĂ©bergement) |
đ Initialiser
Section intitulĂ©e « đ Init »Alias : onboarding
npx @capgo/cli@latest build initConfigurez les identifiants de build de maniÚre interactive (iOS : certificats + profils automatisés ; Android : keystore + Google OAuth provisionne le compte de service GCP et l'invitation Play Console)
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| -a | string | Clé API pour lier votre compte |
| -p | string | Plateforme à onboarder (ios ou android). Si non précisé, détection automatique s'il n'existe qu'un seul dossier natif ; sinon, un prompt s'affiche. |
| âsupa-host | string | URL d'hĂŽte Supabase personnalisĂ©e (pour l'auto-hĂ©bergement ou le dĂ©veloppement Capgo) |
| âno-analytics | boolean | DĂ©sactiver l'onboarding analytics du build et le replay du terminal pour cette exĂ©cution |
đč RequĂȘte
Section intitulĂ©e « đč RequĂȘte »npx @capgo/cli@latest build requestDemander un build natif depuis Capgo Cloud. Cette commande compresse votre rĂ©pertoire de projet et lâenvoie vers Capgo pour le build. Le build est traitĂ© puis envoyĂ© directement aux stores. Les identifiants ne sont jamais stockĂ©s sur les serveurs Capgo ; ils sont supprimĂ©s aprĂšs le build. Enregistrez-les avant de demander un build :
npx @capgo/cli build credentials save --appId APP_ID --platform iosExemple :
npx @capgo/cli@latest build request com.example.app --platform ios --path .Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âchemin | string | Chemin du rĂ©pertoire du projet Ă compiler (par dĂ©faut : rĂ©pertoire courant) |
| ânode-modules | string | Chemins des rĂ©pertoires node_modules pour les monorepos (sĂ©parĂ©s par des virgules) |
| âplateforme | string | Plateforme cible : ios ou android (requis) |
| âbuild-mode | string | Mode de build : debug ou release (par dĂ©faut : release) |
| âbuild-certificate-base64 | string | iOS : certificat .p12 encodĂ© en Base64 |
| âp12-password | string | iOS : mot de passe du certificat (optionnel si le certificat n'en a pas) |
| âapple-id | string | iOS : e-mail Apple ID pour l'upload de mots de passe d'application (alternative Ă la clĂ© App Store Connect API) |
| âapple-app-specific-password | string | iOS : mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour l'upload sur TestFlight |
| âapple-app-id | string | iOS : ID numĂ©rique de l'app App Store Connect (requis avec âapple-id et âapple-app-specific-password) |
| âapple-key-id | string | iOS : ID de la clĂ© API d'App Store Connect |
| âapple-issuer-id | string | iOS : Issuer ID d'App Store Connect |
| âapple-key-content | string | iOS : clĂ© API dâApp Store Connect encodĂ©e en Base64 (.p8) |
| âapp-store-connect-team-id | string | iOS : Team ID App Store Connect |
| âios-scheme | string | iOS : schĂ©ma Xcode Ă compiler (par dĂ©faut : App) |
| âios-target | string | iOS : cible Xcode pour lire les paramĂštres de build (par dĂ©faut : identique au schĂ©ma) |
| âxcode-version | string | iOS : compiler sur une machine avec cette version de Xcode (ex. 26, 26.0.1, 27). Une version majeure accepte nâimporte quelle version mineure. Par dĂ©faut : nâimporte quelle machine. PrioritĂ© : CLI > variable dâenvironnement (CAPGO_IOS_XCODE_VERSION) > identifiants enregistrĂ©s |
| âios-distribution | string | iOS : Mode de distribution |
| âios-provisioning-profile | string | iOS : chemin du profil de provisionnement ou mapping bundleId=path (rĂ©pĂ©table) |
| âandroid-keystore-file | string | Android : fichier keystore encodĂ© en Base64 |
| âkeystore-key-alias | string | Android : alias de la clĂ© keystore |
| âkeystore-key-password | string | Android : mot de passe de la clĂ© keystore |
| âkeystore-store-password | string | Android : mot de passe du keystore |
| âplay-config-json | string | Android : JSON du compte de service Google Play encodĂ© en Base64 |
| âandroid-flavor | string | Android : product flavor Ă compiler (ex : production). Obligatoire si votre projet a plusieurs flavors. |
| âandroid-track | string | Android : canal Google Play pour cet upload (internal, alpha, beta, production). Par dĂ©faut sans âsubmit-to-store-review : internal. Avec âsubmit-to-store-review et sans canal dĂ©fini : production. PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âandroid-release-status | string | Android : statut de la release Google Play (draft, completed, inProgress, halted). Par dĂ©faut sans âsubmit-to-store-review : draft. Avec âsubmit-to-store-review et sans statut dĂ©fini : completed. PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âin-app-update-priority | string | Android : prioritĂ© de la mise Ă jour in-app Google Play pour cette release (entier 0â5 ; plus Ă©levĂ© = plus urgent). Voir https://developer.android.com/guide/playcore/in-app-updates. PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âno-playstore-upload | boolean | Ignorer lâupload Play Store pour ce build (annule la configuration Play enregistrĂ©e). NĂ©cessite âoutput-upload. |
| âsubmit-to-store-review | boolean | AprĂšs lâupload, soumettre la release store Ă la review au lieu de la laisser en brouillon/inactive. Sur Android, cela cible par dĂ©faut la track production avec release_status completed (Ă remplacer via âandroid-track / PLAY_STORE_TRACK et âandroid-release-status / PLAY_STORE_RELEASE_STATUS). Sur iOS, cela soumet le build TestFlight traitĂ© Ă la review App Store. |
| âstore-release-name | string | Nom/Ă©tiquette de version de la release store. Android lâenvoie comme version_name Google Play ; iOS lâutilise comme version App Store lors de la crĂ©ation ou de la rĂ©utilisation de la version Ă©ditable. |
| âstore-release-notes | string | Notes de release store par dĂ©faut. Android les utilise comme changelog Play ; iOS les utilise comme texte de secours « NouveautĂ©s » de lâApp Store. |
| âstore-release-notes-locale | string | Notes de release store localisĂ©es (rĂ©pĂ©table), par exemple âstore-release-notes-locale en-US=âBug fixesâ âstore-release-notes-locale fr-FR=âCorrectionsâ. |
| âios-testflight-groups | string | iOS : noms ou ID de groupes externes TestFlight, sĂ©parĂ©s par des virgules, pour la distribution bĂȘta externe. |
| âios-automatic-release | boolean | iOS : publier automatiquement la version App Store aprĂšs approbation dâApple. Par dĂ©faut, la publication est manuelle. |
| âno-ios-automatic-release | boolean | iOS : garder la version App Store en attente de publication manuelle aprĂšs validation par Apple. |
| âoutput-upload | boolean | RedĂ©finit le comportement d'upload de la sortie pour ce build uniquement (activer). PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âno-output-upload | boolean | RedĂ©finit le comportement d'upload de la sortie pour ce build uniquement (dĂ©sactiver). PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âoutput-retention | string | Ăcrasez la durĂ©e de vie du lien de sortie pour ce build uniquement (1h Ă 7j). Exemples : 1h, 6h, 2j. PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âoutput-record | string | AprĂšs un build rĂ©ussi, Ă©crit un enregistrement JSON (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) Ă un chemin donnĂ©. Un QR code PNG code est aussi Ă©crit Ă cĂŽtĂ© de ce chemin avec le .qr.png suffixe. Relire les champs avec build last-output. |
| âno-cache | boolean | Ignorer la restauration du cache de build et ne pas enregistrer de nouvelle entrĂ©e de cache pour ce build. Le cache de build est activĂ© par dĂ©faut pour chaque app. |
| âcache-key | string | Partitionner le cache de build par environnement, branche ou flavor Android (par exemple prod, staging). Omettre pour un cache par dĂ©faut partagĂ© par app. |
| âno-skip-build-number-bump | boolean | Remplacer les identifiants enregistrĂ©s pour rĂ©activer l'incrĂ©mentation automatique du numĂ©ro de build pour ce build uniquement. |
| âskip-marketing-version-bump | boolean | Ignorer l'incrĂ©mentation automatique de la version marketing (CFBundleShortVersionString / versionName) lorsque l'app est dĂ©jĂ publiĂ©e. |
| âsync-ios-version | boolean | iOS : synchroniser la MARKETING_VERSION de Xcode depuis package.json avant l'upload du projet. |
| âai-analytics | boolean | En cas d'Ă©chec du build, envoyez les logs Ă l'IA Capgo pour diagnostic. Dans les terminaux interactifs, cela Ă©vite la confirmation prĂ©alable ; en CI, l'upload est automatique et l'analyse s'affiche sur stderr. |
| âno-prescan | boolean | Ignorer le scan automatique avant le build |
| âprescan-ignore-fatal | boolean | ExĂ©cuter le scan prĂ©-build sans jamais bloquer le build (rapport uniquement) |
| âprescan-skip | string | Ignorer des vĂ©rifications prescan spĂ©cifiques par id (rĂ©pĂ©table ou sĂ©parĂ© par des virgules). Les autres vĂ©rifications s'exĂ©cutent toujours. |
| âprescan-warn | string | Passer certaines vĂ©rifications prescan en avertissement par id (rĂ©pĂ©table ou sĂ©parĂ© par des virgules). La vĂ©rification s'exĂ©cute toujours. |
| âfail-on-warnings | boolean | Traiter les avertissements du prescan comme des erreurs fatales |
| âsend-logs-to-support | boolean | En cas d'Ă©chec de build en CI/CD, envoyez automatiquement les logs de build au support Capgo (aucun e-mail requis). Le support Capgo est notifiĂ© et assurera le suivi par e-mail. En complĂ©ment de âai-analytics. |
| âsend-logs | boolean | Alias obsolĂšte pour âsend-logs-to-support |
| -a | string | Clé API pour lier votre compte |
| âsupa-host | string | URL d'hĂŽte Supabase personnalisĂ©e (pour l'auto-hĂ©bergement ou le dĂ©veloppement Capgo) |
| âsupa-anon | string | ClĂ© anon Supabase personnalisĂ©e (pour l'auto-hĂ©bergement) |
| âverbose | boolean | Activer la sortie verbose avec des logs dĂ©taillĂ©s |
Cache de build : Par dĂ©faut, Capgo restaure et sauvegarde les artefacts natifs compilĂ©s (CocoaPods, Gradle et sorties associĂ©es) par application. Utilisez --cache-key pour sĂ©parer les caches RC et production ; utilisez --no-cache pour un build propre ponctuel. Les intĂ©grations API peuvent passer cache_key ou cache_enabled: false dans le payload de la requĂȘte de build. Voir Cache de build et DĂ©pannage : erreur de restauration du cache.
đč Sync-ios-version
Section intitulĂ©e « đč Sync-ios-version »npx @capgo/cli@latest build sync-ios-versionSynchronisez la MARKETING_VERSION iOS locale de Xcode depuis package.json.
Exemple :
npx @capgo/cli@latest build sync-ios-version --path .Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âchemin | string | Chemin du rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant) |
| âvĂ©rifier | boolean | VĂ©rifier uniquement ; quitter avec un code non nul si MARKETING_VERSION n'est pas synchronisĂ©e |
đč PrĂ©scan
Section intitulĂ©e « đč Prescan »npx @capgo/cli@latest build prescanScannez votre projet et vos identifiants enregistrĂ©s pour dĂ©tecter les problĂšmes qui feraient Ă©chouer un build cloud â avant d'envoyer quoi que ce soit.
Vérifie les identifiants (expiration, mots de passe, appairage de profil), l'état du projet (cap sync, structure de node_modules) et la configuration de la plateforme. S'exécute automatiquement dans build request; cette commande l'exécute de maniÚre autonome (ex. en CI).
Consultez Vérifications prescan pour le catalogue complet des vérifications et comment --skip / --warn les rÚgles individuelles.
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âplateforme | string | Plateforme cible : ios ou android (requis) |
| âchemin | string | Chemin du rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant) |
| -a | string | Clé API pour lier votre compte |
| âandroid-flavor | string | Android : product flavor utilisĂ© par le build |
| âios-dist | string | iOS : mode de distribution pour la validation |
| âjson | boolean | Afficher un rapport JSON lisible par machine |
| âfail-on-warnings | boolean | Sortir avec un code non nul en cas dâavertissements (CI) |
| âignore-fatal | boolean | Mode diagnostic : tout signaler mais toujours quitter avec le code 0 |
| âskip | string | Ignorer des vĂ©rifications spĂ©cifiques par id (rĂ©pĂ©table ou sĂ©parĂ©es par des virgules) |
| âwarn | string | RĂ©trograder des vĂ©rifications spĂ©cifiques en avertissement par id (rĂ©pĂ©table ou sĂ©parĂ©es par des virgules) |
| âverbose | boolean | Activer la sortie verbose avec des logs dĂ©taillĂ©s |
| âsupa-host | string | URL d'hĂŽte Supabase personnalisĂ©e (pour l'auto-hĂ©bergement ou le dĂ©veloppement Capgo) |
| âsupa-anon | string | ClĂ© anon Supabase personnalisĂ©e (pour l'auto-hĂ©bergement) |
đč DerniĂšre sortie
Section intitulĂ©e « đč Last-output »npx @capgo/cli@latest build last-outputLit lâenregistrement de sortie de build Ă©crit prĂ©cĂ©demment build request --output-record.
Affiche le JSON complet par dĂ©faut, un champ unique avec âfield, ou le QR code ASCII
code avec âqr. Pratique en CI pour rĂ©cupĂ©rer lâURL de tĂ©lĂ©chargement ou le QR code afin de le publier dans une PR ou une issue.
Exemples :
npx @capgo/cli build last-output âpath /tmp/build.json
npx @capgo/cli build last-output âpath /tmp/build.json âfield outputUrl
npx @capgo/cli build last-output âpath /tmp/build.json âqr
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âchemin | string | Chemin de l'enregistrement JSON Ă©crit par âoutput-record (requis) |
| âfield | string | Affiche un seul champ (parmi : jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âqr | boolean | Affiche le rendu ASCII du QR code (raccourci pour âfield qrCodeAscii) |
đč Identifiants
Section intitulĂ©e « đč Identifiants »GĂ©rez les identifiants de build stockĂ©s localement sur votre machine. đ SĂCURITĂ :
- Identifiants enregistrés dans ~/.capgo-credentials/credentials.json (global) ou .capgo-credentials.json (local)
- Envoyé à Capgo lors du build, mais jamais stocké de façon permanente
- Supprimé de Capgo immédiatement aprÚs le build
- Les outputs de build peuvent ĂȘtre uploadĂ©s pour gĂ©nĂ©rer des liens de tĂ©lĂ©chargement Ă durĂ©e limitĂ©e đ DOCUMENTATION : Configuration iOS : https://capgo.app/docs/cli/cloud-build/ios/ Configuration Android : https://capgo.app/docs/cli/cloud-build/android/
đč ClĂ© Apple
Section intitulĂ©e « đč ClĂ© Apple »Alias : asc-key
npx @capgo/cli@latest build credentials apple-keyCrĂ©ez une clĂ© API d'Ă©quipe App Store Connect avec un assistant macOS guidĂ© (macOS uniquement). Ouvre une fenĂȘtre native qui vous guide dans l'interface App Store Connect d'Apple via un navigateur intĂ©grĂ©, capture automatiquement l'Issuer ID et le Key ID, intercepte le .p8 Ă usage unique, le valide auprĂšs d'Apple et l'enregistre dans ~/.appstoreconnect/private_keys. Les statistiques de progression sont transmises aux analytics Capgo (dĂ©sactivable avec CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key âappId com.example.app
Exemple :
Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| -a | string | Clé API pour lier votre compte |
| âappId | string | Enregistre la clĂ© capturĂ©e dans les identifiants de build iOS de cette app |
| âlocal | boolean | Enregistrer dans le fichier .capgo-credentials.json du projet plutĂŽt que dans le fichier global |
| âjson | boolean | Afficher le Key ID / Issuer ID / chemin .p8 capturĂ©s au format JSON |
đč Enregistrer
Section intitulĂ©e « đč Save »npx @capgo/cli@latest build credentials saveEnregistrer les identifiants de build localement pour iOS ou Android. Les identifiants sont stockĂ©s dans :
- ~/.capgo-credentials/credentials.json (par défaut, global)
- .capgo-credentials.json Ă la racine du projet (avec l'option âlocal)
â ïž REQUIS AVANT LE BUILD : vous devez enregistrer vos identifiants avant de demander un build.
đ Ces identifiants ne sont JAMAIS stockĂ©s de maniĂšre permanente sur les serveurs de Capgo.
Ils sont supprimés immédiatement aprÚs la fin du build.
đ Guides de configuration :
iOS : https://capgo.app/docs/cli/cloud-build/ios/
Android : https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save â plateforme iOS
âcertificate ./cert.p12 âp12-password âpasswordâ
âios-provisioning-profile ./profile.mobileprovision
âapple-key ./AuthKey.p8 âapple-key-id âKEY123â
âapple-issuer-id âissuer-uuidâ âapple-team-id âteam-idâ Exemple multi-target (app + widget extension) : npx @capgo/cli build credentials save âplatform ios
âios-provisioning-profile ./App.mobileprovision
âios-provisioning-profile com.example.widget=./Widget.mobileprovision
⊠npx @capgo/cli build credentials save â plateforme Android
âkeystore ./release.keystore âkeystore-alias âmy-keyâ
âkeystore-key-password âkey-passâ
âplay-config ./service-account.json Stockage local (par projet) : npx @capgo/cli build credentials save âlocal âplatform ios âŠ
Exemple :
iOS Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | App ID (ex. : com.example.app) (requis) |
| âplateforme | string | Plateforme : ios ou android (requise) |
| âcertificate | string | iOS : chemin du fichier de certificat .p12 |
| âios-provisioning-profile | string | iOS : chemin du profil de provisionnement ou bundleId=chemin (rĂ©pĂ©table) |
| âp12-password | string | iOS : mot de passe du certificat (optionnel si le certificat n'en a pas) |
| âapple-key | string | iOS : chemin de la clĂ© API .p8 App Store Connect |
| âapple-key-id | string | iOS : ID de la clĂ© API d'App Store Connect |
| âapple-issuer-id | string | iOS : Issuer ID d'App Store Connect |
| âapple-team-id | string | iOS : Team ID App Store Connect |
| âios-distribution | string | iOS : Mode de distribution |
| âapple-id | string | iOS : e-mail Apple ID pour l'upload de mots de passe d'application (alternative Ă la clĂ© App Store Connect API) |
| âapple-app-specific-password | string | iOS : mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour l'upload sur TestFlight |
| âapple-app-id | string | iOS : ID numĂ©rique de l'app App Store Connect (requis avec âapple-id et âapple-app-specific-password) |
| âkeystore | string | Android : Chemin du fichier keystore (.keystore ou .jks) |
| âkeystore-alias | string | Android : alias de la clĂ© keystore |
| âkeystore-key-password | string | Android : mot de passe de la clĂ© keystore |
| âkeystore-store-password | string | Android : mot de passe du keystore |
| âplay-config | string | Android : chemin vers le fichier JSON du compte de service Play Store |
| âandroid-flavor | string | Android : product flavor Ă compiler (ex : production). Obligatoire si votre projet a plusieurs flavors. |
| âin-app-update-priority | string | Android : prioritĂ© de mise Ă jour in-app Google Play pour les futures releases (entier 0â5 ; plus Ă©levĂ© = plus urgent). Omettez pour conserver la valeur actuelle de Play. |
| âlocal | boolean | Enregistrer dans .capgo-credentials.json Ă la racine du projet plutĂŽt que dans ~/.capgo-credentials/ global |
| âoutput-upload | boolean | Envoyer les sorties de build (IPA/APK/AAB) vers le stockage Capgo et afficher les liens de tĂ©lĂ©chargement |
| âno-output-upload | boolean | Ne pas envoyer les artefacts de build (IPA/APK/AAB) vers le stockage Capgo |
| âoutput-retention | string | DurĂ©e de validitĂ© du lien de sortie : de 1h Ă 7j (par dĂ©faut : 1h). Exemples : 1h, 6h, 2j |
| âskip-build-number-bump | boolean | Ignorer lâincrĂ©mentation automatique du numĂ©ro de build/version code lors des prochains builds |
| âno-skip-build-number-bump | boolean | RĂ©activer lâincrĂ©mentation automatique du numĂ©ro de build (comportement par dĂ©faut) |
| âskip-marketing-version-bump | boolean | Ignorer lâincrĂ©mentation automatique de la version marketing lors des prochains builds si lâapplication est dĂ©jĂ publiĂ©e |
| âno-skip-marketing-version-bump | boolean | RĂ©activer l'incrĂ©mentation automatique de la version marketing (comportement par dĂ©faut) |
đ Liste
Section intitulĂ©e « đ Liste »npx @capgo/cli@latest build credentials listListe les identifiants de build enregistrĂ©s (mots de passe masquĂ©s). Affiche les identifiants actuellement enregistrĂ©s (globaux et locaux). Exemples : npx @capgo/cli build credentials list # Lister toutes les apps npx @capgo/cli build credentials list âappId com.example.app # Lister une app spĂ©cifique
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID de l'app Ă lister (facultatif, liste tout si omis) |
| âlocal | boolean | Lister les credentials uniquement depuis le fichier local .capgo-credentials.json |
đč Effacer
Section intitulĂ©e « đč Clear »npx @capgo/cli@latest build credentials clearEffacer les credentials de build enregistrĂ©s. Supprimer les credentials du stockage. Utiliser âappId et âplatform pour cibler des credentials spĂ©cifiques. Exemples : npx @capgo/cli build credentials clear # Effacer toutes les apps (global) npx @capgo/cli build credentials clear âlocal # Effacer les credentials locaux npx @capgo/cli build credentials clear âappId com.example.app âplatform ios
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID de l'app Ă effacer (facultatif, efface toutes les apps si omis) |
| âplateforme | string | Plateforme Ă effacer : ios ou android (facultatif, efface toutes les plateformes si omise) |
| âlocal | boolean | Supprimer du fichier local .capgo-credentials.json au lieu du fichier global |
đč Mise Ă jour
Section intitulĂ©e « đč Update »npx @capgo/cli@latest build credentials updateMettez Ă jour des identifiants spĂ©cifiques sans avoir Ă les fournir tous Ă nouveau. Mettez Ă jour les identifiants existants en ne fournissant que les champs que vous souhaitez modifier. La plateforme est dĂ©tectĂ©e automatiquement Ă partir des options fournies. Exemples : npx @capgo/cli build credentials update âios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update âlocal âkeystore ./new-keystore.jks
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | App ID (dĂ©tectĂ© automatiquement depuis capacitor.config si omis) |
| âplateforme | string | Plateforme : ios ou android (dĂ©tection automatique Ă partir des options) |
| âlocal | boolean | Mettre Ă jour le fichier local .capgo-credentials.json au lieu du fichier global |
| âcertificate | string | Chemin du fichier de certificat P12 |
| âios-provisioning-profile | string | Chemin du profil de provisionnement ou bundleId=path (rĂ©pĂ©table, additif par dĂ©faut) |
| âoverwrite-ios-provisioning-map | boolean | Remplace tout le mapping de provisionnement au lieu de le fusionner (par dĂ©faut : fusion) |
| âp12-password | string | Mot de passe du certificat P12 |
| âapple-key | string | Chemin vers la clĂ© API d'App Store Connect (fichier .p8) |
| âapple-key-id | string | ID de la clĂ© API App Store Connect |
| âapple-issuer-id | string | Issuer ID App Store Connect |
| âapple-team-id | string | ID d'Ă©quipe App Store Connect |
| âapple-id | string | iOS : e-mail Apple ID pour l'upload de mots de passe d'application (alternative Ă la clĂ© App Store Connect API) |
| âapple-app-specific-password | string | iOS : mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour l'upload sur TestFlight |
| âapple-app-id | string | iOS : ID numĂ©rique de l'app App Store Connect (requis avec âapple-id et âapple-app-specific-password) |
| âios-distribution | string | iOS : Mode de distribution |
| âkeystore | string | Chemin vers le fichier keystore (.keystore ou .jks) |
| âkeystore-alias | string | Alias de clĂ© Keystore |
| âkeystore-key-password | string | Mot de passe de la clĂ© keystore |
| âkeystore-store-password | string | Mot de passe du store Keystore |
| âplay-config | string | Chemin du fichier JSON du compte de service Google Play |
| âandroid-flavor | string | Android : product flavor Ă compiler (ex : production). Obligatoire si votre projet a plusieurs flavors. |
| âin-app-update-priority | string | Android : prioritĂ© de mise Ă jour in-app Google Play pour les prochaines releases (entier 0â5 ; plus Ă©levĂ© = plus urgent). |
| âoutput-upload | boolean | Envoyer les sorties de build (IPA/APK/AAB) vers le stockage Capgo et afficher les liens de tĂ©lĂ©chargement |
| âno-output-upload | boolean | Ne pas envoyer les artefacts de build (IPA/APK/AAB) vers le stockage Capgo |
| âoutput-retention | string | TTL des liens de sortie : de 1h Ă 7j. Exemples : 1h, 6h, 2j |
| âskip-build-number-bump | boolean | Ignorer lâincrĂ©mentation automatique du numĂ©ro de build/version code lors des prochains builds |
| âno-skip-build-number-bump | boolean | RĂ©activer lâincrĂ©mentation automatique du numĂ©ro de build (comportement par dĂ©faut) |
| âskip-marketing-version-bump | boolean | Ignorer lâincrĂ©mentation automatique de la version marketing lors des prochains builds si lâapplication est dĂ©jĂ publiĂ©e |
| âno-skip-marketing-version-bump | boolean | RĂ©activer l'incrĂ©mentation automatique de la version marketing (comportement par dĂ©faut) |
đč GĂ©rer
Section intitulĂ©e « đč GĂ©rer »npx @capgo/cli@latest build credentials manageGĂ©rez de maniĂšre interactive vos identifiants de build enregistrĂ©s.
Parcourez les identifiants stockĂ©s, consultez ce qui est configurĂ©, exportez un fichier .env prĂȘt pour la CI/CD, ou supprimez les identifiants d'une plateforme. S'appuie sur la mĂȘme TUI que capgo init.
Exemples :
npx @capgo/cli build credentials manage
npx @capgo/cli build credentials manage âappId com.example.app
npx @capgo/cli build credentials manage âappId com.example.app âplatform ios
npx @capgo/cli build credentials manage âlocal
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID de lâapp Ă gĂ©rer (facultatif, invite Ă choisir si omis) |
| âplateforme | string | Plateforme Ă gĂ©rer : ios ou android (facultatif, invite Ă choisir si omis) |
| âlocal | boolean | Ne parcourir que le fichier local .capgo-credentials.json |
đč Migrer
Section intitulĂ©e « đč Migrate »npx @capgo/cli@latest build credentials migrateMigrer un profil de provisionnement legacy vers le nouveau format multi-cibles. Convertit BUILD_PROVISION_PROFILE_BASE64 en CAPGO_IOS_PROVISIONING_MAP. DĂ©couvre automatiquement lâID de bundle principal depuis votre projet Xcode. npx @capgo/cli build credentials migrate âplatform ios
Exemple :
Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | App ID (dĂ©tectĂ© automatiquement depuis capacitor.config si omis) |
| âplateforme | string | Plateforme (seul iOS est pris en charge) |
| âlocal | boolean | Migrez du fichier local .capgo-credentials.json au mode global |