đč Construire
Copiez un prompt de configuration de l'IA avec les étapes d'installation et la 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 compte avant de continuer
Section intitulée « Enregistrez les informations de compte 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 une URL de sortie dans CI
Section intitulée « Capturer une 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đ§ Afficher "oui" et quitter avec code 1 si une compilation native est requise ; sinon afficher "non" et quitter 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 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 elle est omise, elle détecte automatiquement lorsque seul un dossier natif existe ; sinon, elle demande confirmation. |
| âsupa-host | string | URL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement auto ou le dĂ©veloppement Capgo) |
| âno-analytics | boolean | DĂ©sactiver l'analyse de l'onboarding de la construction et la retranscription du terminal pour cette exĂ©cution |
đč Section intitulĂ©e « đč Demande »
FenĂȘtre de terminalnpx @capgo/cli@latest build requestRequest a native build from Capgo Cloud. This command will zip your project directory and upload it to Capgo for building. The build will be processed and sent directly to app stores. Credentials are never stored on Capgo servers; they are deleted after the build. Save them before requesting a 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 TestFlight |
| âapple-app-id | string | iOS : Identifiant d'application App Store Connect numĂ©rique (obligatoire avec âapple-id et âapple-app-specific-password) |
| âapple-key-id | string | iOS : Identifiant 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 d'Ă©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 build (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 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 jeu | string | Android : compte de services Google Play encodĂ© en Base64 |
| âflavor d'Android | string | Android : saveur de produit Ă construire (par exemple, production). Obligatoire si votre projet a plusieurs saveurs. |
| âtrack d'Android | string | Android : piste Google Play pour cette mise Ă jour (intĂ©rieure, alpha, bĂȘta, production). Par dĂ©faut sans âsubmit-to-store-review : intĂ©rieure. Avec âsubmit-to-store-review et sans piste dĂ©finie : production. PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| âstatut de publication d'Android | string | Android : statut de publication Google Play (brouillon, terminĂ©, en cours de progression, arrĂȘtĂ©). Par dĂ©faut sans âsubmit-to-store-review : brouillon. Avec âsubmit-to-store-review et sans statut dĂ©fini : terminĂ©. PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| âprioritĂ© de mise Ă jour en application d'Android | string | Android : prioritĂ© de mise Ă jour en application Google Play pour cette publication (entier 0â5 ; plus Ă©levĂ© = plus urgent). Consultez https://developer.android.com/guide/playcore/in-app-updates. PrĂ©fĂ©rence : CLI > env > informations de connexion enregistrĂ©es |
| âne pas tĂ©lĂ©verser sur Play Store | boolean | Omettre le tĂ©lĂ©versement sur Play Store pour cette build (annule les paramĂštres de Play enregistrĂ©s). Exige âoutput-upload. |
| âsoumettre Ă la revue de la boutique | boolean | AprĂšs tĂ©lĂ©versement, soumettre la mise en ligne de la boutique pour la revue 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 en ligne terminĂ© (surplomber avec âandroid-track / PLAY_STORE_TRACK et âandroid-release-status / PLAY_STORE_RELEASE_STATUS). Sur iOS, cela soumet la build de TestFlight traitĂ©e Ă la revue de l'App Store. |
| ânom de la mise en ligne de la boutique | string | Nom/label de version de la mise en ligne de la boutique. Android envoie cela sous la forme du nom de version de Google Play ; iOS l'utilise comme la version de l'App Store lors de la crĂ©ation ou de la rĂ©utilisation de la version Ă©ditable. |
| ânotes de mise en ligne de la boutique | string | Notes de mise en ligne de la boutique 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 en ligne de la boutique (localisĂ©es) | string | Notes de mise en ligne de la boutique localisĂ©es (rĂ©pĂ©tables), par exemple âstore-release-notes-locale en-US=âCorrections de boguesâ âstore-release-notes-locale fr-FR=âCorrectionsâ. |
| âgroupes de TestFlight sur iOS | string | iOS : groupes ou identifiants externes de TestFlight sĂ©parĂ©s par des virgules facultatifs 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 mise en ligne de sortie pour cette seule construction (activer). PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| âno-output-upload | boolean | DĂ©sactiver la mise en ligne de sortie pour cette seule construction (dĂ©sactiver). PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| âoutput-retention | string | Activer la durĂ©e de vie de la liaison de sortie pour cette seule construction (1h Ă 7j). Exemples : 1h, 6h, 2j. PrĂ©pondĂ©rance : CLI > env > informations de connexion enregistrĂ©es |
| â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émenté pour ce build uniquement. | boolean | Supprimez le numéro de build incrémenté automatiquement pour ce build uniquement. |
| Omettre l'incrémentation automatique de la version de marketing (CFBundleShortVersionString / versionName) lorsque l'application est déjà publiée. | boolean | iOS : synchronisez la version MARKETING_VERSION de Xcode à partir de package.json avant de télécharger le projet. |
| En cas d'erreur de build, envoyez les journaux à __CAPGO_KEEP_0__ AI pour un diagnostic. Dans les terminaux interactifs, cela saute la confirmation préalable ; dans CI, cela télécharge automatiquement et imprime l'analyse à stderr. | boolean | Omettre l'analyse pré-build automatique. |
| Omettre l'analyse pré-build automatique. | 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. |
| Omettre l'analyse pré-build automatique. | boolean | Omettre l'analyse pré-build automatique. |
| ---ignorer-fatal | boolean | Exécutez l'analyse pré-build mais ne bloquez jamais la construction (rapport uniquement) |
| ---skip-prescan | 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. |
| ---prescan-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-logs-au-support | boolean | Ă une Ă©chec de construction CI/CD, tĂ©lĂ©charger automatiquement les journaux de construction vers le support Capgo (pas d'email requis). Le support Capgo est notifiĂ© et suivra par email. Ajoutatif Ă âai-analytics. |
| ---envoyer-logs | boolean | Alias obsolĂšte pour âenvoyer-logs-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 de Xcode iOS locale Ă partir de package.json.
Exemple :
npx @capgo/cli@latest build sync-ios-version --path .Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âchemin | string | Chemin vers le rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant) |
| âvĂ©rifier | boolean | VĂ©rifiez uniquement ; sortir 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, disposition 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 Préscanner vérifie pour le catalogue complet de 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 que le build utilisera |
| âmode-distribution-ios | string | iOS : mode de distribution pour valider contre |
| âjson | boolean | Produit 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 des vĂ©rifications spĂ©cifiques par ID (rĂ©pĂ©tables ou sĂ©parĂ©s par virgule) |
| âwarn | string | RĂ©duire des vĂ©rifications spĂ©cifiques Ă un avertissement par ID (rĂ©pĂ©tables ou sĂ©parĂ©s 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 seul champ 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 suivants : jobId, appId, plateforme, modeDeConstruction, Ă©tat, 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 sauvegardés dans ~/.capgo-credentials/credentials.json (global) ou .capgo-credentials.json (local)
- Lors de la construction, envoyés à Capgo mais N'EN PASSE JAMAIS stockés de maniÚre permanente
- 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: 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Ă© d'Ă©quipe App Store Connect API avec 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Ă©, capture 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 | API clé 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 de JSON |
đč Enregistrer
Section intitulée « Enregistrer »npx @capgo/cli@latest build credentials saveEnregistrez les informations de build localement 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-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 comporte plusieurs variantes. |
| âprioritĂ©-mise-Ă -jour-en-ligne-en-app | string | Android : PrioritĂ© de mise Ă jour en ligne en app 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-incrĂ©mentation-de-numĂ©ro-de-build | boolean | Ignorer l'incrĂ©mentation automatique du numĂ©ro de build/version code pour les futures builds |
| âne-pas-ignorer-incrĂ©mentation-de-numĂ©ro-de-build | boolean | RĂ©activer l'incrĂ©mentation automatique du numĂ©ro de build (comportement par dĂ©faut) |
| âignorer-incrĂ©mentation-de-version-de-marketing | boolean | Ignorer l'incrĂ©mentation automatique de la version de marketing pour les futures builds lorsque l'application est dĂ©jĂ publiĂ©e |
| âno-skip-marketing-version-bump | boolean | RĂ©activez la mise Ă jour automatique de la version marketing (comportement par dĂ©faut) |
đ Liste
Section intitulĂ©e â đ Listeânpx @capgo/cli@latest build credentials listAffiche la liste des informations de build enregistrĂ©es (mot de passe masquĂ©). Montre ce qui est actuellement enregistrĂ© (globalement et localement). Exemples : npx @capgo/cli build credentials list # Liste toutes les applications npx @capgo/cli build credentials list âappId com.example.app # Liste l'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
Section intitulĂ©e â đč Mise Ă jourânpx @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 | Identifiant d'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 mise en ligne ios | string | Chemin de profil de provisionnement ou bundleId=path (rĂ©pĂ©table, additive par dĂ©faut) |
| âremplacez-la-mise-en-page-ios | boolean | Remplacez la mise en page de provisionnement entiĂšre au lieu de la fusionner (par dĂ©faut : fusionner) |
| âmot-de-passe-p12 | string | Mot de passe du certificat P12 |
| âclĂ©-apple | string | Chemin vers la clĂ© App Store Connect API (.p8 fichier) |
| âclĂ©-apple-id | string | ID de clĂ© App Store Connect API |
| âapple-issuer-id | string | ID Ă©metteur App Store Connect |
| âapple-team-id | string | ID d'Ă©quipe d'App Store Connect |
| âapple-id | string | iOS : Adresse e-mail Apple ID pour les tĂ©lĂ©chargements de mot de passe d'application (alternative Ă l'ID d'Ă©quipe d'App Store Connect API) |
| âapple-app-specific-password | string | iOS : Mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour les tĂ©lĂ©chargements de TestFlight |
| âapple-app-id | string | iOS : ID numĂ©rique d'application d'App Store Connect (obligatoire avec âapple-id et âapple-app-specific-password) |
| âios-distribution | string | iOS : Mode de distribution |
| âkeystore | string | Chemin vers le fichier de clĂ© de stockage (.keystore ou .jks) |
| âkeystore-alias | string | Alias de la clĂ© du coffre-fort |
| âmot de passe de la clĂ© du coffre-fort | string | Mot de passe de la clĂ© du coffre-fort |
| âmot de passe du coffre-fort | string | Mot de passe du coffre-fort |
| âconfiguraton de 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 comporte plusieurs variantes. |
| âprioritĂ© de mise Ă jour en application | string | Android : PrioritĂ© de mise Ă jour en application Google Play pour les futures mises Ă jour (entier 0â5 ; plus Ă©levĂ© = plus urgent). |
| âtĂ©lĂ©chargement de sortie | boolean | Charger les sorties de build (IPA/APK/AAB) dans le stockage Capgo et imprimer les liens de tĂ©lĂ©chargement |
| âne pas charger les sorties de build | boolean | Ne pas charger les sorties de build (IPA/APK/AAB) dans 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Ă©activer la mise Ă jour automatique de la version de 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.
Parcourir les informations de connexion stockĂ©es, afficher ce qui est configurĂ©, exporter un fichier .env prĂȘt Ă l'emploi pour les CI/CD,
ou supprimer les informations de connexion 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 un choix si omis) |
| ---plateforme | string | Plateforme à gérer : ios ou android (facultatif, proposez un choix si omis) |
| ---local | boolean | Seul navigateur local des fichiers .capgo-credentials.json |
đč 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 de votre projet Xcode. npx @capgo/cli build credentials migrate âplateforme ios
Exemple :
Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | ID de l'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 |