Passer Ă  la navigation

đŸ”č Construire

đŸ—ïž Manage native iOS/Android builds through Capgo Cloud.

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 »
FenĂȘtre de terminal
npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform ios
npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform android

Passer --output-record pour persister l'URL de téléchargement et le QR code, puis utiliser build last-output pour le lire :

FenĂȘtre de terminal
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.json
npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl
FenĂȘtre de terminal
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 :

FenĂȘtre de terminal
npx @capgo/cli@latest build needed com.example.app --channel production --verbose

Options :

ParamĂštreTypeDescription
-astringClé API pour se connecter à votre compte
-cstringCanal à comparer avec. Par défaut, il s'agit de CapacitorUpdater.defaultChannel ou du canal public par défaut
—package-jsonstringChemins vers les fichiers package.json pour les monorepos (sĂ©parĂ©s par des virgules)
—node-modulesstringChemins vers les rĂ©pertoires node_modules pour les monorepos (sĂ©parĂ©s par des virgules)
—verbosebooleanActiver l'affichage dĂ©taillĂ© avec des journaux dĂ©taillĂ©s
—supa-hoststringURL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ© ou le dĂ©veloppement Capgo)
—supa-anonstringClĂ© anonyme Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ©)

Alias : onboarding

FenĂȘtre de terminal
npx @capgo/cli@latest build init

Configurer 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ĂštreTypeDescription
-astringClé API pour se connecter à votre compte
-pstringPlateforme 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-supabasestringURL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement autonome ou le dĂ©veloppement Capgo)
—pas-d'analytiquesbooleanDĂ©sactiver l'analyse d'onboarding et la retranscription de terminal pour cette exĂ©cution
FenĂȘtre de terminal
npx @capgo/cli@latest build request

Demander 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 :

FenĂȘtre de terminal
npx @capgo/cli build credentials save --appId APP_ID --platform ios

Exemple :

FenĂȘtre de terminal
npx @capgo/cli@latest build request com.example.app --platform ios --path .

Options :

ParamĂštreTypeDescription
—cheminstringChemin du rĂ©pertoire de projet Ă  construire (par dĂ©faut : rĂ©pertoire courant)
—node-modulesstringChemins des rĂ©pertoires node_modules pour les monorepos (sĂ©parĂ©s par des virgules)
—plateformestringPlateforme cible : ios ou android (obligatoire)
—mode de constructionstringMode de construction : debug ou release (par dĂ©faut : release)
—build-certificate-base64stringiOS : Certificat .p12 encodĂ© en Base64
—p12-passwordstringiOS : Mot de passe du certificat (facultatif si le certificat n'a pas de mot de passe)
—apple-idstringiOS : 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-passwordstringiOS : Mot de passe d'application spĂ©cifique (xxxx-xxxx-xxxx-xxxx) pour les tĂ©lĂ©chargements de TestFlight
—apple-app-idstringiOS : Identifiant d'application numĂ©rique App Store Connect (obligatoire avec —apple-id et —apple-app-specific-password)
—apple-key-idstringiOS : Identifiant clĂ© App Store Connect API
—apple-issuer-idstringiOS : Identifiant Ă©metteur App Store Connect
—apple-key-contentstringiOS: Base64-encoded App Store Connect API key (.p8)
—app-store-connect-team-idstringiOS : Identifiant d'Ă©quipe App Store Connect
—ios-schemestringiOS : SchĂ©ma Xcode Ă  construire (par dĂ©faut : App)
—ios-targetstringiOS : cible Xcode pour la lecture des paramĂštres de build (par dĂ©faut : mĂȘme que le schĂ©ma)
—ios-distributionstringMode de distribution iOS
—ios-provisioning-profilestringiOS : chemin du profil de provisionnement ou bundleId=path de correspondance (rĂ©pĂ©table)
—android-keystore-filestringAndroid : fichier de clĂ© de stockage encodĂ© en Base64
—keystore-key-aliasstringAndroid : alias de la clĂ© de stockage
—keystore-key-passwordstringAndroid : mot de passe de la clĂ© de stockage
—keystore-store-passwordstringAndroid : Mot de passe de magasin de clĂ©s
—config.json de jeustringAndroid : Compte de services Google Play encodĂ© en Base64
—saveur d'AndroidstringAndroid : Saveur de produit à construire (par exemple, production). Obligatoire si votre projet comporte plusieurs saveurs.
—piste d'AndroidstringAndroid : 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'AndroidstringAndroid : 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 applicationstringAndroid : 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-uploadbooleanIgnorer l'upload vers la Play Store pour cette build (annule les paramĂštres de Play enregistrĂ©s). Exige —output-upload.
—submit-to-store-reviewbooleanAprĂš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-namestringNom/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-notesstringNotes 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-localestringNotes 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-groupsstringiOS : groupes de test externe sĂ©parĂ©s par des virgules ou des identifiants optionnels pour la distribution bĂȘta externe.
—ios-automatic-releasebooleaniOS : 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-releasebooleaniOS : garder la version de l'App Store en attente d'une mise en ligne manuelle aprùs l'approbation d'Apple.
—output-uploadbooleanActiver la mise en ligne de sortie pour cette construction uniquement (activer). PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s
—no-output-uploadbooleanDĂ©sactiver la mise en ligne de sortie pour cette construction uniquement (dĂ©sactiver). PrĂ©pondĂ©rance : CLI > env > identifiants enregistrĂ©s
—output-retentionstringActiver 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-recordstringAfter 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 cachebooleanOmettre 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 cachestringDivisez 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 buildbooleanRemplacez 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 marketingbooleanIgnorer la mise Ă  jour automatique de la version de marketing (CFBundleShortVersionString / versionName) lorsque l'application est dĂ©jĂ  publiĂ©e.
—sync-ios-versionbooleaniOS : synchroniser la version MARKETING_VERSION de Xcode Ă  partir de package.json avant de tĂ©lĂ©charger le projet.
—ai-analyticsbooleanÀ 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-prescanbooleanIgnorer l'analyse prĂ©alable automatique avant la construction
—prescan-ignore-fatalbooleanExĂ©cuter l'analyse prĂ©alable avant la construction mais ne jamais bloquer la construction (seulement rapporter)
—prescan-skipstringIgnorer 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-warnstringRĂ©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-warningsbooleanConsidĂ©rer les avertissements de prescan comme des erreurs mortelles
—send-logs-to-supportbooleanLors 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-logsbooleanAlias dĂ©prĂ©ciĂ© pour —send-logs-to-support
-astringAPI clé pour se connecter à votre compte
—supa-hoststringURL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement auto ou le dĂ©veloppement Capgo)
—supa-anonstringClĂ© anonyme personnalisĂ©e Supabase (pour auto-hĂ©bergement)
—verbosebooleanAfficher 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)..

FenĂȘtre de terminal
npx @capgo/cli@latest build sync-ios-version

Synchronisez la version locale de iOS Xcode MARKETING_VERSION Ă  partir de package.json.

Exemple :

FenĂȘtre de terminal
npx @capgo/cli@latest build sync-ios-version --path .

Options :

ParamĂštreTypeDescription
—cheminstringChemin vers le rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant)
—vĂ©rificationbooleanVĂ©rification uniquement ; sortie non nulle lorsque MARKETING_VERSION est hors synchronisation
FenĂȘtre de terminal
npx @capgo/cli@latest build prescan

Balaye 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ĂštreTypeDescription
—plateformestringPlateforme cible : ios ou android (obligatoire)
—cheminstringChemin du rĂ©pertoire du projet (par dĂ©faut : rĂ©pertoire courant)
-astringAPI clé pour se connecter à votre compte
—flavon d'androidstringAndroid : savez-vous la variante de produit que l'on utilisera pour la construction
—ios-diststringiOS : mode de distribution pour valider contre
—jsonbooleanAffichez un rapport JSON lisible par machine
—fail-on-warningsbooleanSortir avec un code non nul lorsque des avertissements sont trouvĂ©s (CI)
—ignore-fatalbooleanMode de diagnostic : rapportez tout mais sortez toujours avec 0
—skipstringSauter une ou plusieurs vĂ©rifications spĂ©cifiques par ID (rĂ©pĂ©titives ou sĂ©parĂ©es par virgule)
—warnstringRĂ©duire la gravitĂ© d'une vĂ©rification spĂ©cifique (rĂ©pĂ©titive ou sĂ©parĂ©e par virgule) en avertissement par son identifiant
—verbosebooleanActiver l'affichage dĂ©taillĂ© avec des journaux de dĂ©bogage
—supa-hoststringURL de l'hĂŽte Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ© ou le dĂ©veloppement Capgo)
—supa-anonstringClĂ© anonyme Supabase personnalisĂ©e (pour l'hĂ©bergement auto-hĂ©bergĂ©)

đŸ”č Dernier rĂ©sultat

FenĂȘtre de terminal
Copier dans le presse-papier
npx @capgo/cli@latest build last-output

Section 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ĂštreTypeDescription
—cheminstringChemin vers le fichier JSON gĂ©nĂ©rĂ© par —enregistrement-sortie (obligatoire)
—champstringAffiche un champ unique (l'un des : jobId, appId, plateforme, modeDeConstruction, statut, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion)
—qrbooleanAffiche le code QR ASCII rendu code (raccourci pour —champ qrCodeAscii)

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/

Alias : asc-key

FenĂȘtre de terminal
npx @capgo/cli@latest build credentials apple-key

CrĂ©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 :

FenĂȘtre de terminal
Example:

Options :

ParamĂštreTypeDescription
-astringClé API à lier à votre compte
—appIdstringEnregistrez la clĂ© capturĂ©e dans les informations de build iOS de cette application
—localbooleanEnregistrez dans le fichier .capgo-credentials.json par projet au lieu du fichier global
—jsonbooleanAffichez la clĂ© ID / ID Ă©metteur / chemin de .p8 sous forme de JSON
FenĂȘtre de terminal
npx @capgo/cli@latest build credentials save

Enregistrer 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 :

FenĂȘtre de terminal
iOS Example:

Options :

ParamĂštreTypeDescription
—appIdstringID d'application (par exemple, com.example.app) (obligatoire)
—plateformestringPlateforme : ios ou android (obligatoire)
—certificatstringiOS : Chemin vers le fichier de certificat .p12
—provisioning-iosstringiOS : Chemin vers le profil de provisionnement ou bundleId=path (rĂ©pĂ©table)
—mot-de-passe-p12stringiOS : Mot de passe du certificat (facultatif si le certificat n'a pas de mot de passe)
—clĂ©-applestringiOS : Chemin vers la clĂ© .p8 App Store Connect API
—clĂ©-apple-idstringiOS : Identifiant de la clĂ© App Store Connect API
—apple-issuer-idstringiOS : Identifiant Ă©metteur App Store Connect
—apple-team-idstringiOS : Identifiant d'Ă©quipe App Store Connect
—ios-distributionstringiOS : Mode de distribution
—apple-idstringiOS : 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-passwordstringiOS : Mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour les tĂ©lĂ©chargements de TestFlight
—apple-app-idstringiOS : Identifiant numĂ©rique d'application App Store Connect (obligatoire avec —apple-id et —apple-app-specific-password)
—keystorestringAndroid : Chemin vers le fichier de clĂ©s de stockage (.keystore ou .jks)
—keystore-aliasstringAndroid : Alias de la clĂ© de stockage
—keystore-key-passwordstringAndroid : Mot de passe de la clĂ© de stockage
—keystore-store-passwordstringAndroid : Mot de passe du magasin de clĂ©s de stockage
—play-configstringAndroid : Chemin vers le fichier JSON de compte de service de Google Play Store
—android-flavorstringAndroid : Nom de la variante de produit à construire (par exemple, production). Obligatoire si votre projet a plusieurs variantes.
---prioritĂ©-de-mise-Ă -jour-en-lignestringAndroid : 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.
---localbooleanEnregistrer dans .capgo-credentials.json dans la racine du projet au lieu de la valeur globale ~/.capgo-credentials/
---téléchargement-de-sortiebooleanTé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-sortiebooleanNe pas télécharger les sorties de build (IPA/APK/AAB) vers Capgo stockage
---durée-de-validité-de-sortiestringDuré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-buildbooleanIgnorer l'incrémentation automatique du numéro de build/version code pour les futures builds
---ne-sauter-pas-le-bump-numéro-de-constructionbooleanRéactiver l'incrémentation automatique du numéro de construction (comportement par défaut)
---sauter-le-bump-de-version-de-marketingbooleanÉ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-marketingbooleanRéactiver l'incrémentation automatique de la version de marketing (comportement par défaut)
FenĂȘtre de terminal
npx @capgo/cli@latest build credentials list

Lister 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ĂštresTypeDescription
—appIdstringID d'application à afficher (facultatif, affiche tous si omis)
—localbooleanLister les informations d'identification à partir du fichier local .capgo-credentials.json uniquement
FenĂȘtre de terminal
npx @capgo/cli@latest build credentials clear

Effacer 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ĂštreTypeDescription
—appIdstringIdentifiant d'application à effacer (facultatif, efface toutes les applications si omis)
—platformstringPlateforme à effacer : ios ou android (facultatif, efface toutes les plateformes si omis)
—localbooleanEffacez à partir de .capgo-credentials.json local au lieu de global
Onglet terminal
npx @capgo/cli@latest build credentials update

Mettre Ă  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ĂštreTypeDescription
—appIdstringIdentifiant d'application (dĂ©tectĂ© automatiquement Ă  partir de capacitor.config si omis)
—platformstringPlateforme : ios ou android (dĂ©tectĂ©e automatiquement Ă  partir des options)
—localbooleanMettez à jour le fichier capgo-credentials.json local au lieu du global
—certificatstringChemin vers le fichier de certificat P12
—profil-de-provisionnement-iosstringChemin vers le profil de provisionnement ou bundleId=path (rĂ©pĂ©table, additionnel par dĂ©faut)
—remplacement-total-du-mappage-de-provisionnement-iosbooleanRemplacez l'intĂ©gralitĂ© du mappage de provisionnement au lieu de le fusionner (par dĂ©faut : fusionner)
—mot-de-passe-p12stringMot de passe du certificat P12
—clĂ©-applestringChemin vers la clĂ© API d'App Store Connect (.p8 fichier)
—identifiant-de-clĂ©-applestringApp Store Connect API ClĂ© ID
—apple-issuer-idstringID d'Ă©metteur Apple pour App Store Connect
—apple-team-idstringID d'Ă©quipe Apple pour App Store Connect
—apple-idstringiOS : 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-passwordstringiOS : Mot de passe d'application (xxxx-xxxx-xxxx-xxxx) pour les tĂ©lĂ©chargements de TestFlight
—apple-app-idstringiOS : ID numĂ©rique d'application App Store Connect (obligatoire avec —apple-id et —apple-app-specific-password)
—ios-distributionstringiOS : Mode de distribution
— clĂ© de magasinstringChemin du fichier de clĂ© de magasin (.keystore ou .jks)
— alias de clĂ© de magasinstringAlias de clĂ© de magasin
— mot de passe de clĂ© de magasinstringMot de passe de clĂ© de magasin
— mot de passe de magasinstringMot de passe de magasin
— configuration de Google PlaystringChemin du fichier JSON de compte de service Google Play
— saveur d'AndroidstringAndroid : Nom de saveur du produit à construire (par exemple, production). Obligatoire si votre projet comporte plusieurs saveurs.
—prioritĂ©-de-mise-Ă -jour-en-lignestringAndroid : PrioritĂ© de mise Ă  jour en-ligne Google Play pour les futures versions (entier 0–5 ; plus Ă©levĂ© = plus urgent).
—tĂ©lĂ©versement-de-sortiebooleanTĂ©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__booleanDo not upload build outputs (IPA/APK/AAB) to Capgo storage
DurĂ©e de validitĂ© du lien de sortie : 1h Ă  7j. Exemples : 1h, 6h, 2jstring—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 constructionsbooleanSkip automatic build number/version code incrementing on future builds
—prioritĂ©-de-mise-Ă -jour-en-lignebooleanRĂ©activer l'incrĂ©mentation automatique du numĂ©ro de version (comportement par dĂ©faut)
—skip-marketing-version-bumpbooleanIgnorer l'incrĂ©mentation automatique de la version marketing lors des futures compilations lorsque l'application est dĂ©jĂ  publiĂ©e
—no-skip-marketing-version-bumpbooleanRĂ©activer l'incrĂ©mentation automatique de la version marketing (comportement par dĂ©faut)
FenĂȘtre de terminal
npx @capgo/cli@latest build credentials manage

GĂ©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ĂštresTypeDescription
—appIdstringIdentifiant d'application Ă  gĂ©rer (facultatif, proposez de choisir si omis)
—platformstringPlateforme Ă  gĂ©rer : ios ou android (facultatif, proposez de choisir si omis)
—localbooleanSeule navigation locale vers .capgo-credentials.json
FenĂȘtre de terminal
npx @capgo/cli@latest build credentials migrate

Migrer 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 :

FenĂȘtre de terminal
Example:

Options :

ParamĂštreTypeDescription
—appIdstringID d'application (dĂ©tectĂ© automatiquement Ă  partir de capacitor.config si omis)
—plateformestringPlateforme (seul ios est pris en charge)
—localbooleanMigrer de local .capgo-credentials.json au lieu de global