Esegui controlli di prescan

Prima di Capgo Cloud Build carica il tuo progetto, il CLI esegue una prescan che individua problemi di credenziali, progetto e configurazione di archiviazione localmente.

Esegue anche in modo autonomo:

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

Ci sono 80 controlli oggi. È preferibile ignorare gli ID dei controlli individuali piuttosto che disabilitare tutta la scansione.

Ignora controlli specifici

# 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 abilitati build prescan:

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

I codici di controllo sconosciuti falliscono rapidamente con un chiaro errore.

Suggerimento

Richiesto @capgo/cli@latest con supporto per override per check. Preferisci --prescan-skip / --prescan-warn così ogni altro check tutela ancora la tua build.

Evasioni globali (utilizzale con parsimonia)

Bandiera	Effetto
--no-prescan	Saltare l'intero scan
--prescan-ignore-fatal (o --ignore-fatal su build prescan)	Eseguire lo scan, stampare il report, mai bloccare
--fail-on-warnings	Considerare le avvertenze come fatali (CI)

--no-prescan e --prescan-ignore-fatal nascondere o bypassare tutti i controlli rimanenti. Utilizzare gli override per controllo al posto di questo quando si disaccorda solo con una regola.

Catalogo di controlli

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

Applica gradualmente significa che la scoperta è informatica fino a 2026-08-14, poi può bloccare le compilazioni.

Condiviso

Id	Piattaforme	Cosa controlla	Applica gradualmente
shared/apikey-permission	ios, android	La chiave API può richiedere costruzioni native	—
shared/app-exists	ios, android	L'ID dell'app esiste e è visibile alla chiave API	—
shared/credentials-saved	ios, android	I credenziali iOS/Android richiesti sono salvati localmente	—
shared/cap-sync-stale	ios, android	Gli asset web sono stati costruiti e i plugin Capacitor sono sincronizzati	—
shared/node-linker-layout	ios, android	La struttura di node_modules funziona con le percorsi native Capacitor	—
shared/bundle-id-consistency	ios, android	L'ID dell'app Capacitor corrisponde all'ID pacchetto nativo / applicationId	—

iOS

Id	Piattaforme	Cosa controlla	Applicazione graduale
ios/p12-opens	ios	Certificato .p12 iOS apre con la password fornita	—
ios/p12-expiry	Certificato di firma iOS non è scaduto	Profilo di provisioning iOS non è scaduto	—
ios/profile-expiry	ios	iOS	—
ios/profile-bundle-match	iOS	Il bundle id del profilo di provisioning corrisponde all'app	—
ios/profile-type-vs-mode	ios	Il tipo di profilo corrisponde al modello app_store / ad_hoc	—
ios/cert-profile-pairing	ios	La certificazione è incorporata nel profilo di provisioning	—
ios/targets-covered	ios	Tutti i target iOS hanno un profilo di provisioning	—
ios/infoplist-sanity	ios	Info.plist contiene chiavi versione / identità richieste	—
ios/asc-key-valid	ios	I campi chiave di App Store Connect API sembrano validi	—
ios/asc-key-access	ios	L'ASC API chiave può accedere all'applicazione (remota)	—
ios/plist-bundle-id-format	ios	Il formato di CFBundleIdentifier è valido	Sì
ios/plist-version-short-format	ios	Il formato di CFBundleShortVersionString è valido	Sì
ios/plist-version-build-format	ios	Il formato di CFBundleVersion è valido	Sì
ios/plist-encryption-compliance	ios	È dichiarato ITSAppUsesNonExemptEncryption	Sì
ios/plist-ats-arbitrary-loads	ios	NSAllowsArbitraryLoads non è abilitato per la produzione	Sì
ios/plist-launch-storyboard	ios	Lo schermo di lancio è dichiarato	Sì
ios/plist-orientations-multitasking	ios	Impostazioni orientamento/multitasking sono coerenti	Sì
ios/plist-orientations-present	ios	UISupportedInterfaceOrientations è dichiarato	Sì
ios/plist-display-name	ios	Il nome di visualizzazione è impostato	Sì
ios/plist-background-modes-sanity	ios	I valori di UIBackgroundModes sembrano validi	Sì
ios/xcode-deployment-target-capacitor	ios	L'obiettivo di distribuzione iOS soddisfa i requisiti di Capacitor	Sì
ios/xcode-signing-team	ios	Il team di firma è impostato	Si
ios/xcode-bundle-id-mismatch-across-configs	ios	L'ID del bundle è coerente tra le configurazioni di Xcode	Si
ios/xcode-enable-bitcode-leftover	ios	È rimossa la residua di ENABLE_BITCODE	Si
ios/xcode-swift-version-sanity	ios	La configurazione della versione Swift sembra sana	Si
ios/xcode-no-app-target	ios	Progetto Xcode ha un obiettivo di applicazione	Sì
ios/xcode-multiple-app-targets	ios	Il targeting di applicazioni multiple viene gestito intenzionalmente	Sì
ios/entitlements-vs-profile-capability	ios	I diritti di entitlement corrispondono alle capacità del profilo	Sì
ios/entitlements-aps-environment-vs-mode	ios	aps-environment corrisponde al modello di distribuzione	Sì
ios/entitlements-associated-domains-format	ios	Il formato dei domini associati è valido	Sì
ios/entitlements-app-groups-format	ios	La formattazione di App Groups è valida	Sì
ios/capacitor-server-url-shipped	ios	server.url non lascia il / endpoint di caricamento remoto live per le costruzioni di store	Sì
ios/capacitor-server-cleartext	ios	server.cleartext non è abilitato per la produzione	Sì
ios/capacitor-allow-navigation-wildcard	ios	server.allowNavigation non è un wildcard a strisce per tutti	Sì
ios/pods-not-installed	ios	Sono presenti CocoaPods Pods / workspace quando si utilizzano Pods	Sì
ios/pods-lock-missing	ios	Podfile.lock blocca le versioni dei pod	Sì
ios/pods-capacitor-missing	ios	Podfile gestisce Capacitor	Sì
ios/spm-package-resolved-missing	ios	SPM Package.resolved è presente	Sì
ios/spm-capacitor-dependency-missing	ios	Package.swift dichiara Capacitor	Sì
ios/appicon-empty-or-placeholder	ios	L'app iconset esiste e non è vuota	Sì
ios/appicon-referenced-file-missing	ios	I file icon di Contents.json esistono sul disco	Sì
ios/appicon-marketing-missing	ios	L'icona di marketing 1024×1024 esiste	Sì
ios/spm-deployment-target-consistency	ios	Il target di distribuzione SPM è coerente	Sì

Android

Id	Piattaforme	Cosa controlla	Applica gradualmente
android/keystore-opens	android	La chiave di Android apre con le password fornite	—
android/keystore-expiry	lingua Android	La certificazione di firma Android non è scaduta	—
android/cordova-vars-present	lingua Android	Il file cordova.variables.gradle è presente dopo la sincronizzazione di Capgo	—
android/gradle-props-heuristics	lingua Android	Le heuristichè per i problemi di build comuni nel file gradle.properties	—
android/play-sa-json	lingua Android	La chiave JSON del servizio Play è presente quando configurata	—
android/flavor-exists	lingua Android	Il flavor del prodotto richiesto esiste	—
android/agp8-package-attr	lingua Android	L'attributo package del manifesto è stato rimosso per AGP 8+	—
android/manifest-well-formed	android	Il file AndroidManifest.xml viene elaborato	—
android/manifest-tag-typo	android	Tipi di tag manifest comuni	—
android/manifest-namespace-uri	android	L'URI di namespace xmlns:android è corretto	—
android/manifest-missing-prefix	android	Le proprietà Android utilizzano il prefisso android:	—
android/manifest-exported-missing	android	La proprietà android:exported è impostata dove richiesto	—
android/manifest-multiple-uses-sdk	android	Solo un elemento uses-sdk è utilizzato	—
android/manifest-duplicate-component	Android	No componenti duplicati	—
android/manifest-unique-permission	Android	I permessi personalizzati sono unici	—
android/manifest-hardcoded-debuggable	Android	debuggable=true non viene spedito	—
android/manifest-mock-location	Android	ACCESS_MOCK_LOCATION non viene spedito	—
android/manifest-exported-unprotected	Android	I componenti esportati sono protetti	—
android/manifest-query-all-packages	Android	Giustificazione di QUERY_ALL_PACKAGES	—
android/manifest-deeplink-valid	android	I link di intent-filters di Deeplink sembrano validi	—
android/applicationid-present	android	L'ID dell'applicazione è dichiarato in app/build.gradle	—
android/capacitor-build-gradle-applied	android	capacitor.build.gradle esiste quando viene applicato	—
android/gradle-wrapper-present	android	Sono presenti i file del wrapper Gradle	—
android/flavor-dimensions	android	Le dimensioni dei gusti sono dichiarate quando esistono gusti	—
android/google-services-file	android	google-services.json è presente quando viene applicato il plugin	—
android/local-properties-committed	Android	Il file local.properties non è stato commesso con le informazioni segrete.	—
android/sdk-floors	Android	I min/compile/target SDK piani sembrano validi.	—
android/target-sdk-play	Android	I requisiti di targetSdk sono soddisfatti da Play.	—
android/min-sdk-capacitor	Android	I requisiti di minSdk sono soddisfatti da Capacitor.	—
android/version-fields	Android	I valori di versionCode e versionName sono presenti.	—
android/play-sa-access	Android	L'account dei servizi di Play può accedere all'applicazione (remota).	—

Esempio: shell remoto Next.js / server.url shell

Inviare un shell nativo che carica una produzione server.url è un pattern Capacitor supportato. I flag di pre-scans ios/capacitor-server-url-shipped perché spesso è un residuo di live-reload.

Riconosciarlo senza disabilitare altre verifiche:

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

O mantieni la visibilità come avviso:

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

Relazioni

Inizia a utilizzare Creare il primo Capgo Cloud Build.

Risolvere i problemi Fallimenti e soluzioni comuni per Cloud Build.

Riferimento al CLI build. Opzioni per il comando di richiesta / prescan del build completo.