Vai al contenuto

Controlli prescan del build

Prima che Capgo Cloud Build carichi il tuo progetto, CLI esegue un prescan che rileva localmente problemi di credenziali, progetto e configurazione dello store.

Può anche essere eseguito in modalità standalone:

Finestra del terminale
npx @capgo/cli@latest build prescan <appId> --platform ios

Ci sono 80 controlli. È preferibile ignorare singoli ID di controllo piuttosto che disattivare l'intera scansione.

Finestra del terminale
# 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 standalone su build prescan:

Finestra del terminale
npx @capgo/cli@latest build prescan <appId> --platform ios \
--skip ios/capacitor-server-url-shipped \
--warn ios/capacitor-server-cleartext

Gli ID dei check sconosciuti falliscono subito con un errore chiaro.

FlagEffetto
--no-prescanSalta l'intero scan
--prescan-ignore-fatal (o --ignore-fatal su build prescan)Esegui scan, stampa report, non bloccare mai
--fail-on-warningsTratta gli avvisi come fatali (CI)

--no-prescan e --prescan-ignore-fatal nascondi o bypassa tutti le verifiche rimanenti. Usa override per singola verifica quando non sei d'accordo solo con una regola.

Usa l'id esatto in --prescan-skip / --prescan-warn.

Applicazione graduale significa che il rilevamento è solo informativo fino a 2026-08-14, dopodiché può bloccare i build.

IdPiattaformeCosa verificaApplicazione graduale
shared/apikey-permissionios, androidLa chiave API può richiedere build nativi—
shared/app-existsios, androidL'App id esiste ed è visibile alla chiave API—
shared/credentials-savedios, androidLe credenziali iOS/Android richieste sono salvate localmente—
shared/cap-sync-staleios, androidAsset web build e plugin Capacitor sincronizzati—
shared/node-linker-layoutios, androidIl layout di node_modules funziona con i percorsi nativi di Capacitor—
shared/bundle-id-consistencyios, androidL'appId di Capacitor corrisponde al bundle id / applicationId nativo—
IdPiattaformeCosa verificaApplicazione graduale
ios/p12-opensiOSIl file iOS .p12 si apre con la password fornita—
ios/p12-expiryiOSIl certificato di firma iOS non è scaduto—
ios/profile-expiryiOSIl provisioning profile non è scaduto—
ios/profile-bundle-matchiOSIl bundle id del provisioning profile corrisponde all'app—
ios/profile-type-vs-modeiOSIl tipo di profilo corrisponde alla modalità app_store / ad_hoc—
ios/cert-profile-pairingiOSIl certificato è incorporato nel provisioning profile—
ios/targets-coverediOSTutti i target iOS hanno un provisioning profile—
ios/infoplist-sanityiOSInfo.plist contiene le chiavi di versione / identità richieste—
ios/asc-key-validiOSI campi della chiave API di App Store Connect sembrano validi—
ios/asc-key-accessiOSLa chiave API di ASC può accedere all'app (remoto)—
ios/plist-bundle-id-formatiOSIl formato CFBundleIdentifier è validoSì
ios/plist-version-short-formatiOSIl formato di CFBundleShortVersionString è validoSì
ios/plist-version-build-formatiOSIl formato di CFBundleVersion è validoSì
ios/plist-encryption-complianceiOSITSAppUsesNonExemptEncryption è dichiaratoSì
ios/plist-ats-arbitrary-loadsiOSNSAllowsArbitraryLoads non è abilitato in produzioneSì
ios/plist-launch-storyboardiOSLaunch screen dichiarataSì
ios/plist-orientations-multitaskingiOSImpostazioni di orientamento/multitasking coerentiSì
ios/plist-orientations-presentiOSUISupportedInterfaceOrientations dichiarataSì
ios/plist-display-nameiOSDisplay name impostatoSì
ios/plist-background-modes-sanityiOSI valori di UIBackgroundModes sembrano validiSì
ios/plist-scene-lifecycle-xcode27iOSL'app adotta il ciclo di vita UIScene quando si compila con Xcode 27+ (richiesto da iOS 27 SDK)Sì
ios/xcode-deployment-target-capacitoriOSObiettivo di deployment iOS conforme ai requisiti di CapacitorSì
ios/xcode-signing-teamiOSTeam di firma impostatoSì
ios/xcode-bundle-id-mismatch-across-configsiOSBundle id coerente tra le configurazioni XcodeSì
ios/xcode-enable-bitcode-leftoveriOSResiduo ENABLE_BITCODE rimossoSì
ios/xcode-swift-version-sanityiOSImpostazione versione Swift validaSì
ios/xcode-no-app-targetiOSIl progetto Xcode ha un target applicazioneSì
ios/xcode-multiple-app-targetsiOSI target app multipli sono gestiti intenzionalmenteSì
ios/entitlements-vs-profile-capabilityiOSGli entitlements corrispondono alle capacità del profiloSì
ios/entitlements-aps-environment-vs-modeiOSaps-environment corrisponde alla modalità di distribuzioneSì
ios/entitlements-associated-domains-formatiOSIl formato di Associated Domains è validoSì
ios/entitlements-app-groups-formatiOSIl formato di App Groups è validoSì
ios/capacitor-server-url-shippediOSserver.url non è lasciato come endpoint live-reload / remote shell per i build storeSì
ios/capacitor-server-cleartextiOSserver.cleartext non è abilitato per la produzioneSì
ios/capacitor-allow-navigation-wildcardiOSserver.allowNavigation non è un wildcard genericoSì
ios/pods-not-installediOSCocoaPods Pods / workspace presenti quando si usano i PodsSì
ios/pods-lock-missingiOSPodfile.lock fissa le versioni dei podSì
ios/pods-capacitor-missingiOSIl Podfile collega CapacitorSì
ios/spm-package-resolved-missingiOSSPM Package.resolved è presenteSì
ios/spm-capacitor-dependency-missingiOSPackage.swift dichiara CapacitorSì
ios/appicon-empty-or-placeholderiOSAppIcon.appiconset esiste e non è vuotoSì
ios/appicon-referenced-file-missingiOSI file icona di Contents.json esistono su discoSì
ios/appicon-marketing-missingiOSL'icona marketing 1024×1024 esisteSì
ios/spm-deployment-target-consistencyiOSObiettivo di deployment SPM coerenteSì
IdPiattaformeCosa verificaApplicazione graduale
android/keystore-opensAndroidIl keystore Android si apre con le password fornite—
android/keystore-expiryAndroidIl certificato di firma Android non è scaduto—
android/cordova-vars-presentAndroidcordova.variables.gradle è presente dopo cap sync—
android/gradle-props-heuristicsAndroideuristiche in gradle.properties per errori di build comuni—
android/play-sa-jsonAndroidIl JSON dell'account di servizio Play è presente se configurato—
android/flavor-existsAndroidIl product flavor richiesto esiste—
android/agp8-package-attrAndroidAttributo package= del manifest rimosso per AGP 8+—
android/manifest-well-formedAndroidAndroidManifest.xml viene analizzato—
android/manifest-tag-typoAndroidErrori di battitura comuni nei tag del manifest—
android/manifest-namespace-uriAndroidL'URI dello namespace xmlns:android è corretto—
android/manifest-missing-prefixAndroidGli attributi Android usano il prefisso android:—
android/manifest-exported-missingAndroidandroid:exported è impostato dove richiesto—
android/manifest-multiple-uses-sdkAndroidSolo un elemento uses-sdk—
android/manifest-duplicate-componentAndroidNessun componente duplicato—
android/manifest-unique-permissionAndroidI permessi personalizzati sono univoci—
android/manifest-hardcoded-debuggableAndroiddebuggable=true non distribuito—
android/manifest-mock-locationAndroidACCESS_MOCK_LOCATION non distribuito—
android/manifest-exported-unprotectedAndroidI componenti esportati sono protetti—
android/manifest-query-all-packagesAndroidGiustificazione per QUERY_ALL_PACKAGES—
android/manifest-deeplink-validAndroidI deeplink intent-filter sembrano validi—
android/applicationid-presentAndroidapplicationId è dichiarato in app/build.gradle—
android/capacitor-build-gradle-appliedAndroidcapacitor.build.gradle è presente quando viene applicato—
android/gradle-wrapper-presentAndroidI file Gradle wrapper sono presenti—
android/flavor-dimensionsAndroidLe flavor dimensions sono dichiarate se esistono le flavor—
android/google-services-fileAndroidgoogle-services.json presente quando il plugin è applicato—
android/local-properties-committedAndroidlocal.properties non è committato con i secret—
android/sdk-floorsAndroidi floor min/compile/target di SDK sembrano validi—
android/target-sdk-playAndroidtargetSdk soddisfa i requisiti di Play—
android/min-sdk-capacitorAndroidminSdk soddisfa i requisiti di Capacitor—
android/version-fieldsAndroidversionCode / versionName sono presenti—
android/play-sa-accessAndroidl'account di servizio Play può accedere all'app (da remoto)—

Pubblicare una shell nativa che carica una produzione server.url è un pattern Capacitor supportato. Prescan segnala ios/capacitor-server-url-shipped perché è spesso un residuo di live-reload.

Riconoscilo senza disabilitare gli altri controlli:

Finestra del terminale
npx @capgo/cli@latest build request <appId> --platform ios \
--prescan-skip ios/capacitor-server-url-shipped

Oppure mantieni la visibilità come warning:

Finestra del terminale
npx @capgo/cli@latest build request <appId> --platform ios \
--prescan-warn ios/capacitor-server-url-shipped