Aller au contenu

Vérifications prescan du build

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 :

Fenêtre de terminal
npx @capgo/cli@latest build prescan <appId> --platform ios

Il 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.

Fenêtre de terminal
# 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-separated
npx @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-loads

Alias autonomes activés build prescan:

Fenêtre de terminal
npx @capgo/cli@latest build prescan <appId> --platform ios \
--skip ios/capacitor-server-url-shipped \
--warn ios/capacitor-server-cleartext

Unknown check ids fail fast with a clear error.

Échappements globaux (à utiliser avec parcimonie)

Section titled “Global escapes (use sparingly)”
DrapeauEffet
--no-prescanIgnorer l’analyse complète
--prescan-ignore-fatal (ou --ignore-fatal sur build prescan)Run scan, print report, never block
--fail-on-warningsTraiter 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.

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.

IdPlateformesCe qu’il vérifieApplication progressive
shared/apikey-permissionios, androidLa clé API peut demander des builds natifs—
shared/app-existsios, androidL’App id existe et est visible pour la clé API—
shared/credentials-savedios, androidLes identifiants iOS/Android requis sont stockés localement—
shared/cap-sync-staleios, androidAssets web compilés et plugins Capacitor synchronisés—
shared/node-linker-layoutios, androidLa structure node_modules est compatible avec les chemins natifs Capacitor—
shared/bundle-id-consistencyios, androidL'appId Capacitor correspond au bundle id / applicationId natif—
IdPlateformesCe qu’il vérifieApplication progressive
ios/p12-opensiOSLe fichier iOS .p12 s'ouvre avec le mot de passe fourni—
ios/p12-expiryiOSLe certificat de signature iOS n'est pas expiré—
ios/profile-expiryiOSLe profil de provisionnement n'est pas expiré—
ios/profile-bundle-matchiOSProvisioning profile bundle id matches the app—
ios/profile-type-vs-modeiOSLe type de profil correspond au mode app_store / ad_hoc—
ios/cert-profile-pairingiOSLe certificat est intégré au profil de provisionnement—
ios/targets-coverediOSToutes les cibles iOS ont un profil de provisionnement—
ios/infoplist-sanityiOSInfo.plist contient les clés de version / d'identité requises—
ios/asc-key-validiOSLes champs de la clé API d'App Store Connect semblent valides—
ios/asc-key-accessiOSLa clé API d'ASC peut accéder à l'app (à distance)—
ios/plist-bundle-id-formatiOSLe format du CFBundleIdentifier est valideOui
ios/plist-version-short-formatiOSLe format de CFBundleShortVersionString est valideOui
ios/plist-version-build-formatiOSLe format de CFBundleVersion est valideOui
ios/plist-encryption-complianceiOSITSAppUsesNonExemptEncryption est déclaréOui
ios/plist-ats-arbitrary-loadsiOSNSAllowsArbitraryLoads n'est pas activé pour la productionOui
ios/plist-launch-storyboardiOSL’écran de lancement est déclaréOui
ios/plist-orientations-multitaskingiOSLes paramètres d’orientation / multitâche sont cohérentsOui
ios/plist-orientations-presentiOSUISupportedInterfaceOrientations est déclaréOui
ios/plist-display-nameiOSLe nom d’affichage est définiOui
ios/plist-background-modes-sanityiOSLes valeurs UIBackgroundModes semblent validesOui
ios/plist-scene-lifecycle-xcode27iOSL’app adopte le cycle de vie UIScene lors du build avec Xcode 27+ (requis par iOS 27 SDK)Oui
ios/xcode-deployment-target-capacitoriOSLa cible de déploiement iOS répond aux exigences de CapacitorOui
ios/xcode-signing-teamiOSL’équipe de signature est définieOui
ios/xcode-bundle-id-mismatch-across-configsiOSBundle id is consistent across Xcode configsOui
ios/xcode-enable-bitcode-leftoveriOSLe résidu ENABLE_BITCODE a été suppriméOui
ios/xcode-swift-version-sanityiOSLe paramètre de version Swift semble correctOui
ios/xcode-no-app-targetiOSLe projet Xcode possède une cible d’applicationOui
ios/xcode-multiple-app-targetsiOSLes multiples cibles d’application sont gérées intentionnellementOui
ios/entitlements-vs-profile-capabilityiOSLes entitlements correspondent aux capacités du profilOui
ios/entitlements-aps-environment-vs-modeiOSaps-environment correspond au mode de distributionOui
ios/entitlements-associated-domains-formatiOSLe format Associated Domains est valideOui
ios/entitlements-app-groups-formatiOSLe format des App Groups est valideOui
ios/capacitor-server-url-shippediOSserver.url n'est pas laissé comme endpoint de live-reload / shell distant pour les builds destinés aux storesOui
ios/capacitor-server-cleartextiOSserver.cleartext n'est pas activé pour la productionOui
ios/capacitor-allow-navigation-wildcardiOSserver.allowNavigation n'est pas un wildcard globalOui
ios/pods-not-installediOSLes Pods CocoaPods / workspace sont présents lors de l'utilisation de PodsOui
ios/pods-lock-missingiOSPodfile.lock verrouille les versions des podsOui
ios/pods-capacitor-missingiOSPodfile configure CapacitorOui
ios/spm-package-resolved-missingiOSLe fichier SPM Package.resolved est présentOui
ios/spm-capacitor-dependency-missingiOSPackage.swift déclare CapacitorOui
ios/appicon-empty-or-placeholderiOSAppIcon.appiconset existe et n'est pas videOui
ios/appicon-referenced-file-missingiOSLes fichiers d’icône Contents.json existent sur le disqueOui
ios/appicon-marketing-missingiOSUne icône marketing de 1024×1024 existeOui
ios/spm-deployment-target-consistencyiOSLa cible de déploiement SPM est cohérenteOui
IdPlateformesCe qu’il vérifieApplication progressive
android/keystore-opensAndroidLe keystore Android s'ouvre avec les mots de passe fournis—
android/keystore-expiryAndroidLe certificat de signature Android n'est pas expiré—
android/cordova-vars-presentAndroidcordova.variables.gradle est présent après cap sync—
android/gradle-props-heuristicsAndroidHeuristiques sur gradle.properties pour les erreurs de build courantes—
android/play-sa-jsonAndroidLe JSON du compte de service Play est présent s'il est configuré—
android/flavor-existsAndroidLe flavor de produit demandé existe—
android/agp8-package-attrAndroidAttribut package= du manifeste supprimé pour AGP 8+—
android/manifest-well-formedAndroidAndroidManifest.xml est analysé—
android/manifest-tag-typoAndroidFautes de frappe courantes dans les tags de manifest—
android/manifest-namespace-uriAndroidL'URI de l'espace de noms xmlns:android est correcte—
android/manifest-missing-prefixAndroidLes attributs Android utilisent le préfixe android:—
android/manifest-exported-missingAndroidandroid:exported est défini là où requis—
android/manifest-multiple-uses-sdkAndroidUn seul élément uses-sdk—
android/manifest-duplicate-componentAndroidAucun composant en double—
android/manifest-unique-permissionAndroidLes permissions personnalisées sont uniques—
android/manifest-hardcoded-debuggableAndroiddebuggable=true n'est pas déployé—
android/manifest-mock-locationAndroidACCESS_MOCK_LOCATION n'est pas déployé—
android/manifest-exported-unprotectedAndroidLes composants exportés sont protégés—
android/manifest-query-all-packagesAndroidJustification de QUERY_ALL_PACKAGES—
android/manifest-deeplink-validAndroidLes intent-filters de deeplink semblent valides—
android/applicationid-presentAndroidapplicationId est déclaré dans app/build.gradle—
android/capacitor-build-gradle-appliedAndroidcapacitor.build.gradle existe lorsqu'il est appliqué—
android/gradle-wrapper-presentAndroidLes fichiers du wrapper Gradle sont présents—
android/flavor-dimensionsAndroidLes dimensions de flavor sont déclarées si des flavors existent—
android/google-services-fileAndroidgoogle-services.json présent lorsque le plugin est appliqué—
android/local-properties-committedAndroidlocal.properties n'est pas commité avec des secrets—
android/sdk-floorsAndroidles seuils min/compile/target SDK semblent valides—
android/target-sdk-playAndroidle targetSdk respecte les exigences du Play Store—
android/min-sdk-capacitorAndroidle minSdk respecte les exigences de Capacitor—
android/version-fieldsAndroidversionCode / versionName sont présents—
android/play-sa-accessAndroidle compte de service Play peut accéder à l'app (à distance)—

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 :

Fenêtre de terminal
npx @capgo/cli@latest build request <appId> --platform ios \
--prescan-skip ios/capacitor-server-url-shipped

Ou conservez la visibilité sous forme d’avertissement :

Fenêtre de terminal
npx @capgo/cli@latest build request <appId> --platform ios \
--prescan-warn ios/capacitor-server-url-shipped