đč build
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
đïž GĂ©rez vos builds natifs iOS/Android via le cloud Capgo.
AccĂšs au build et sortie
Section intitulĂ©e « AccĂšs au build et sortie »Les builds cloud natifs sont disponibles sur chaque plan Capgo. Les identifiants de build ne sont jamais stockĂ©s sur les serveurs Capgo : ils sont uniquement utilisĂ©s pour le build, puis supprimĂ©s. Les sorties de build peuvent optionnellement ĂȘtre envoyĂ©es avec des liens de tĂ©lĂ©chargement Ă durĂ©e limitĂ©e.
Enregistrez d'abord vos identifiants
Section intitulée « Sauvegardez 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 dans la CI »Passer --output-record pour persister l'URL de téléchargement et le QR code, puis utilisez 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đč Requis
Section intitulĂ©e « đč Requis »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. En cas d'Ă©chec de la commande, quitte 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 de comparaison. Par défaut : CapacitorUpdater.defaultChannel ou le canal public par défaut |
| âpackage-json | string | Chemins vers les 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) |
đ Init
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 requestDemandez un build natif depuis le cloud Capgo. Cette commande va zipper le rĂ©pertoire de votre projet et l'envoyer sur Capgo pour le build. Le build sera traitĂ© et envoyĂ© directement sur les stores. Les identifiants ne sont jamais stockĂ©s sur les serveurs de Capgo ; ils sont supprimĂ©s aprĂšs le build. Enregistrez-les avant de lancer 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 |
|---|---|---|
| âpath | 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) |
| âplatform | 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Ă© App Store Connect API encodĂ©e en Base64 (.p8) |
| âapp-store-connect-team-id | string | iOS : Team ID App Store Connect |
| âios-scheme | string | iOS : scheme Xcode Ă compiler (par dĂ©faut : App) |
| âios-target | string | iOS : cible Xcode pour lire les paramĂštres de build (par dĂ©faut : identique au scheme) |
| â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 > env (CAPGO_IOS_XCODE_VERSION) > identifiants sauvegardĂ©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). Requis si votre projet possĂšde 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 | Ignore l'upload sur le Play Store pour ce build (rĂ©initialise la config Play enregistrĂ©e). NĂ©cessite âoutput-upload. |
| âsubmit-to-store-review | boolean | AprĂšs l'upload, soumettez la release au store pour examen au lieu de la laisser en brouillon ou en build inactif. Sur Android, cela cible par dĂ©faut le canal de production avec un release_status « completed » (utilisez âandroid-track / PLAY_STORE_TRACK et âandroid-release-status / PLAY_STORE_RELEASE_STATUS pour modifier cela). Sur iOS, cela soumet le build TestFlight traitĂ© pour examen sur l'App Store. |
| âstore-release-name | string | Nom ou label de version de la release sur le store. Android l'envoie comme le version_name de Google Play ; iOS l'utilise comme version de l'App Store lors de la crĂ©ation ou de la rĂ©utilisation d'une version Ă©ditable. |
| âstore-release-notes | string | Notes de release par dĂ©faut pour le store. Android l'utilise comme changelog Play Store ; iOS l'utilise comme texte de secours pour la section « NouveautĂ©s » de l'App Store. |
| âstore-release-notes-locale | string | Notes de release 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 IDs de groupes TestFlight externes, sĂ©parĂ©s par des virgules, pour la distribution bĂȘta externe. |
| âios-automatic-release | boolean | iOS : publie automatiquement la version App Store aprĂšs l'approbation d'Apple. Par dĂ©faut, la release est manuelle. |
| âno-ios-automatic-release | boolean | iOS : conservez la version de l'App Store en attente d'une release manuelle aprĂšs l'approbation d'Apple. |
| âoutput-upload | boolean | Remplace le comportement d'upload de l'output pour ce build uniquement (activer). PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âno-output-upload | boolean | Remplace le comportement d'upload de l'output pour ce build uniquement (dĂ©sactiver). PrioritĂ© : CLI > env > identifiants enregistrĂ©s |
| âoutput-retention | string | Remplace le TTL du lien d'output pour ce build uniquement (1h Ă 7j). Exemples : 1h, 6h, 2d. 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) dans un chemin. Un QR code PNG code est Ă©galement Ă©crit Ă cĂŽtĂ© de ce chemin avec le .qr.png suffixe. RĂ©cupĂ©rez 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 un diagnostic. Dans un terminal interactif, cela Ă©vite la confirmation initiale ; en CI, cela effectue l'upload automatique et affiche l'analyse dans stderr. |
| âno-prescan | boolean | Ignorer le scan automatique avant le build |
| âprescan-ignore-fatal | boolean | ExĂ©cuter le scan avant le build sans jamais bloquer le build (mode rapport uniquement) |
| âprescan-skip | string | Ignorez certains contrĂŽles de prescan par leur ID (rĂ©pĂ©tables ou sĂ©parĂ©s par des virgules). Les autres contrĂŽles s'exĂ©cutent toujours. |
| âprescan-warn | string | Passer certains contrĂŽles de prescan en avertissement par ID (rĂ©pĂ©table ou sĂ©parĂ© par des virgules). Le contrĂŽlâest toujours exĂ©cutĂ©. |
| âfail-on-warnings | boolean | ConsidĂ©rer les avertissements de prescan comme fatals |
| â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-versionSynchronise la version MARKETING_VERSION de Xcode iOS locale depuis le package.json.
Exemple :
npx @capgo/cli@latest build sync-ios-version --path .Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âpath | string | Chemin du rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant) |
| âcheck | boolean | VĂ©rification simple ; sortie non nulle si la version MARKETING_VERSION est dĂ©synchronisĂ©e |
đč Prescan
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 node_modules) et la config 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 | GĂ©nĂ©rer un rapport JSON lisible par une machine |
| âfail-on-warnings | boolean | Quitter avec un code d'erreur si des warnings sont trouvĂ©s (CI) |
| âignore-fatal | boolean | Mode diagnostic : tout rapporter mais toujours quitter avec le code 0 |
| âskip | string | Ignorer une ou plusieurs vĂ©rifications par ID (rĂ©pĂ©table ou sĂ©parĂ© par des virgules) |
| âwarn | string | Passer certaines vĂ©rifications en avertissement par ID (rĂ©pĂ©table ou sĂ©parĂ© 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) |
đč Last-output
Section intitulĂ©e « đč Last-output »npx @capgo/cli@latest build last-outputLit l'enregistrement de sortie du build Ă©crit par une commande prĂ©cĂ©dente build request --output-record.
Prints the full JSON by default, a single field with âfield, or the ASCII QR
code with âqr. Useful in CI to grab the download URL or QR for posting back
to a PR or issue.
Examples:
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 |
|---|---|---|
| âpath | string | Chemin vers le fichier JSON gĂ©nĂ©rĂ© par âoutput-record (requis) |
| âfield | string | Affiche un champ spĂ©cifique (parmi : jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âqr | boolean | Affiche le QR code code en ASCII (raccourci pour âfield qrCodeAscii) |
đč Credentials
Section intitulĂ©e « đč Credentials »GĂ©rez les credentials de build stockĂ©s localement sur votre machine. đ SĂCURITĂ :
- Credentials enregistrés dans ~/.capgo-credentials/credentials.json (global) ou .capgo-credentials.json (local)
- Lors du build, envoyé à Capgo mais JAMAIS stocké de façon permanente
- Supprimé de Capgo immédiatement aprÚs le build
- Les outputs du build peuvent ĂȘtre uploadĂ©s pour gĂ©nĂ©rer des liens de tĂ©lĂ©chargement temporaires đ DOCUMENTATION : Configuration iOS : https://capgo.app/docs/cli/cloud-build/ios/ Configuration Android : https://capgo.app/docs/cli/cloud-build/android/
đč Apple-key
Section intitulĂ©e « đč Apple-key »Alias : asc-key
npx @capgo/cli@latest build credentials apple-keyCrĂ©ez une clĂ© d'Ă©quipe App Store Connect API avec un assistant macOS (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 + Key ID, intercepte le fichier .p8 unique, le valide auprĂšs d'Apple et l'enregistre dans ~/.appstoreconnect/private_keys. Les statistiques de progression sont envoyĂ©es aux analytics de Capgo (dĂ©sactivez 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 | Affiche l'ID de clĂ© / l'ID d'Ă©metteur / le chemin .p8 capturĂ©s au format JSON |
đč Enregistrer
Section intitulĂ©e « đč Save »npx @capgo/cli@latest build credentials saveEnregistrer les credentials de build localement pour iOS ou Android. Les credentials sont stockĂ©s dans :
- ~/.capgo-credentials/credentials.json (par défaut, global)
- .capgo-credentials.json Ă la racine du projet (avec le flag âlocal)
â ïž REQUIS AVANT LE BUILD : Vous devez enregistrer les credentials avant de demander un build.
đ Ces credentials ne sont JAMAIS stockĂ©s de façon 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 | ID de l'app (ex: com.example.app) (requis) |
| âplatform | string | Plateforme : ios ou android (requis) |
| âcertificate | string | iOS : chemin vers le fichier de certificat .p12 |
| âios-provisioning-profile | string | iOS : chemin du profil de provisionnement ou bundleId=path (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 vers la clĂ© API .p8 d'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 vers le 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 JSON du compte de service Play Store |
| âandroid-flavor | string | Android : product flavor Ă compiler (ex: production). Requis si votre projet possĂšde plusieurs flavors. |
| âin-app-update-priority | string | Android : prioritĂ© de la mise Ă jour in-app Google Play pour les futures releases (entier 0â5 ; plus Ă©levĂ© = plus urgent). Omettez pour ne pas modifier la valeur actuelle de Play. |
| âlocal | boolean | Enregistrer dans .capgo-credentials.json Ă la racine du projet au lieu de ~/.capgo-credentials/ global |
| âoutput-upload | boolean | Envoyez les builds (IPA/APK/AAB) vers le stockage Capgo et affichez les liens de tĂ©lĂ©chargement |
| âno-output-upload | boolean | Ne pas envoyer les outputs du build (IPA/APK/AAB) vers le stockage Capgo |
| âoutput-retention | string | TTL du lien de sortie : 1h Ă 7j (par dĂ©faut : 1h). Exemples : 1h, 6h, 2d |
| âskip-build-number-bump | boolean | Ignorer l'incrĂ©mentation automatique du numĂ©ro de build/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 (optionnel, liste tout si omis) |
| âlocal | boolean | Liste les credentials uniquement depuis le fichier local .capgo-credentials.json |
đč Effacer
Section intitulĂ©e « đč Clear »npx @capgo/cli@latest build credentials clearEfface les credentials de build sauvegardĂ©s. Supprime les credentials du stockage. Utilisez â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 (optionnel, efface toutes les apps si omis) |
| âplatform | string | Plateforme Ă effacer : ios ou android (optionnel, efface toutes les plateformes si omis) |
| âlocal | boolean | Effacer depuis le fichier local .capgo-credentials.json au lieu du global |
đč Mise Ă jour
Section intitulĂ©e « đč Update »npx @capgo/cli@latest build credentials updateMettez Ă jour des credentials spĂ©cifiques sans avoir Ă tous les fournir Ă nouveau. Modifiez les credentials existants en ne fournissant que les champs Ă changer. La plateforme est dĂ©tectĂ©e automatiquement selon les 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 | ID de l'app (dĂ©tectĂ© automatiquement depuis capacitor.config si omis) |
| âplatform | string | Plateforme : ios ou android (dĂ©tectĂ©e automatiquement selon les options) |
| âlocal | boolean | Mettre Ă jour le fichier .capgo-credentials.json local au lieu du global |
| âcertificate | string | Chemin vers le 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 distribution |
| âkeystore | string | Chemin vers le fichier keystore (.keystore ou .jks) |
| âkeystore-alias | string | Alias de la 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 vers le JSON du compte de service Google Play |
| âandroid-flavor | string | Android : Product flavor Ă compiler (ex: production). Requis si votre projet possĂšde plusieurs flavors. |
| âin-app-update-priority | string | Android : PrioritĂ© de la mise Ă jour in-app Google Play pour les futures releases (entier 0â5 ; plus Ă©levĂ© = plus urgent). |
| âoutput-upload | boolean | Envoyez les builds (IPA/APK/AAB) vers le stockage Capgo et affichez les liens de tĂ©lĂ©chargement |
| âno-output-upload | boolean | Ne pas envoyer les outputs de build (IPA/APK/AAB) vers le stockage Capgo |
| âoutput-retention | string | TTL du lien de sortie : de 1h Ă 7j. Exemples : 1h, 6h, 2d |
| âskip-build-number-bump | boolean | Ignorer l'incrĂ©mentation automatique du numĂ©ro de build/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'app est dĂ©jĂ publiĂ©e |
| âno-skip-marketing-version-bump | boolean | RĂ©active 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 la configuration, exportez un fichier .env prĂȘt pour la CI/CD, ou supprimez les identifiants d'une plateforme. Utilise 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 (optionnel, un prompt s'affiche si omis) |
| âplatform | string | Plateforme Ă gĂ©rer : ios ou android (optionnel, un prompt s'affiche si omis) |
| âlocal | boolean | Parcourir uniquement le fichier local .capgo-credentials.json |
đč Migrer
Section intitulĂ©e « đč Migrer »npx @capgo/cli@latest build credentials migrateMigrez l'ancien profil de provisionnement vers le nouveau format multi-cibles. Convertit BUILD_PROVISION_PROFILE_BASE64 en CAPGO_IOS_PROVISIONING_MAP. DĂ©tecte automatiquement le bundle ID principal de 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) |
| âplatform | string | Plateforme (seul ios est supportĂ©) |
| âlocal | boolean | Migrer depuis le fichier local .capgo-credentials.json au lieu du global |