đč Construire
Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plug-in.
đïž 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 d'identification avant de continuer
Section intitulée « Enregistrez les informations d'identification 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 d'output dans CI
Section intitulée « Capturer une URL d'output 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đ§ Affichez « oui » et quittez avec code 1 si une compilation native est requise ; sinon affichez « non » et quittez 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 dĂ©taillĂ©s |
| â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 automatiques ; Android : clé de stockage + 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'onboarding (ios ou android). Si elle est omise, elle détecte automatiquement lorsqu'il n'y a qu'un seul dossier natif ; sinon, elle 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'analytiques | boolean | DĂ©sactiver l'analyse d'onboarding et la retranscription de terminal pour cette exĂ©cution |
đč RequĂȘte
Sous-section intitulĂ©e « RequĂȘte »npx @capgo/cli@latest build requestDemander une mise en construction native Ă Capgo Cloud. Cette commande compressera votre rĂ©pertoire de projet et l'uploadera Ă Capgo pour la mise en construction. La mise en construction 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 mise en construction. Enregistrez-les avant de demander une mise en construction :
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 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 | 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 jeu | string | Android : Compte de services Google Play encodĂ© en Base64 |
| âsaveur d'Android | string | Android : Saveur de produit Ă construire (par exemple, production). Obligatoire si votre projet comporte 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 |
| âstatut de publication d'Android | string | Android : Statut 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 statut 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Ă©fĂ©rence : CLI > env > informations de connexion enregistrĂ©es |
| âno-playstore-upload | boolean | Ignorer l'upload vers la Play Store pour cette build (annule les paramĂštres de Play enregistrĂ©s). Exige âoutput-upload. |
| âsubmit-to-store-review | boolean | AprĂšs l'upload, soumettre la mise Ă jour de la boutique pour examen au lieu de la laisser en tant que brouillon/ build inactif. Sur Android, cela dĂ©duit par dĂ©faut du track de production avec le statut de mise Ă jour terminĂ© (surcharger avec âandroid-track / PLAY_STORE_TRACK et âandroid-release-status / PLAY_STORE_RELEASE_STATUS). Sur iOS, cela soumet la build TestFlight traitĂ©e Ă l'examen de l'App Store. |
| âstore-release-name | string | Nom/Version de la mise Ă jour de la boutique. Android envoie cela sous forme de version_name Google Play ; iOS l'utilise comme version de l'App Store lors de la crĂ©ation ou de la rĂ©utilisation de la version Ă©ditable. |
| âstore-release-notes | string | Notes de mise Ă jour de la boutique par dĂ©faut. Android utilise cela comme changelog Play ; iOS l'utilise comme texte « Quoi de neuf » App Store par dĂ©faut. |
| âstore-release-notes-locale | string | Notes de mise Ă jour 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â. |
| âios-testflight-groups | string | iOS : groupes de test externe sĂ©parĂ©s par des virgules ou des identifiants optionnels 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 construction uniquement (activer). PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s |
| âno-output-upload | boolean | DĂ©sactiver la mise en ligne de sortie pour cette construction uniquement (dĂ©sactiver). PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s |
| âoutput-retention | string | Activer la durĂ©e de vie de la liaison de sortie pour cette construction uniquement (1h Ă 7j). Exemples : 1h, 6h, 2j. PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s |
| â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 Reprenez les champs avec build last-output. |
| âne pas mettre en cache | boolean | Omettre la restauration du cache de build et ne pas enregistrer une nouvelle entrĂ©e de cache pour ce build. Le cache de build est activĂ© par dĂ©faut par application. |
| âclĂ© de cache | string | Divisez le cache de build par environnement, branchement ou saveur Android (par exemple prod, stagingOmettre pour un cache partagĂ© par dĂ©faut par application. |
| âne pas sauter le numĂ©ro de build | boolean | Remplacez les informations de connexion enregistrĂ©es pour rĂ©activer l'incrĂ©mentation automatique du numĂ©ro de build pour ce build uniquement. |
| âne pas incrĂ©menter la version de marketing | boolean | Ignorer la mise Ă jour automatique de la version de marketing (CFBundleShortVersionString / versionName) lorsque l'application est dĂ©jĂ publiĂ©e. |
| âsync-ios-version | boolean | iOS : synchroniser la version MARKETING_VERSION de Xcode Ă partir de package.json avant de tĂ©lĂ©charger le projet. |
| âai-analytics | boolean | Ă l'issue d'une erreur de construction, envoyer les journaux Ă Capgo IA pour un diagnostic. Dans les terminaux interactifs, cela saute la confirmation prĂ©alable ; dans CI, cela tĂ©lĂ©charge automatiquement et imprime l'analyse dans stderr. |
| âno-prescan | boolean | Ignorer l'analyse prĂ©alable automatique avant la construction |
| âprescan-ignore-fatal | boolean | ExĂ©cuter l'analyse prĂ©alable avant la construction mais ne jamais bloquer la construction (seulement rapporter) |
| âprescan-skip | string | Ignorer spĂ©cifiquement une ou plusieurs vĂ©rifications de l'analyse prĂ©alable (par id, rĂ©pĂ©table ou sĂ©parĂ©es par des virgules). Les autres vĂ©rifications s'exĂ©cutent toujours. |
| âprescan-warn | string | RĂ©duire la gravitĂ© de la vĂ©rification de prescan spĂ©cifique(s) Ă un avertissement par ID (rĂ©pĂ©table ou sĂ©parĂ© par des virgules). La vĂ©rification s'exĂ©cute toujours. |
| âfail-on-warnings | boolean | ConsidĂ©rer les avertissements de prescan comme des erreurs mortelles |
| âsend-logs-to-support | boolean | Lors d'une erreur de build CI/CD, tĂ©lĂ©charger automatiquement les journaux de build vers le support Capgo (pas d'email requis). Le support Capgo est notifiĂ© et suivra par email. Ajoutatif Ă âai-analytics. |
| âsend-logs | boolean | Alias dĂ©prĂ©ciĂ© pour âsend-logs-to-support |
| -a | string | API clé pour se connecter à votre compte |
| âsupa-host | string | URL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement auto ou le dĂ©veloppement Capgo) |
| âsupa-anon | string | ClĂ© anonyme personnalisĂ©e Supabase (pour auto-hĂ©bergement) |
| âverbose | boolean | Afficher les informations dĂ©taillĂ©es avec journalisation |
Cache de construction : Capgo restaure et sauve les artefacts natifs compilĂ©s (CocoaPods, Gradle et les sorties connexes) par dĂ©faut par application. Utilisez --cache-key pour conserver les caches RC et de production sĂ©parĂ©s ; utilisez --no-cache pour une construction de nettoyage unilatĂ©ral. Les intĂ©grations API peuvent passer cache_key ou cache_enabled: false contexte : Fragment de texte HTML d'une chaĂźne de Capgo UI plus longue (clĂ© parente `alternatives_cta_questions`). Page/zone : Comparaison de pages de mise Ă jour en direct de Capacitor. RĂŽle : Paragraphe marketing ou juridique long. Vu dans : page alternatives.astro. PrĂ©servez les termes de produit et de marque de Capgo ainsi que les termes de dĂ©veloppeur exactement. ClĂ© de message `alternatives_cta_questions` (Questions de CTA Alternatives). | Fragment de texte HTML d'une chaĂźne de Capgo UI plus longue (clĂ© parente `appflow_cta_questions`). Page/zone : Comparaison et migration de Appflow. RĂŽle : Paragraphe marketing ou juridique long. Vu dans : page ionic-appflow.astro. PrĂ©servez les termes de produit et de marque de Capgo ainsi que les termes de dĂ©veloppeur exactement. ClĂ© de message `appflow_cta_questions` (Questions de CTA Appflow). | Fragment de texte HTML d'une chaĂźne de Capgo UI plus longue (clĂ© parente `capwesome_cta_questions`). Page/zone : Page de comparaison de Capawesome. RĂŽle : Paragraphe marketing ou juridique long. Vu dans : page capwesome.astro. PrĂ©servez les termes de produit et de marque de Capgo ainsi que les termes de dĂ©veloppeur exactement. ClĂ© de message `capwesome_cta_questions` (Questions de CTA Capwesome). | Fragment de texte HTML d'une chaĂźne de Capgo UI plus longue (clĂ© parente `consulting_faq_subtitle`). Page/zone : Page de services de conseil. RĂŽle : Sous-titre ou tagline de section. Vu dans : page consulting.astro. PrĂ©servez les termes de produit et de marque de Capgo ainsi que les termes de dĂ©veloppeur exactement. ClĂ© de message `consulting_faq_subtitle` (Sous-titre FAQ de conseil). | Page/zone : Comparaison et migration de Appflow. RĂŽle : Ătiquette de navigation ou Ă©lĂ©ment de navigation court. Vu dans : page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. ClĂ© de message `appflow_plugins_or` (Appflow Plugins Ou). dans le payload de la demande de construction. Voir Cache de construction et : Page/zone : Site web marketing de Capgo. RĂŽle : Ătiquette de navigation ou Ă©lĂ©ment de navigation court. Vu dans : page trust.astro. ClĂ© de message `et` (Et)..
đč Sync-ios-version
Section intitulĂ©e â đč Sync-ios-versionânpx @capgo/cli@latest build sync-ios-versionSynchronisez la version locale de iOS Xcode MARKETING_VERSION Ă 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Ă©rification | boolean | VĂ©rification uniquement ; sortie non nulle lorsque MARKETING_VERSION est hors synchronisation |
đč PrĂ©-scanner
Section intitulĂ©e â đč PrĂ©-scannerânpx @capgo/cli@latest build prescanBalaye votre projet et vos informations d'identification enregistrĂ©es pour les problĂšmes qui empĂȘcheraient une mise en ligne cloud â avant d'envoyer 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 standalone (par exemple, dans CI).
Voir Pré-scanner vérifie pour le catalogue complet de vérifications et comment les utiliser --skip / --warn rÚgles individuelles.
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âplateforme | string | Plateforme cible : ios ou android (obligatoire) |
| âchemin | string | Chemin du rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant) |
| -a | string | API clé pour se connecter à votre compte |
| âflavon d'android | string | Android : savez-vous la variante de produit que l'on utilisera pour la construction |
| âios-dist | string | iOS : mode de distribution pour valider contre |
| âjson | boolean | Affichez 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 de diagnostic : rapportez tout mais sortez toujours avec 0 |
| âskip | string | Sauter une ou plusieurs vĂ©rifications spĂ©cifiques par ID (rĂ©pĂ©titives ou sĂ©parĂ©es par virgule) |
| âwarn | string | RĂ©duire la gravitĂ© d'une vĂ©rification spĂ©cifique (rĂ©pĂ©titive ou sĂ©parĂ©e par virgule) en avertissement par son identifiant |
| â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Ă©) |
đč Dernier rĂ©sultat
FenĂȘtre de terminalnpx @capgo/cli@latest build last-outputSection intitulĂ©e « Dernier rĂ©sultat » build request --output-recordAffiche le JSON complet par dĂ©faut, un champ unique avec âchamp, ou le code QR ASCII
code avec âqr. Utile dans les CI pour rĂ©cupĂ©rer l'URL de tĂ©lĂ©chargement ou le code QR pour le rĂ©afficher
sur un PR ou un problĂšme.
Exemples :
npx @capgo/cli build last-output âchemin /tmp/build.json
npx @capgo/cli build last-output âchemin /tmp/build.json âchamp outputUrl
npx @capgo/cli build last-output âchemin /tmp/build.json âqr
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âchemin | string | Chemin vers le fichier JSON gĂ©nĂ©rĂ© par âenregistrement-sortie (obligatoire) |
| âchamp | string | Affiche un champ unique (l'un des : jobId, appId, plateforme, modeDeConstruction, statut, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âqr | boolean | Affiche le code QR ASCII rendu code (raccourci pour âchamp qrCodeAscii) |
đč Authentification
Section intitulĂ©e â đč IdentifiantsâGĂ©rez 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ĂANMOINS jamais stockĂ©s de maniĂšre permanente
- Supprimés de Capgo immédiatement aprÚs la construction
- Les sorties de construction peuvent ĂȘtre envoyĂ©es optionnellement pour des liens de tĂ©lĂ©chargement Ă temps limitĂ© đ DOCUMENTATION : Configuration iOS : https://capgo.app/docs/cli/construction-cloud/ios/ Configuration Android : https://capgo.app/docs/cli/construction-cloud/android/
đč ClĂ© Apple
Section intitulĂ©e â đč ClĂ© AppleâAlias : asc-key
npx @capgo/cli@latest build credentials apple-keyCrĂ©er 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 jeton .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 construire des crĂ©dits dâapplication apple-key âappId com.example.app
Exemple :
Example:Options :
| ParamĂštre | Type | Description |
|---|---|---|
| -a | string | Clé API à lier à votre compte |
| âappId | string | Enregistrez la clĂ© capturĂ©e dans les informations de build iOS de cette application |
| âlocal | boolean | Enregistrez dans le fichier .capgo-credentials.json par projet au lieu du fichier global |
| âjson | boolean | Affichez la clĂ© ID / ID Ă©metteur / chemin de .p8 sous forme de JSON |
đč Enregistrer
Section intitulée « Enregistrer »npx @capgo/cli@latest build credentials saveEnregistrer 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 dossier de projet (avec la flag âlocal)
â ïž OBLIGATOIRE AVANT LA CONSTRUCTION : Vous devez sauvegarder vos informations d'identification avant de demander une construction.
đ Ces informations d'identification ne sont jamais 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/construction-cloud/ios/
Android : https://capgo.app/docs/cli/construction-cloud/android/
npx @capgo/cli build credentials save âplateforme ios
âcertificat ./cert.p12 âmot-de-passe-p12 « mot-de-passe »
â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 cible multiple (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
âkeystore ./release.keystore âkeystore-alias âmon-clĂ©â
âkeystore-key-password âmot-de-passe-clĂ©â
â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 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 |
| âprovisioning-ios | string | iOS : Chemin vers le 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 |
| âclĂ©-apple-id | string | iOS : Identifiant de la clĂ© App Store Connect API |
| âapple-issuer-id | string | iOS : Identifiant Ă©metteur App Store Connect |
| âapple-team-id | string | iOS : Identifiant d'Ă©quipe App Store Connect |
| âios-distribution | string | iOS : Mode de distribution |
| âapple-id | string | iOS : Adresse e-mail Apple ID pour les tĂ©lĂ©chargements de mot de passe d'application (alternative Ă l'identifiant API de App Store Connect) |
| â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 : Identifiant numĂ©rique d'application App Store Connect (obligatoire avec âapple-id et âapple-app-specific-password) |
| âkeystore | string | Android : Chemin vers le fichier de clĂ©s de stockage (.keystore ou .jks) |
| âkeystore-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 du magasin de clĂ©s de stockage |
| âplay-config | string | Android : Chemin vers le fichier JSON de compte de service de Google Play Store |
| âandroid-flavor | string | Android : Nom de la variante de produit Ă construire (par exemple, production). Obligatoire si votre projet a plusieurs variantes. |
| ---prioritĂ©-de-mise-Ă -jour-en-ligne | string | Android : prioritĂ© de mise Ă jour en-ligne Google Play pour les futures mises Ă jour (entier 0â5 ; plus Ă©levĂ© = plus urgent). Omit pour laisser inchangĂ©e la valeur existante de Play. |
| ---local | boolean | Enregistrer dans .capgo-credentials.json dans la racine du projet au lieu de la valeur globale ~/.capgo-credentials/ |
| ---téléchargement-de-sortie | boolean | Télécharger les sorties de build (IPA/APK/AAB) vers Capgo stockage et imprimer les liens de téléchargement |
| ---ne-télécharger-pas-sortie | boolean | Ne pas télécharger les sorties de build (IPA/APK/AAB) vers Capgo stockage |
| ---durée-de-validité-de-sortie | string | Durée de validité du lien 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/version code pour les futures builds |
| ---ne-sauter-pas-le-bump-numéro-de-construction | boolean | Réactiver l'incrémentation automatique du numéro de construction (comportement par défaut) |
| ---sauter-le-bump-de-version-de-marketing | boolean | Ăviter l'incrĂ©mentation automatique de la version de marketing dans les futures constructions lorsque l'application est dĂ©jĂ publiĂ©e |
| ---ne-sauter-pas-le-bump-de-version-de-marketing | boolean | Réactiver l'incrémentation automatique de la version de marketing (comportement par défaut) |
đ Liste
Section intitulĂ©e â đ Listeânpx @capgo/cli@latest build credentials listLister les informations de construction enregistrĂ©es (mot de passe masquĂ©). Affiche les informations de construction actuellement enregistrĂ©es (globales et locales). Exemples : npx @capgo/cli build credentials list # Listez toutes les applications npx @capgo/cli build credentials list âappId com.example.app # Listez une application spĂ©cifique
Options :
| ParamĂštres | 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 clearEffacer les informations d'identification de la construction sauvegardĂ©es. Supprimer les informations d'identification du stockage. Utiliser âappId et âplatform pour cibler des informations d'identification spĂ©cifiques. Exemples : npx @capgo/cli build credentials clear # Effacer toutes les applications (global) npx @capgo/cli build credentials clear âlocal # Effacer les informations d'identification locales npx @capgo/cli build credentials clear âappId com.example.app âplatform ios
Options :
| ParamĂštre | Type | Description |
|---|---|---|
| âappId | string | Identifiant d'application Ă effacer (facultatif, efface toutes les applications si omis) |
| âplatform | string | Plateforme Ă effacer : ios ou android (facultatif, efface toutes les plateformes si omis) |
| âlocal | boolean | Effacez Ă partir de .capgo-credentials.json local au lieu de global |
đč Mise Ă jour
Section intitulĂ©e â Mise Ă jour ânpx @capgo/cli@latest build credentials updateMettre Ă jour des informations d'identification spĂ©cifiques sans fournir toutes d'elles Ă 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 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 | Identifiant d'application (dĂ©tectĂ© automatiquement Ă partir de capacitor.config si omis) |
| âplatform | string | Plateforme : ios ou android (dĂ©tectĂ©e automatiquement Ă partir des options) |
| âlocal | boolean | Mettez Ă jour le fichier capgo-credentials.json local au lieu du global |
| âcertificat | string | Chemin vers le fichier de certificat P12 |
| âprofil-de-provisionnement-ios | string | Chemin vers le profil de provisionnement ou bundleId=path (rĂ©pĂ©table, additionnel par dĂ©faut) |
| âremplacement-total-du-mappage-de-provisionnement-ios | boolean | Remplacez l'intĂ©gralitĂ© du mappage de provisionnement au lieu de le fusionner (par dĂ©faut : fusionner) |
| âmot-de-passe-p12 | string | Mot de passe du certificat P12 |
| âclĂ©-apple | string | Chemin vers la clĂ© API d'App Store Connect (.p8 fichier) |
| âidentifiant-de-clĂ©-apple | string | App Store Connect API ClĂ© ID |
| âapple-issuer-id | string | ID d'Ă©metteur Apple pour App Store Connect |
| âapple-team-id | string | ID d'Ă©quipe Apple pour App Store Connect |
| âapple-id | string | iOS : Adresse e-mail de l'ID Apple pour les tĂ©lĂ©chargements de mot de passe d'application (alternative Ă la clĂ© API d'App Store Connect) |
| â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 App Store Connect (obligatoire avec âapple-id et âapple-app-specific-password) |
| âios-distribution | string | iOS : Mode de distribution |
| â clĂ© de magasin | string | Chemin du fichier de clĂ© de magasin (.keystore ou .jks) |
| â alias de clĂ© de magasin | string | Alias de clĂ© de magasin |
| â mot de passe de clĂ© de magasin | string | Mot de passe de clĂ© de magasin |
| â mot de passe de magasin | string | Mot de passe de magasin |
| â configuration de Google Play | string | Chemin du fichier JSON de compte de service Google Play |
| â saveur d'Android | string | Android : Nom de saveur du produit Ă construire (par exemple, production). Obligatoire si votre projet comporte plusieurs saveurs. |
| âprioritĂ©-de-mise-Ă -jour-en-ligne | string | Android : PrioritĂ© de mise Ă jour en-ligne Google Play pour les futures versions (entier 0â5 ; plus Ă©levĂ© = plus urgent). |
| âtĂ©lĂ©versement-de-sortie | boolean | TĂ©lĂ©verser les sorties de construction (IPA/APK/AAB) vers le stockage Capgo et imprimer les liens de tĂ©lĂ©chargement |
| âne pas tĂ©lĂ©verser les sorties de construction (IPA/APK/AAB) vers le stockage __CAPGO_KEEP_0__ | boolean | Do not upload build outputs (IPA/APK/AAB) to Capgo storage |
| DurĂ©e de validitĂ© du lien de sortie : 1h Ă 7j. Exemples : 1h, 6h, 2j | string | âignorer-l'incrĂ©mentation-de-la-numĂ©ro-de-construction |
| Ignorer l'incrémentation automatique du numéro de construction/version __CAPGO_KEEP_0__ sur les futures constructions | boolean | Skip automatic build number/version code incrementing on future builds |
| âprioritĂ©-de-mise-Ă -jour-en-ligne | boolean | RĂ©activer l'incrĂ©mentation automatique du numĂ©ro de version (comportement par dĂ©faut) |
| âskip-marketing-version-bump | boolean | Ignorer l'incrĂ©mentation automatique de la version marketing lors des futures compilations lorsque 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Ă©rer interactivement les informations de connexion de compilation sauvegardĂ©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 utilisateur 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Ăštres | Type | Description |
|---|---|---|
| âappId | string | Identifiant d'application Ă gĂ©rer (facultatif, proposez de choisir si omis) |
| âplatform | string | Plateforme Ă gĂ©rer : ios ou android (facultatif, proposez de choisir si omis) |
| âlocal | boolean | Seule navigation locale vers .capgo-credentials.json |
đč Migrer
Sous-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 application Ă partir de votre projet Xcode. npx @capgo/cli build credentials migrate âplatform 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 (seul ios est pris en charge) |
| âlocal | boolean | Migrer de local .capgo-credentials.json au lieu de global |