Vérifications prescan du build
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Avant que Capgo Cloud Build n'envoie votre projet, le CLI lance un pré-scan qui détecte localement les problèmes d'identifiants, de projet et de configuration de store.
Il fonctionne aussi de manière autonome :
npx @capgo/cli@latest build prescan <appId> --platform iosIl y a 80 vérifications aujourd’hui. Mieux vaut ignorer les ID de vérification individuels plutôt que de désactiver tout le scan.
Ignorer certains contrôles
Section intitulée « Ignorer des contrôles spécifiques »# Skip one check entirely (example: intentional Capacitor server.url / Next.js shell)npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shipped
# Run the check but never block on it (error becomes warning)npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped
# Repeatable or comma-separatednpx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shipped \ --prescan-warn ios/capacitor-allow-navigation-wildcard,ios/plist-ats-arbitrary-loadsAlias autonomes activés build prescan:
npx @capgo/cli@latest build prescan <appId> --platform ios \ --skip ios/capacitor-server-url-shipped \ --warn ios/capacitor-server-cleartextUnknown check ids fail fast with a clear error.
Échappements globaux (à utiliser avec parcimonie)
Section titled “Global escapes (use sparingly)”| Drapeau | Effet |
|---|---|
--no-prescan | Ignorer l’analyse complète |
--prescan-ignore-fatal (ou --ignore-fatal sur build prescan) | Run scan, print report, never block |
--fail-on-warnings | Traiter les warnings comme des erreurs (CI) |
--no-prescan et --prescan-ignore-fatal masquer ou contourner toutes vérifications restantes. Utilisez des overrides par vérification si vous ne désapprouvez qu’une seule règle.
Vérifier le catalogue
Section intitulée « Catalogue des vérifications »Utilisez l'id exact dans --prescan-skip / --prescan-warn.
Application progressive signifie que le résultat est purement informatif jusqu'à 2026-08-14, il peut alors bloquer les builds.
Partagé
Section intitulée « Shared »| Id | Plateformes | Ce qu’il vérifie | Application progressive |
|---|---|---|---|
shared/apikey-permission | ios, android | La clé API peut demander des builds natifs | — |
shared/app-exists | ios, android | L’App id existe et est visible pour la clé API | — |
shared/credentials-saved | ios, android | Les identifiants iOS/Android requis sont stockés localement | — |
shared/cap-sync-stale | ios, android | Assets web compilés et plugins Capacitor synchronisés | — |
shared/node-linker-layout | ios, android | La structure node_modules est compatible avec les chemins natifs Capacitor | — |
shared/bundle-id-consistency | ios, android | L'appId Capacitor correspond au bundle id / applicationId natif | — |
| Id | Plateformes | Ce qu’il vérifie | Application progressive |
|---|---|---|---|
ios/p12-opens | iOS | Le fichier iOS .p12 s'ouvre avec le mot de passe fourni | — |
ios/p12-expiry | iOS | Le certificat de signature iOS n'est pas expiré | — |
ios/profile-expiry | iOS | Le profil de provisionnement n'est pas expiré | — |
ios/profile-bundle-match | iOS | Provisioning profile bundle id matches the app | — |
ios/profile-type-vs-mode | iOS | Le type de profil correspond au mode app_store / ad_hoc | — |
ios/cert-profile-pairing | iOS | Le certificat est intégré au profil de provisionnement | — |
ios/targets-covered | iOS | Toutes les cibles iOS ont un profil de provisionnement | — |
ios/infoplist-sanity | iOS | Info.plist contient les clés de version / d'identité requises | — |
ios/asc-key-valid | iOS | Les champs de la clé API d'App Store Connect semblent valides | — |
ios/asc-key-access | iOS | La clé API d'ASC peut accéder à l'app (à distance) | — |
ios/plist-bundle-id-format | iOS | Le format du CFBundleIdentifier est valide | Oui |
ios/plist-version-short-format | iOS | Le format de CFBundleShortVersionString est valide | Oui |
ios/plist-version-build-format | iOS | Le format de CFBundleVersion est valide | Oui |
ios/plist-encryption-compliance | iOS | ITSAppUsesNonExemptEncryption est déclaré | Oui |
ios/plist-ats-arbitrary-loads | iOS | NSAllowsArbitraryLoads n'est pas activé pour la production | Oui |
ios/plist-launch-storyboard | iOS | L’écran de lancement est déclaré | Oui |
ios/plist-orientations-multitasking | iOS | Les paramètres d’orientation / multitâche sont cohérents | Oui |
ios/plist-orientations-present | iOS | UISupportedInterfaceOrientations est déclaré | Oui |
ios/plist-display-name | iOS | Le nom d’affichage est défini | Oui |
ios/plist-background-modes-sanity | iOS | Les valeurs UIBackgroundModes semblent valides | Oui |
ios/plist-scene-lifecycle-xcode27 | iOS | L’app adopte le cycle de vie UIScene lors du build avec Xcode 27+ (requis par iOS 27 SDK) | Oui |
ios/xcode-deployment-target-capacitor | iOS | La cible de déploiement iOS répond aux exigences de Capacitor | Oui |
ios/xcode-signing-team | iOS | L’équipe de signature est définie | Oui |
ios/xcode-bundle-id-mismatch-across-configs | iOS | Bundle id is consistent across Xcode configs | Oui |
ios/xcode-enable-bitcode-leftover | iOS | Le résidu ENABLE_BITCODE a été supprimé | Oui |
ios/xcode-swift-version-sanity | iOS | Le paramètre de version Swift semble correct | Oui |
ios/xcode-no-app-target | iOS | Le projet Xcode possède une cible d’application | Oui |
ios/xcode-multiple-app-targets | iOS | Les multiples cibles d’application sont gérées intentionnellement | Oui |
ios/entitlements-vs-profile-capability | iOS | Les entitlements correspondent aux capacités du profil | Oui |
ios/entitlements-aps-environment-vs-mode | iOS | aps-environment correspond au mode de distribution | Oui |
ios/entitlements-associated-domains-format | iOS | Le format Associated Domains est valide | Oui |
ios/entitlements-app-groups-format | iOS | Le format des App Groups est valide | Oui |
ios/capacitor-server-url-shipped | iOS | server.url n'est pas laissé comme endpoint de live-reload / shell distant pour les builds destinés aux stores | Oui |
ios/capacitor-server-cleartext | iOS | server.cleartext n'est pas activé pour la production | Oui |
ios/capacitor-allow-navigation-wildcard | iOS | server.allowNavigation n'est pas un wildcard global | Oui |
ios/pods-not-installed | iOS | Les Pods CocoaPods / workspace sont présents lors de l'utilisation de Pods | Oui |
ios/pods-lock-missing | iOS | Podfile.lock verrouille les versions des pods | Oui |
ios/pods-capacitor-missing | iOS | Podfile configure Capacitor | Oui |
ios/spm-package-resolved-missing | iOS | Le fichier SPM Package.resolved est présent | Oui |
ios/spm-capacitor-dependency-missing | iOS | Package.swift déclare Capacitor | Oui |
ios/appicon-empty-or-placeholder | iOS | AppIcon.appiconset existe et n'est pas vide | Oui |
ios/appicon-referenced-file-missing | iOS | Les fichiers d’icône Contents.json existent sur le disque | Oui |
ios/appicon-marketing-missing | iOS | Une icône marketing de 1024×1024 existe | Oui |
ios/spm-deployment-target-consistency | iOS | La cible de déploiement SPM est cohérente | Oui |
| Id | Plateformes | Ce qu’il vérifie | Application progressive |
|---|---|---|---|
android/keystore-opens | Android | Le keystore Android s'ouvre avec les mots de passe fournis | — |
android/keystore-expiry | Android | Le certificat de signature Android n'est pas expiré | — |
android/cordova-vars-present | Android | cordova.variables.gradle est présent après cap sync | — |
android/gradle-props-heuristics | Android | Heuristiques sur gradle.properties pour les erreurs de build courantes | — |
android/play-sa-json | Android | Le JSON du compte de service Play est présent s'il est configuré | — |
android/flavor-exists | Android | Le flavor de produit demandé existe | — |
android/agp8-package-attr | Android | Attribut package= du manifeste supprimé pour AGP 8+ | — |
android/manifest-well-formed | Android | AndroidManifest.xml est analysé | — |
android/manifest-tag-typo | Android | Fautes de frappe courantes dans les tags de manifest | — |
android/manifest-namespace-uri | Android | L'URI de l'espace de noms xmlns:android est correcte | — |
android/manifest-missing-prefix | Android | Les attributs Android utilisent le préfixe android: | — |
android/manifest-exported-missing | Android | android:exported est défini là où requis | — |
android/manifest-multiple-uses-sdk | Android | Un seul élément uses-sdk | — |
android/manifest-duplicate-component | Android | Aucun composant en double | — |
android/manifest-unique-permission | Android | Les permissions personnalisées sont uniques | — |
android/manifest-hardcoded-debuggable | Android | debuggable=true n'est pas déployé | — |
android/manifest-mock-location | Android | ACCESS_MOCK_LOCATION n'est pas déployé | — |
android/manifest-exported-unprotected | Android | Les composants exportés sont protégés | — |
android/manifest-query-all-packages | Android | Justification de QUERY_ALL_PACKAGES | — |
android/manifest-deeplink-valid | Android | Les intent-filters de deeplink semblent valides | — |
android/applicationid-present | Android | applicationId est déclaré dans app/build.gradle | — |
android/capacitor-build-gradle-applied | Android | capacitor.build.gradle existe lorsqu'il est appliqué | — |
android/gradle-wrapper-present | Android | Les fichiers du wrapper Gradle sont présents | — |
android/flavor-dimensions | Android | Les dimensions de flavor sont déclarées si des flavors existent | — |
android/google-services-file | Android | google-services.json présent lorsque le plugin est appliqué | — |
android/local-properties-committed | Android | local.properties n'est pas commité avec des secrets | — |
android/sdk-floors | Android | les seuils min/compile/target SDK semblent valides | — |
android/target-sdk-play | Android | le targetSdk respecte les exigences du Play Store | — |
android/min-sdk-capacitor | Android | le minSdk respecte les exigences de Capacitor | — |
android/version-fields | Android | versionCode / versionName sont présents | — |
android/play-sa-access | Android | le compte de service Play peut accéder à l'app (à distance) | — |
Exemple : shell Next.js distant / server.url
Section intitulée « Exemple : shell Next.js distant / server.url »Livrer un shell natif qui charge un environnement de production server.url est un pattern Capacitor pris en charge. Prescan le signale ios/capacitor-server-url-shipped car il s’agit souvent d’un reste de live-reload.
Prenez-en acte sans désactiver les autres vérifications :
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shippedOu conservez la visibilité sous forme d’avertissement :
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped