Controlli prescan del build
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
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:
npx @capgo/cli@latest build prescan <appId> --platform iosCi sono 80 controlli. È preferibile ignorare singoli ID di controllo piuttosto che disattivare l'intera scansione.
Ignora check specifici
Sezione intitolata “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-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 standalone su build prescan:
npx @capgo/cli@latest build prescan <appId> --platform ios \ --skip ios/capacitor-server-url-shipped \ --warn ios/capacitor-server-cleartextGli ID dei check sconosciuti falliscono subito con un errore chiaro.
Escape globali (usa con cautela)
Sezione dal titolo “Escape globali (da usare con moderazione)”| Flag | Effetto |
|---|---|
--no-prescan | Salta l'intero scan |
--prescan-ignore-fatal (o --ignore-fatal su build prescan) | Esegui scan, stampa report, non bloccare mai |
--fail-on-warnings | Tratta 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.
Controlla il catalogo
Sezione intitolata “Catalogo verifiche”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.
Condivisi
Sezione intitolata “Shared”| Id | Piattaforme | Cosa verifica | Applicazione graduale |
|---|---|---|---|
shared/apikey-permission | ios, android | La chiave API può richiedere build nativi | — |
shared/app-exists | ios, android | L'App id esiste ed è visibile alla chiave API | — |
shared/credentials-saved | ios, android | Le credenziali iOS/Android richieste sono salvate localmente | — |
shared/cap-sync-stale | ios, android | Asset web build e plugin Capacitor sincronizzati | — |
shared/node-linker-layout | ios, android | Il layout di node_modules funziona con i percorsi nativi di Capacitor | — |
shared/bundle-id-consistency | ios, android | L'appId di Capacitor corrisponde al bundle id / applicationId nativo | — |
| Id | Piattaforme | Cosa verifica | Applicazione graduale |
|---|---|---|---|
ios/p12-opens | iOS | Il file iOS .p12 si apre con la password fornita | — |
ios/p12-expiry | iOS | Il certificato di firma iOS non è scaduto | — |
ios/profile-expiry | iOS | Il provisioning profile non è scaduto | — |
ios/profile-bundle-match | iOS | Il bundle id del provisioning profile corrisponde all'app | — |
ios/profile-type-vs-mode | iOS | Il tipo di profilo corrisponde alla modalità app_store / ad_hoc | — |
ios/cert-profile-pairing | iOS | Il certificato è incorporato nel provisioning profile | — |
ios/targets-covered | iOS | Tutti i target iOS hanno un provisioning profile | — |
ios/infoplist-sanity | iOS | Info.plist contiene le chiavi di versione / identità richieste | — |
ios/asc-key-valid | iOS | I campi della chiave API di App Store Connect sembrano validi | — |
ios/asc-key-access | iOS | La chiave API di ASC può accedere all'app (remoto) | — |
ios/plist-bundle-id-format | iOS | Il formato 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 | ITSAppUsesNonExemptEncryption è dichiarato | Sì |
ios/plist-ats-arbitrary-loads | iOS | NSAllowsArbitraryLoads non è abilitato in produzione | Sì |
ios/plist-launch-storyboard | iOS | Launch screen dichiarata | Sì |
ios/plist-orientations-multitasking | iOS | Impostazioni di orientamento/multitasking coerenti | Sì |
ios/plist-orientations-present | iOS | UISupportedInterfaceOrientations dichiarata | Sì |
ios/plist-display-name | iOS | Display name impostato | Sì |
ios/plist-background-modes-sanity | iOS | I valori di UIBackgroundModes sembrano validi | Sì |
ios/plist-scene-lifecycle-xcode27 | iOS | L'app adotta il ciclo di vita UIScene quando si compila con Xcode 27+ (richiesto da iOS 27 SDK) | Sì |
ios/xcode-deployment-target-capacitor | iOS | Obiettivo di deployment iOS conforme ai requisiti di Capacitor | Sì |
ios/xcode-signing-team | iOS | Team di firma impostato | Sì |
ios/xcode-bundle-id-mismatch-across-configs | iOS | Bundle id coerente tra le configurazioni Xcode | Sì |
ios/xcode-enable-bitcode-leftover | iOS | Residuo ENABLE_BITCODE rimosso | Sì |
ios/xcode-swift-version-sanity | iOS | Impostazione versione Swift valida | Sì |
ios/xcode-no-app-target | iOS | Il progetto Xcode ha un target applicazione | Sì |
ios/xcode-multiple-app-targets | iOS | I target app multipli sono gestiti intenzionalmente | Sì |
ios/entitlements-vs-profile-capability | iOS | Gli entitlements corrispondono alle capacità del profilo | Sì |
ios/entitlements-aps-environment-vs-mode | iOS | aps-environment corrisponde alla modalità di distribuzione | Sì |
ios/entitlements-associated-domains-format | iOS | Il formato di Associated Domains è valido | Sì |
ios/entitlements-app-groups-format | iOS | Il formato di App Groups è valido | Sì |
ios/capacitor-server-url-shipped | iOS | server.url non è lasciato come endpoint live-reload / remote shell per i build 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 generico | Sì |
ios/pods-not-installed | iOS | CocoaPods Pods / workspace presenti quando si usano i Pods | Sì |
ios/pods-lock-missing | iOS | Podfile.lock fissa le versioni dei pod | Sì |
ios/pods-capacitor-missing | iOS | Il Podfile collega 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 | AppIcon.appiconset esiste e non è vuoto | Sì |
ios/appicon-referenced-file-missing | iOS | I file icona di Contents.json esistono su disco | Sì |
ios/appicon-marketing-missing | iOS | L'icona marketing 1024×1024 esiste | Sì |
ios/spm-deployment-target-consistency | iOS | Obiettivo di deployment SPM coerente | Sì |
Android
Sezione intitolata “Android”| Id | Piattaforme | Cosa verifica | Applicazione graduale |
|---|---|---|---|
android/keystore-opens | Android | Il keystore Android si apre con le password fornite | — |
android/keystore-expiry | Android | Il certificato di firma Android non è scaduto | — |
android/cordova-vars-present | Android | cordova.variables.gradle è presente dopo cap sync | — |
android/gradle-props-heuristics | Android | euristiche in gradle.properties per errori di build comuni | — |
android/play-sa-json | Android | Il JSON dell'account di servizio Play è presente se configurato | — |
android/flavor-exists | Android | Il product flavor richiesto esiste | — |
android/agp8-package-attr | Android | Attributo package= del manifest rimosso per AGP 8+ | — |
android/manifest-well-formed | Android | AndroidManifest.xml viene analizzato | — |
android/manifest-tag-typo | Android | Errori di battitura comuni nei tag del manifest | — |
android/manifest-namespace-uri | Android | L'URI dello namespace xmlns:android è corretto | — |
android/manifest-missing-prefix | Android | Gli attributi Android usano il prefisso android: | — |
android/manifest-exported-missing | Android | android:exported è impostato dove richiesto | — |
android/manifest-multiple-uses-sdk | Android | Solo un elemento uses-sdk | — |
android/manifest-duplicate-component | Android | Nessun componente duplicato | — |
android/manifest-unique-permission | Android | I permessi personalizzati sono univoci | — |
android/manifest-hardcoded-debuggable | Android | debuggable=true non distribuito | — |
android/manifest-mock-location | Android | ACCESS_MOCK_LOCATION non distribuito | — |
android/manifest-exported-unprotected | Android | I componenti esportati sono protetti | — |
android/manifest-query-all-packages | Android | Giustificazione per QUERY_ALL_PACKAGES | — |
android/manifest-deeplink-valid | Android | I deeplink intent-filter sembrano validi | — |
android/applicationid-present | Android | applicationId è dichiarato in app/build.gradle | — |
android/capacitor-build-gradle-applied | Android | capacitor.build.gradle è presente quando viene applicato | — |
android/gradle-wrapper-present | Android | I file Gradle wrapper sono presenti | — |
android/flavor-dimensions | Android | Le flavor dimensions sono dichiarate se esistono le flavor | — |
android/google-services-file | Android | google-services.json presente quando il plugin è applicato | — |
android/local-properties-committed | Android | local.properties non è committato con i secret | — |
android/sdk-floors | Android | i floor min/compile/target di SDK sembrano validi | — |
android/target-sdk-play | Android | targetSdk soddisfa i requisiti di Play | — |
android/min-sdk-capacitor | Android | minSdk soddisfa i requisiti di Capacitor | — |
android/version-fields | Android | versionCode / versionName sono presenti | — |
android/play-sa-access | Android | l'account di servizio Play può accedere all'app (da remoto) | — |
Esempio: shell remota Next.js / server.url
Sezione intitolata “Esempio: shell remote Next.js / server.url”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:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shippedOppure mantieni la visibilità come warning:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped