đč Construire
Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.
đïž Manage native iOS/Android builds through Capgo Cloud.
AccĂšs et sortie de build
Section intitulée « AccÚs et sortie de build »Native cloud build requests are currently in limited beta and access is restricted. Build credentials are never stored on Capgo servers: they are used only for the build and then deleted. Build outputs can optionally be uploaded with time-limited download links.
Enregistrez les informations de connexion avant de continuer
Section intitulée « Enregistrez les informations de connexion avant de continuer »npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidCapturer l'URL de sortie dans CI
Section intitulée « Capturer l'URL de sortie dans CI »Passer --output-record pour persister 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đ§ Print âyesâ and exit with code 1 if a native build is required; otherwise print ânoâ and exit with code 0. Command failures exit with code 2.
Exemple :
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOptions :
| ParamĂštre | Type | Description |
|---|---|---|
| -a | string | Clé API pour se connecter à votre compte |
| -c | string | Canal à comparer avec. Par défaut, il s'agit de CapacitorUpdater.defaultChannel ou du 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 vers les rĂ©pertoires node_modules pour les monorepos (sĂ©parĂ©s par des virgules) |
| âverbose | boolean | Activer l'affichage dĂ©taillĂ© avec des journaux de dĂ©bogage |
| âsupa-host | string | URL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ© ou le dĂ©veloppement Capgo) |
| âsupa-anon | string | ClĂ© anonyme Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ©) |
đ Init
Section intitulĂ©e â LancementâAlias : onboarding
npx @capgo/cli@latest build initConfigurer les informations de build interactivement (iOS : certificats + profils automatisés ; Android : clé de magasin + Google OAuth fournit un compte de service GCP et invite la console Google Play)
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| -a | string | Clé API pour se connecter à votre compte |
| -p | string | Plateforme pour l'inscription (ios ou android). Si omis, détecte automatiquement lorsqu'il n'y a qu'un seul dossier natif ; sinon, demande confirmation. |
| âhĂŽte-supabase | string | URL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement autonome ou le dĂ©veloppement Capgo) |
| âpas-d'analytique | boolean | DĂ©sactiver l'analyse de build et la retranscription du terminal pour cette exĂ©cution |
đč Demander
Section intitulée « Demander »npx @capgo/cli@latest build requestDemandez une build native à partir de Capgo Cloud. Cette commande compressera votre répertoire de projet et l'uploadera à Capgo pour la construction. La build sera traitée et envoyée directement aux magasins d'applications. Les identifiants ne sont jamais stockés sur les serveurs Capgo ; ils sont supprimés aprÚs la build. Enregistrez-les avant de demander une 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 de projet Ă construire (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 (obligatoire) |
| âmode de construction | string | Mode de construction : 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 (facultatif si le certificat n'a pas de mot de passe) |
| âapple-id | string | iOS : Adresse e-mail Apple pour les tĂ©lĂ©chargements de mot de passe d'application (alternative Ă la clĂ© App Store Connect API) |
| âapple-app-specific-password | string | iOS : Mot de passe d'application spĂ©cifique (xxxx-xxxx-xxxx-xxxx) pour les tĂ©lĂ©chargements de 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: Base64-encoded App Store Connect API key (.p8) |
| âapp-store-connect-team-id | string | iOS : Identifiant de l'Ă©quipe App Store Connect |
| âios-scheme | string | iOS : SchĂ©ma Xcode Ă construire (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 | Mode de distribution iOS |
| âios-provisioning-profile | string | iOS : chemin du profil de provisionnement ou bundleId=path de correspondance (rĂ©pĂ©table) |
| âandroid-keystore-file | string | Android : fichier de clĂ© de stockage encodĂ© en Base64 |
| âkeystore-key-alias | string | Android : alias de la clĂ© de stockage |
| âkeystore-key-password | string | Android : mot de passe de la clĂ© de stockage |
| âkeystore-store-password | string | Android : Mot de passe de magasin de clĂ©s |
| âconfig.json de build | string | Android : Compte JSON de service Google Play encodĂ© en Base64 |
| âsaveur d'Android | string | Android : Saveur de produit Ă construire (par exemple, production). Obligatoire si votre projet a plusieurs saveurs. |
| âpiste d'Android | string | Android : Piste Google Play pour cette mise Ă jour (intĂ©rieure, alpha, bĂȘta, production). Par dĂ©faut sans âsoumettre Ă la revue de la boutique : intĂ©rieure. Avec âsoumettre Ă la revue de la boutique et sans piste dĂ©finie : production. PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| âĂ©tat de publication d'Android | string | Android : Ătat de publication Google Play (brouillon, terminĂ©, en cours de progression, arrĂȘtĂ©). Par dĂ©faut sans âsoumettre Ă la revue de la boutique : brouillon. Avec âsoumettre Ă la revue de la boutique et sans Ă©tat dĂ©fini : terminĂ©. PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| âprioritĂ© de mise Ă jour en application | string | Android : PrioritĂ© de mise Ă jour en application Google Play pour cette publication (entier 0â5 ; plus Ă©levĂ© = plus urgent). Voir https://developer.android.com/guide/playcore/in-app-updates. PrĂ©cedence : CLI > env > informations de connexion sauvegardĂ©es |
| âne-pas-telecharger-sur-play-store | boolean | Omettre la tĂ©lĂ©chargement sur Play Store pour cette build (annule la configuration de Play sauvegardĂ©e). Exige âoutput-upload. |
| âsoumettre-au-contrĂŽle-de-la-magasin | boolean | AprĂšs tĂ©lĂ©chargement, soumettre la mise Ă jour de la magasin pour examen au lieu de la laisser en tant que brouillon/Ă©dition inactive. Sur Android, cela par dĂ©faut utilise la piste de production avec le statut de mise Ă jour terminĂ© (surmonter avec âandroid-track / PLAY_STORE_TRACK et âandroid-release-status / PLAY_STORE_RELEASE_STATUS). Sur iOS, cela soumet la build TestFlight traitĂ©e Ă la revue de l'App Store. |
| ânom-de-mise-Ă -jour-de-la-magasin | string | Nom/Ă©tiquette de version de la mise Ă jour de la magasin. Android envoie cela comme la version_name de Google Play ; iOS l'utilise comme la version lors de la crĂ©ation ou de la rĂ©utilisation de la version Ă©ditible. |
| ânotes-de-mise-Ă -jour-de-la-magasin | string | Notes de mise Ă jour de la magasin par dĂ©faut. Android utilise cela comme le journal des changements de Play ; iOS l'utilise comme le texte « Qu'est-ce de neuf » de l'App Store par dĂ©faut. |
| ânotes-de-mise-Ă -jour-de-la-magasin-locale | string | Notes de mise Ă jour de la magasin localisĂ©es (rĂ©pĂ©tables), par exemple ânotes-de-mise-Ă -jour-de-la-magasin-locale fr-FR=âCorrectionsâ. |
| âgroupes-de-testflight-ios | string | iOS : groupes ou identifiants externes de TestFlight sĂ©parĂ©s par des virgules facultatifs ou des ID pour la distribution bĂȘta externe. |
| âios-automatic-release | boolean | iOS : lancer automatiquement la version de l'App Store aprĂšs l'approbation d'Apple. La valeur par dĂ©faut est une mise en ligne manuelle. |
| âno-ios-automatic-release | boolean | iOS : garder la version de l'App Store en attente d'une mise en ligne manuelle aprĂšs l'approbation d'Apple. |
| âoutput-upload | boolean | Activer la prise en charge de l'upload de sortie pour cette build uniquement (activer). PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s |
| âno-output-upload | boolean | DĂ©sactiver la prise en charge de l'upload de sortie pour cette build uniquement (dĂ©sactiver). PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s |
| âoutput-retention | string | Activer la prise en charge de la durĂ©e de vie de la liaison de sortie pour cette build uniquement (1h Ă 7j). Exemples : 1h, 6h, 2j. PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s |
| âoutput-record | string | After un build rĂ©ussi, Ă©crivez un enregistrement JSON (jobId, statut, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) Ă un chemin. Un PNG QR code est Ă©galement Ă©crit Ă cĂŽtĂ© de ce chemin avec le .qr.png Lisez les champs Ă nouveau avec build last-output. |
| Supprimez le numéro de build incrémental enregistré pour permettre l'incrémentation automatique de ce build uniquement. | boolean | Supprimez l'incrémentation automatique de la version de marketing (CFBundleShortVersionString / versionName) lorsque l'application est déjà publiée. |
| iOS : synchronisez la version MARKETING_VERSION de Xcode à partir de package.json avant de télécharger le projet. | boolean | En cas d'erreur de build, envoyez les journaux à __CAPGO_KEEP_0__ AI pour le diagnostic. Dans les terminaux interactifs, cela saute la confirmation préalable ; dans CI, cela télécharge automatiquement et imprime l'analyse à stderr. |
| Omettez l'analyse préalable automatique avant le build | boolean | Omettez l'analyse préalable automatique avant le build |
| Omettez l'analyse préalable automatique avant le build | boolean | On build failure, send logs to Capgo AI for diagnosis. In interactive terminals this skips the upfront confirmation; in CI this auto-uploads and prints the analysis to stderr. |
| Omettez l'analyse préalable automatique avant le build | boolean | Omettez l'analyse préalable automatique avant le build |
| ---ignore-fatal | boolean | Exécutez l'analyse pré-build mais ne bloquez jamais la construction (rapport uniquement) |
| ---skip | string | Omettre spécifiquement les vérifications d'analyse pré-build par ID (répétitives ou séparées par virgule). Les autres vérifications s'exécutent toujours. |
| ---warn | string | Réduire les vérifications d'analyse pré-build spécifiques à un avertissement par ID (répétitives ou séparées par virgule). La vérification s'exécute toujours. |
| ---fail-on-warnings | boolean | Considérer les avertissements d'analyse pré-build comme des erreurs fatales |
| ---envoyer-les-journaux-au-support | boolean | Ă une Ă©chec de construction CI/CD, tĂ©lĂ©chargez automatiquement les journaux de construction vers Capgo support (aucun email requis). Capgo support est notifiĂ© et suivra par email. Ajoutatif Ă âai-analytics. |
| ---envoyer-les-journaux | boolean | Alias obsolĂšte pour âenvoyer-les-journaux-au-support |
| -a | string | API clé pour se connecter à votre compte |
| âsupa-host | string | URL de l'hĂŽte Supabase personnalisĂ© (pour l'hĂ©bergement autonome ou le Capgo dĂ©veloppement) |
| â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 |
đč Synchronisation de la version iOS
FenĂȘtre de terminalnpx @capgo/cli@latest build sync-ios-versionSyncronisez la version MARKETING_XCODE locale iOS Xcode Ă partir de 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Ă©rifiez uniquement ; sortez avec un code non nul lorsque MARKETING_VERSION est hors synchronisation |
đč PrĂ©scanner
Section intitulĂ©e â đč PrĂ©scannerânpx @capgo/cli@latest build prescanVĂ©rifiez votre projet et vos informations d'identification enregistrĂ©es pour les problĂšmes qui empĂȘcheraient une construction cloud â avant de tĂ©lĂ©charger quoi que ce soit.
Vérifie les informations d'identification (expiration, mots de passe, association de profil), l'état du projet (cap sync, organisation de node_modules) et la configuration de la plateforme. Exécuté automatiquement à l'intérieur build request; cette commande l'exécute en mode standalone (par exemple, dans CI).
Voir Le préscanner vérifie pour le catalogue complet des vérifications et comment --skip / --warn comment configurer individuellement les rÚgles.
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âplateforme | string | Plateforme cible : ios ou android (obligatoire) |
| âchemin | string | Chemin vers le rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant) |
| -a | string | API clé pour se connecter à votre compte |
| âflavor-android | string | Android : nom de la variante de produit Ă utiliser pour la construction |
| âmode-distribution-ios | string | iOS : mode de distribution pour valider contre |
| âjson | boolean | Affiche un rapport JSON lisible par machine |
| âfail-on-warnings | boolean | Sortir avec un code non nul lorsque des avertissements sont trouvĂ©s (CI) |
| âignore-fatal | boolean | Mode diagnostic : rapporter tout mais sortir toujours avec 0 |
| âskip | string | Ignorer spĂ©cifique vĂ©rification(s) par id (rĂ©pĂ©table ou sĂ©parĂ© par virgule) |
| âwarn | string | RĂ©duire spĂ©cifique vĂ©rification(s) Ă un avertissement par id (rĂ©pĂ©table ou sĂ©parĂ© par virgule) |
| âverbose | boolean | Activer l'affichage dĂ©taillĂ© avec des journaux dĂ©taillĂ©s |
| âsupa-host | string | URL de l'hĂŽte Supabase personnalisĂ© (pour l'hĂ©bergement auto-hĂ©bergĂ© ou le dĂ©veloppement Capgo) |
| â supa-anon | string | ClĂ© anonyme Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ©) |
đč Dernier rĂ©sultat
Section intitulée « Dernier résultat »npx @capgo/cli@latest build last-outputLire l'enregistrement de sortie de construction écrit par un __CAPGO_KEEP_0__ précédent build request --output-record.
Affiche la sortie JSON complĂšte par dĂ©faut, un champ unique avec âfield, ou le QR ASCII
code avec âqr. Utile dans CI pour rĂ©cupĂ©rer l'URL de tĂ©lĂ©chargement ou le QR pour le rĂ©afficher
sur un PR ou un problĂšme.
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 vers le fichier JSON gĂ©nĂ©rĂ© par âoutput-record (obligatoire) |
| âchamp | string | Affiche un seul champ (l'un des: jobId, appId, plateforme, modeDeConstruction, statut, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âqr | boolean | Print the rendered ASCII QR code (shortcut for âfield qrCodeAscii) |
đč Credentials
Section intitulĂ©e « đč Identifiants »GĂ©rer les identifiants de construction stockĂ©s localement sur votre machine. đ SĂCURITĂ :
- Les identifiants enregistrés dans ~/.capgo-identifiants/identifiants.json (global) ou .capgo-identifiants.json (local)
- Lors de la construction, envoyés à Capgo mais N'EN PAS ENREGISTREMENT PERMANENT
- Supprimé de Capgo immédiatement aprÚs la construction
- Les sorties de construction peuvent ĂȘtre chargĂ©es optionnellement pour des liens de tĂ©lĂ©chargement Ă temps limitĂ© đ DOCUMENTATION: iOS configuration : 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Ă© d'Ă©quipe App Store Connect API avec l'aide d'un assistant macOS guidĂ© (macOS uniquement). Ouvre une fenĂȘtre native qui vous guide Ă travers l'interface utilisateur d'Apple App Store Connect dans un navigateur intĂ©grĂ©, capte automatiquement l'ID d'Ă©metteur + ID de clĂ©, intercepte le fichier .p8 unique, le valide contre Apple et le sauvegarde dans ~/.appstoreconnect/private_keys. Les statistiques de progression sont transmises Ă Capgo analytics (dĂ©sactivez-les 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 se connecter à votre compte |
| âappId | string | Enregistrer la clĂ© capturĂ©e dans les informations de build iOS de cette application |
| âlocal | boolean | Enregistrer dans le fichier .capgo-credentials.json par projet au lieu du fichier global |
|  âjson | boolean | Affichez l'ID de clĂ© / ID Ă©metteur / chemin de fichier .p8 sous forme JSON |
đč Enregistrer
Section intitulée « Enregistrer »npx @capgo/cli@latest build credentials saveEnregistrez les informations de build locales pour iOS ou Android. Les informations sont stockées dans :
- ~/.capgo-credentials/credentials.json (par défaut, global)
- capgo-credentials.json dans le rĂ©pertoire racine du projet (avec la flag âlocal)
â ïž OBLIGATOIRE AVANT LA CONSTRUCTION : Vous devez enregistrer les informations avant de demander une build.
đ Ces informations sont NĂVER stockĂ©es sur les serveurs Capgo de maniĂšre permanente.
Elles sont supprimées immédiatement aprÚs la fin de la construction.
đ 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
âcertificat ./cert.p12 âmot-de-passe-p12 âpasswordâ
âprofil-de-provisionnement-ios ./profile.mobileprovision
âclĂ©-apple ./AuthKey.p8 âidentifiant-clĂ©-apple âKEY123â
âidentifiant-Ă©metteur-apple âissuer-uuidâ âidentifiant-Ă©quipe-apple âteam-idâ Exemple de plusieurs cibles (app + extension de widget) : npx @capgo/cli build credentials save âplateforme ios
âprofil-de-provisionnement-ios ./App.mobileprovision
âprofil-de-provisionnement-ios com.example.widget=./Widget.mobileprovision
⊠npx @capgo/cli build credentials save âplateforme android
âfichier-keystore ./release.keystore âalias-keystore âmy-keyâ
âmot-de-passe-clĂ©-keystore âkey-passâ
âconfig-play ./service-account.json Stockage local (par projet) : npx @capgo/cli build credentials save âlocal âplateforme ios âŠ
Exemple :
iOS Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID d'application (par exemple, com.example.app) (obligatoire) |
| âplateforme | string | Plateforme : ios ou android (obligatoire) |
| âcertificat | string | iOSÂ : Chemin vers le fichier de certificat .p12 |
| âprofil-de-provisionnement-ios | string | iOS : Chemin du profil de provisionnement ou bundleId=path (rĂ©pĂ©table) |
| âmot-de-passe-p12 | string | iOS : Mot de passe du certificat (facultatif si le certificat n'a pas de mot de passe) |
| âclĂ©-apple | string | iOS : Chemin vers la clĂ© .p8 App Store Connect API |
| âidentifiant-clĂ©-apple | string | iOS : Identifiant clĂ© App Store Connect API |
| âidentifiant-Ă©metteur-apple | string | iOS : Identifiant Ă©metteur App Store Connect |
| âidentifiant-Ă©quipe-apple | string | iOS : Identifiant Ă©quipe App Store Connect |
| âios-distribution | string | iOS : Mode de distribution |
| âapple-id | string | iOS : Adresse e-mail Apple pour les tĂ©lĂ©chargements de mot 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 les tĂ©lĂ©chargements TestFlight |
| âapple-app-id | string | iOS : Identifiant numĂ©rique App Store Connect (obligatoire avec âapple-id et âapple-app-specific-password) |
| âkeystore | string | Android : Chemin vers le fichier de clĂ© de stockage (.keystore ou .jks) |
| âkeystore-alias | string | Android : Alias de la clĂ© de stockage |
| âmot-de-passe-clĂ©-keystore | string | Android : mot de passe de la clĂ© du keystore |
| âmot-de-passe-de-keystore | string | Android : mot de passe du magasin de clĂ©s du keystore |
| âconfig-play | string | Android : chemin vers le fichier JSON de compte de service de Google Play Store |
| âflavor-android | string | Android : nom de la variante de produit Ă construire (par exemple production). Obligatoire si votre projet a plusieurs variantes. |
| âprioritĂ©-mise-Ă -jour-en-ligne-en-app | string | Android : prioritĂ© de mise Ă jour en-ligne Google Play pour les futures versions (entier 0â5 ; plus Ă©levĂ© = plus urgent). Omit pour laisser inchangĂ©e la valeur existante de Google Play. |
| âlocal | boolean | Enregistrer dans .capgo-credentials.json dans le rĂ©pertoire racine du projet au lieu de ~/.capgo-credentials/ |
| âtĂ©lĂ©chargement-de-sortie | boolean | TĂ©lĂ©chargez les sorties de build (IPA/APK/AAB) vers le stockage Capgo et imprimez les liens de tĂ©lĂ©chargement |
| âsans-tĂ©lĂ©chargement-de-sortie | boolean | Ne tĂ©lĂ©chargez pas les sorties de build (IPA/APK/AAB) vers le stockage Capgo |
| âdurĂ©e-de-vie-de-sortie | string | DurĂ©e de vie des liens de sortie : 1h Ă 7j (par dĂ©faut : 1h). Exemples : 1h, 6h, 2j |
| âignorer-l'incrĂ©mentation-de-numĂ©ro-de-build | boolean | Ignorer l'incrĂ©mentation automatique du numĂ©ro de build/code/ sur les futures builds |
| âsans-ignorer-l'incrĂ©mentation-de-numĂ©ro-de-build | boolean | RĂ©activer l'incrĂ©mentation automatique du numĂ©ro de build (comportement par dĂ©faut) |
| âignorer-l'incrĂ©mentation-de-version-de-marketing | boolean | Ignorer l'incrĂ©mentation automatique de la version de marketing sur les futures builds lorsque l'application est dĂ©jĂ publiĂ©e |
| âno-skip-marketing-version-bump | boolean | RĂ©activer la mise Ă jour automatique de la version marketing (comportement par dĂ©faut) |
đ Liste
Sous-titre « Liste »npx @capgo/cli@latest build credentials listLister les informations de build enregistrĂ©es (mot de passe masquĂ©). Affiche les informations de build enregistrĂ©es actuellement (globales et locales). Exemples : npx @capgo/cli build credentials list # Liste de tous les applications npx @capgo/cli build credentials list âappId com.example.app # Liste d'une application spĂ©cifique
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID d'application Ă afficher (facultatif, affiche tous si omis) |
| âlocal | boolean | Lister les informations d'identification Ă partir du fichier local .capgo-credentials.json uniquement |
đč Effacer
Section intitulĂ©e « Effacer »npx @capgo/cli@latest build credentials clearClear saved build credentials. Remove credentials from storage. Use âappId and âplatform to target specific credentials. Examples: npx @capgo/cli build credentials clear # Clear all apps (global) npx @capgo/cli build credentials clear âlocal # Clear local credentials npx @capgo/cli build credentials clear âappId com.example.app âplatform ios
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | Identifiant d'application Ă supprimer (facultatif, supprime toutes les applications si omis) |
| âplatform | string | Plateforme Ă supprimer : ios ou android (facultatif, supprime toutes les plateformes si omis) |
| âlocal | boolean | Supprimer depuis le fichier local .capgo-credentials.json au lieu du global |
đč Mise Ă jour
Mise Ă journpx @capgo/cli@latest build credentials updateMise Ă jour des informations d'identification spĂ©cifiques sans fournir toutes les informations Ă nouveau. Mettre Ă jour les informations d'identification existantes en fournissant uniquement les champs que vous souhaitez modifier. La plateforme est dĂ©tectĂ©e automatiquement Ă partir des options que vous fournissez. 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Ăštres | Type | Description |
|---|---|---|
| âappId | string | ID de l'application (dĂ©tectĂ© automatiquement Ă partir de capacitor.config si omis) |
| âplateforme | string | Plateforme : ios ou android (dĂ©tectĂ©e automatiquement Ă partir des options) |
| âlocal | boolean | Mettre Ă jour le fichier local .capgo-credentials.json au lieu du fichier global |
| âcertificat | string | Chemin vers le fichier de certificat P12 |
| âprofil de provisionnement ios | string | Chemin de profil de provisionnement ou bundleId=path (rĂ©pĂ©table, additive par dĂ©faut) |
| âremplacez-la-mise-Ă -jour-ios-provisioning-map | boolean | Remplacez la carte de provisionnement entiĂšre au lieu de la fusionner (par dĂ©faut : fusionner) |
| âp12-mot-de-passe | string | Mot de passe du certificat P12 |
| âclĂ©-apple | string | Chemin vers la clĂ© API d'App Store Connect (.p8 fichier) |
| âclĂ©-apple-id | string | ID de clĂ© API d'App Store Connect |
| âapple-issuer-id | string | ID Ă©metteur d'App Store Connect |
| âapple-team-id | string | ID d'Ă©quipe de App Store Connect |
| âapple-id | string | Adresse e-mail de l'ID Apple pour les tĂ©lĂ©chargements de mot de passe d'application (alternative Ă l'ID d'Ă©quipe de App Store Connect API) |
| âapple-app-specific-password | string | Mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour les tĂ©lĂ©chargements de TestFlight |
| âapple-app-id | string | ID numĂ©rique d'application de App Store Connect (obligatoire avec âapple-id et âapple-app-specific-password) |
| âios-distribution | string | Mode de distribution iOS |
| âkeystore | string | Chemin vers le fichier de clĂ© de stockage (.keystore ou .jks) |
| âkeystore-alias | string | Alias de la clĂ© de coffre-fort |
| âmot de passe de la clĂ© de coffre-fort | string | Mot de passe de la clĂ© de coffre-fort |
| âmot de passe de stockage de coffre-fort | string | Mot de passe de stockage de coffre-fort |
| âconfiguratio n de Google Play | string | Chemin vers le fichier JSON de compte de service Google Play |
| âflavor d'Android | string | Android : Nom de la variante de produit Ă construire (par exemple, production). Obligatoire si votre projet a plusieurs variantes. |
| âprioritĂ© de mise Ă jour en application | string | Android : PrioritĂ© de mise Ă jour en application Google Play pour les futures versions (entier 0â5 ; plus Ă©levĂ© = plus urgent). |
| âtĂ©lĂ©chargement de sortie | boolean | Charger les rĂ©sultats de build (IPA/APK/AAB) vers le stockage Capgo et imprimer les liens de tĂ©lĂ©chargement |
| âne pas charger les rĂ©sultats de build | boolean | Ne pas charger les rĂ©sultats de build (IPA/APK/AAB) vers le stockage Capgo |
| âdurĂ©e de vie des liens de sortie | string | DurĂ©e de vie des liens de sortie : 1h Ă 7 jours. Exemples : 1h, 6h, 2 jours |
| âignorer l'incrĂ©mentation du numĂ©ro de build | boolean | Ignorer l'incrĂ©mentation automatique du numĂ©ro de build/code/ des futures builds |
| âne pas ignorer l'incrĂ©mentation du numĂ©ro de build | boolean | RĂ©activer l'incrĂ©mentation automatique du numĂ©ro de build (comportement par dĂ©faut) |
| âignorer l'incrĂ©mentation de la version de marketing | boolean | Ignorer l'incrĂ©mentation automatique de la version de marketing des futures builds lorsque l'application est dĂ©jĂ publiĂ©e |
| âne pas ignorer l'incrĂ©mentation de la version de marketing | boolean | RĂ©activez la mise Ă jour automatique de la version marketing (comportement par dĂ©faut) |
đč GĂ©rer
Section intitulĂ©e â đč GĂ©rerânpx @capgo/cli@latest build credentials manageGĂ©rer interactivement les informations de build enregistrĂ©es.
Parcourez les informations stockĂ©es, affichez ce qui est configurĂ©, exportez un fichier .env prĂȘt Ă l'emploi pour les CI/CD,
ou supprimez les informations d'une plateforme. Reutilise la mĂȘme interface 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 d'application à gérer (facultatif, proposez de choisir si omis) |
|  âplateforme | string | Plateforme Ă gĂ©rer : ios ou android (facultatif, proposez de choisir si omis) |
|  âlocal | boolean | Seul les fichiers .capgo-credentials.json locaux sont affichĂ©s |
đč Migrer
Section intitulĂ©e â đč Migrerânpx @capgo/cli@latest build credentials migrateMigrer le profil de provisionnement legacy vers le nouveau format multi-cible. Convertit BUILD_PROVISION_PROFILE_BASE64 en CAPGO_IOS_PROVISIONING_MAP. DĂ©couvre automatiquement l'ID de la principale bundle ID Ă partir de votre projet Xcode. npx @capgo/cli build credentials migrate âplateforme ios
Exemple :
Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID d'application (dĂ©tectĂ© automatiquement Ă partir de capacitor.config si omis) |
| âplateforme | string | Plateforme (seulement ios est pris en charge) |
| âlocal | boolean | Migrer Ă partir de local .capgo-credentials.json au lieu de global |