Zum Inhalt springen

Build-Prescan-Checks

Bevor Capgo Cloud Build Ihr Projekt hochlädt, führt CLI eine Prescan die Credential-, Projekt- und Store-Config-Probleme lokal erkennt.

Es läuft auch standalone:

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

Es gibt 80 Checks. Es ist besser, einzelne Check-IDs zu ignorieren, als den gesamten Scan zu deaktivieren.

Terminalfenster
# 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

Standalone-Aliase auf build prescan:

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

Unbekannte Check-IDs führen sofort zu einem klaren Fehler.

FlaggeEffekt
--no-prescanDen gesamten Scan überspringen
--prescan-ignore-fatal (oder --ignore-fatal auf build prescan)Scan ausführen, Report ausgeben, nie blockieren
--fail-on-warningsWarnungen als Fehler behandeln (CI)

--no-prescan und --prescan-ignore-fatal ausblenden oder umgehen alle verbleibende Checks. Nutze stattdessen Overrides pro Check, wenn du nur mit einer Regel nicht einverstanden bist.

Verwende die exakte ID in --prescan-skip / --prescan-warn.

Schrittweise erzwingen bedeutet, dass der Befund nur zur Information dient, bis 2026-08-14, kann es Builds blockieren.

IDPlattformenWas geprüft wirdSchrittweise erzwingen
shared/apikey-permissionios, androidAPI-Key kann native Builds anfordern—
shared/app-existsios, androidApp-ID existiert und ist für den API-Schlüssel sichtbar—
shared/credentials-savedios, androidErforderliche iOS-/Android-Zugangsdaten werden lokal gespeichert—
shared/cap-sync-staleios, androidWeb-Assets gebaut und Capacitor-Plugins synchronisiert—
shared/node-linker-layoutios, androidnode_modules-Struktur funktioniert mit Capacitor-Native-Pfaden—
shared/bundle-id-consistencyios, androidCapacitor appId entspricht der nativen Bundle-ID / applicationId—
IDPlattformenWas geprüft wirdSchrittweise erzwingen
ios/p12-opensiOSiOS .p12 lässt sich mit dem angegebenen Passwort öffnen—
ios/p12-expiryiOSiOS-Signierungszertifikat ist nicht abgelaufen—
ios/profile-expiryiOSProvisioning-Profil ist nicht abgelaufen—
ios/profile-bundle-matchiOSBundle-ID des Provisioning-Profils stimmt mit der App überein—
ios/profile-type-vs-modeiOSProfiltyp entspricht app_store / ad_hoc-Modus—
ios/cert-profile-pairingiOSZertifikat ist im Provisioning Profile eingebettet—
ios/targets-coverediOSAlle iOS-Targets haben ein Provisioning Profile—
ios/infoplist-sanityiOSInfo.plist enthält erforderliche Version- und Identity-Keys—
ios/asc-key-validiOSApp Store Connect API Key-Felder sehen gültig aus—
ios/asc-key-accessiOSASC API Key kann auf die App zugreifen (remote)—
ios/plist-bundle-id-formatiOSCFBundleIdentifier-Format ist gültigJa
ios/plist-version-short-formatiOSCFBundleShortVersionString-Format ist gültigJa
ios/plist-version-build-formatiOSCFBundleVersion-Format ist gültigJa
ios/plist-encryption-complianceiOSITSAppUsesNonExemptEncryption ist deklariertJa
ios/plist-ats-arbitrary-loadsiOSNSAllowsArbitraryLoads ist in der Produktion nicht aktiviertJa
ios/plist-launch-storyboardiOSStartbildschirm ist deklariertJa
ios/plist-orientations-multitaskingiOSEinstellungen für Ausrichtung / Multitasking sind konsistentJa
ios/plist-orientations-presentiOSUISupportedInterfaceOrientations ist deklariertJa
ios/plist-display-nameiOSAnzeigename ist festgelegtJa
ios/plist-background-modes-sanityiOSUIBackgroundModes-Werte sind gültigJa
ios/plist-scene-lifecycle-xcode27iOSDie App nutzt den UIScene-Lebenszyklus beim Build mit Xcode 27+ (erforderlich durch iOS 27 SDK)Ja
ios/xcode-deployment-target-capacitoriOSiOS-Deployment-Target erfüllt die Capacitor-AnforderungenJa
ios/xcode-signing-teamiOSSigning-Team ist festgelegtJa
ios/xcode-bundle-id-mismatch-across-configsiOSBundle-ID ist in allen Xcode-Konfigurationen konsistentJa
ios/xcode-enable-bitcode-leftoveriOSENABLE_BITCODE-Rest wurde entferntJa
ios/xcode-swift-version-sanityiOSSwift-Versionseinstellung sieht plausibel ausJa
ios/xcode-no-app-targetiOSXcode-Projekt hat ein Application-TargetJa
ios/xcode-multiple-app-targetsiOSMehrere App-Targets werden bewusst behandeltJa
ios/entitlements-vs-profile-capabilityiOSEntitlements stimmen mit den Profil-Capabilities übereinJa
ios/entitlements-aps-environment-vs-modeiOSaps-environment passt zum Distribution-ModusJa
ios/entitlements-associated-domains-formatiOSFormat der Associated Domains ist gültigJa
ios/entitlements-app-groups-formatiOSApp-Groups-Format ist gültigJa
ios/capacitor-server-url-shippediOSserver.url ist für Store-Builds nicht als Live-Reload- oder Remote-Shell-Endpunkt konfiguriertJa
ios/capacitor-server-cleartextiOSserver.cleartext ist für Produktion nicht aktiviertJa
ios/capacitor-allow-navigation-wildcardiOSserver.allowNavigation ist keine pauschale WildcardJa
ios/pods-not-installediOSCocoaPods Pods / workspace sind vorhanden, wenn Pods genutzt werdenJa
ios/pods-lock-missingiOSPodfile.lock fixiert die Pod-VersionenJa
ios/pods-capacitor-missingiOSPodfile verknüpft CapacitorJa
ios/spm-package-resolved-missingiOSSPM Package.resolved ist vorhandenJa
ios/spm-capacitor-dependency-missingiOSPackage.swift deklariert CapacitorJa
ios/appicon-empty-or-placeholderiOSAppIcon.appiconset existiert und ist nicht leerJa
ios/appicon-referenced-file-missingiOSContents.json-Icondateien existieren auf der FestplatteJa
ios/appicon-marketing-missingiOSMarketing-Icon 1024×1024 vorhandenJa
ios/spm-deployment-target-consistencyiOSSPM-Deployment-Target ist konsistentJa
IDPlattformenWas geprüft wirdSchrittweise erzwingen
android/keystore-opensAndroidAndroid-Keystore öffnet sich mit den angegebenen Passwörtern—
android/keystore-expiryAndroidAndroid-Signaturzertifikat ist nicht abgelaufen—
android/cordova-vars-presentAndroidcordova.variables.gradle ist nach cap sync vorhanden—
android/gradle-props-heuristicsAndroidgradle.properties-Heuristiken für häufige Build-Fehler—
android/play-sa-jsonAndroidPlay-Service-Account-JSON ist vorhanden, wenn konfiguriert—
android/flavor-existsAndroidAngeforderter Product Flavor existiert—
android/agp8-package-attrAndroidpackage=-Attribut im Manifest für AGP 8+ entfernt—
android/manifest-well-formedAndroidAndroidManifest.xml wird geparst—
android/manifest-tag-typoAndroidHäufige Tippfehler in Manifest-Tags—
android/manifest-namespace-uriAndroidxmlns:android Namespace-URI ist korrekt—
android/manifest-missing-prefixAndroidAndroid-Attribute verwenden das android:-Präfix—
android/manifest-exported-missingAndroidandroid:exported ist dort gesetzt, wo erforderlich—
android/manifest-multiple-uses-sdkAndroidNur ein uses-sdk-Element—
android/manifest-duplicate-componentAndroidKeine doppelten Komponenten—
android/manifest-unique-permissionAndroidEigene Berechtigungen sind eindeutig—
android/manifest-hardcoded-debuggableAndroiddebuggable=true nicht enthalten—
android/manifest-mock-locationAndroidACCESS_MOCK_LOCATION nicht enthalten—
android/manifest-exported-unprotectedAndroidExportierte Komponenten sind geschützt—
android/manifest-query-all-packagesAndroidBegründung für QUERY_ALL_PACKAGES—
android/manifest-deeplink-validAndroidDeeplink-Intent-Filter sehen gültig aus—
android/applicationid-presentAndroidapplicationId ist in app/build.gradle deklariert—
android/capacitor-build-gradle-appliedAndroidcapacitor.build.gradle existiert bei Anwendung—
android/gradle-wrapper-presentAndroidGradle-Wrapper-Dateien sind vorhanden—
android/flavor-dimensionsAndroidFlavor-Dimensionen sind deklariert, wenn Flavors existieren—
android/google-services-fileAndroidgoogle-services.json vorhanden, wenn das Plugin angewendet wird—
android/local-properties-committedAndroidlocal.properties wird nicht mit Secrets committet—
android/sdk-floorsAndroidmin/compile/target SDK-Mindestwerte sehen gültig aus—
android/target-sdk-playAndroidtargetSdk erfüllt die Play-Anforderungen—
android/min-sdk-capacitorAndroidminSdk erfüllt die Capacitor-Anforderungen—
android/version-fieldsAndroidversionCode / versionName sind vorhanden—
android/play-sa-accessAndroidPlay-Service-Account kann auf die App zugreifen (remote)—

Auslieferung einer nativen Shell, die eine Produktion lädt server.url ist ein unterstütztes Capacitor-Muster. Prescan markiert ios/capacitor-server-url-shipped da es oft ein Live-Reload-Rest ist.

Bestätigen Sie es, ohne andere Checks zu deaktivieren:

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

Oder behalten Sie die Sichtbarkeit als Warnung bei:

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