Prüfung von Build-Vorgängen

Bevor Capgo Cloud Build Ihr Projekt hochlädt, läuft der CLI eine Vorabscannung die lokale Probleme mit Anmeldeinformationen, Projekten und Store-Konfigurationen aufgreift.

Sie läuft auch standalone:

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

Es gibt 80 Überprüfungen heute. Es ist besser, einzelne Überprüfungs-IDs zu ignorieren, als die gesamte Scannung auszuschalten.

Ignorieren Sie bestimmte Überprüfungen

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

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

Unbekannte Check-IDs scheitern schnell mit einer klaren Fehlermeldung.

Tipps

Benötigt @capgo/cli@latest mit Unterstützung für pro-Check-Überprüfungen. Vorziehen Sie --prescan-skip / --prescan-warn damit jeder andere Check immer noch Ihren Build schützt.

Globale Escape-Sequenzen (verwenden Sie sie sparsam)

Flagge	Wirkung
--no-prescan	Den gesamten Scan überspringen
--prescan-ignore-fatal oder --ignore-fatal auf build prescan)	Skanne, Bericht drucken, nie blockieren
--fail-on-warnings	Warnungen als fatal behandeln (CI)

--no-prescan und --prescan-ignore-fatal alle verbleibenden Prüfungen ausblenden. Verwenden Sie stattdessen per-Prüfungs-Überprüfungen, wenn Sie nur mit einer Regel unzufrieden sind. alle verbleibenden Prüfungen ausblenden hide or bypass

Katalog überprüfen

Verwenden Sie den genauen ID --prescan-skip / --prescan-warn.

Schrittweise durchsetzen bezeichnet, dass die Ergebnisse nur informell sind, bis 2026-08-14dann kann es die Builds blockieren.

Gemeinsam

ID	Plattformen	Was es überprüft	Schrittweise durchsetzen
shared/apikey-permission	iOS, Android	API-Schlüssel kann native Builds anfordern	—
shared/app-exists	iOS, Android	App-ID existiert und ist für den API-Schlüssel sichtbar	—
shared/credentials-saved	iOS, Android	Benötigte iOS/Android-Anmeldeinformationen werden lokal gespeichert	—
shared/cap-sync-stale	iOS, Android	Web-Assets werden erstellt und Capacitor-Plugins synchronisiert	—
shared/node-linker-layout	iOS, Android	node_modules-Layout funktioniert mit Capacitor-native Pfaden	—
shared/bundle-id-consistency	iOS, Android	Capacitor-App-ID entspricht native Bundle-ID / ApplicationId	—

iOS

Id	Plattformen	Was es überprüft	Schrittweise durchsetzen
ios/p12-opens	iOS	iOS-Zertifikat (.p12) öffnet sich mit der bereitgestellten Passwort	—
ios/p12-expiry	iOS	iOS-Zertifikat ist nicht abgelaufen	—
ios/profile-expiry	iOS	Provisioning-Profil ist nicht abgelaufen	—
ios/profile-bundle-match	iOS	Die Bereitstellungsserverprofil-ID entspricht der App	—
ios/profile-type-vs-mode	iOS	Das Profiltyp entspricht der App-Store- / Ad-hoc-Modus	—
ios/cert-profile-pairing	iOS	Das Zertifikat ist im Bereitstellungsserverprofil eingebettet	—
ios/targets-covered	iOS	Alle iOS-Ziele haben ein Bereitstellungsserverprofil	—
ios/infoplist-sanity	iOS	Info.plist hat die erforderlichen Version / Identitäts-Schlüssel	—
ios/asc-key-valid	iOS	App Store Connect API-Schlüsselfelder sehen gültig aus	—
ios/asc-key-access	iOS	Ein ASC API-Schlüssel kann auf die App (remote) zugreifen.	—
ios/plist-bundle-id-format	iOS	Die CFBundleIdentifier-Formatierung ist gültig.	Ja
ios/plist-version-short-format	iOS	Die CFBundleShortVersionString-Formatierung ist gültig.	Ja
ios/plist-version-build-format	iOS	Die CFBundleVersion-Formatierung ist gültig.	Ja
ios/plist-encryption-compliance	iOS	ITSAppUsesNonExemptEncryption ist deklariert	Ja
ios/plist-ats-arbitrary-loads	iOS	NSAllowsArbitraryLoads ist für die Produktion nicht aktiviert	Ja
ios/plist-launch-storyboard	iOS	Die Startbildschirm-Deklaration ist vorhanden	Ja
ios/plist-orientations-multitasking	iOS	Die Orientierung- und Multitasking-Einstellungen sind konsistent	Ja
ios/plist-orientations-present	iOS	UISupportedInterfaceOrientations wird deklariert	Ja
ios/plist-display-name	iOS	Der Anzeigename ist gesetzt	Ja
ios/plist-background-modes-sanity	iOS	Die UIBackgroundModes-Werte sehen gültig aus	Ja
ios/xcode-deployment-target-capacitor	iOS	Das iOS-Deploymentziel erfüllt die Anforderungen von Capacitor	Ja
ios/xcode-signing-team	iOS	Signier-Team ist eingestellt	Ja
ios/xcode-bundle-id-mismatch-across-configs	iOS	Bundle-ID ist konsistent über Xcode-Konfigurationen	Ja
ios/xcode-enable-bitcode-leftover	iOS	ENABLE_BITCODE-Überbleibsel werden entfernt	Ja
ios/xcode-swift-version-sanity	iOS	Swift-Version-Einstellung sieht vernünftig aus	Ja
ios/xcode-no-app-target	iOS	Xcode-Projekt hat eine Anwendungsziel	Ja
ios/xcode-multiple-app-targets	iOS	Mehrere Anwendungsziele werden absichtlich behandelt	Ja
ios/entitlements-vs-profile-capability	iOS	Zugriffsrechte passen zu Profilfähigkeiten	Ja
ios/entitlements-aps-environment-vs-mode	iOS	aps-Umgebung passt zu Verteilungsmodus	Ja
ios/entitlements-associated-domains-format	iOS	Der Domains-Format ist gültig	Wahr
ios/entitlements-app-groups-format	ios	Der App-Gruppen-Format ist gültig	Wahr
ios/capacitor-server-url-shipped	ios	server.url wird nicht als Live-Reload- / Remote-Shell-Endpunkt für Store-Builds belassen	Wahr
ios/capacitor-server-cleartext	ios	server.cleartext ist für die Produktion nicht aktiviert	Wahr
ios/capacitor-allow-navigation-wildcard	ios	server.allowNavigation ist kein allgemeiner Wildcard	Ja
ios/pods-not-installed	iOS	CocoaPods Pods / workspace sind vorhanden, wenn Pods verwendet werden	Ja
ios/pods-lock-missing	iOS	Podfile.lock piniert Pod-Versionen	Ja
ios/pods-capacitor-missing	iOS	Podfile verbindet Capacitor	Ja
ios/spm-package-resolved-missing	iOS	SPM Paket.resolved ist vorhanden	Ja
ios/spm-capacitor-dependency-missing	iOS	Package.swift deklariert Capacitor	Ja
ios/appicon-empty-or-placeholder	iOS	AppIcon.appiconset existiert und ist nicht leer	Ja
ios/appicon-referenced-file-missing	iOS	Inhalt.json-Icon-Dateien existieren auf der Festplatte	Ja
ios/appicon-marketing-missing	iOS	1024×1024 Marketingikon existiert	Ja
ios/spm-deployment-target-consistency	iOS	SPM-Deployziel ist konsistent	Ja

Android

ID	Plattformen	Was es überprüft	Schrittweise durchsetzen
android/keystore-opens	android	Android-Sicherheitsdatei öffnet sich mit den bereitgestellten Passwörtern	—
android/keystore-expiry	__CAPGO_KEEP_0__	Android	—
android/cordova-vars-present	Der Android-Signierungs-Zertifikat ist nicht abgelaufen	Android	—
android/gradle-props-heuristics	cordova.variables.gradle ist nach cap-Synchronisierung vorhanden	Android	—
android/play-sa-json	Gradle-Eigenschaften-Heuristik für häufige Build-Brecher	Android	—
android/flavor-exists	Play-Dienstkonten-JSON ist vorhanden, wenn konfiguriert	Android	—
android/agp8-package-attr	Das angeforderte Produktflavor existiert	Manifest Paket-Attribut entfernt für AGP 8+	—
android/manifest-well-formed	Android	AndroidManifest.xml wird geparst	—
android/manifest-tag-typo	Android	Gemeinsame Manifest-Tagschreibfehler	—
android/manifest-namespace-uri	Android	xmlns:android ist der Namensraum-URI korrekt	—
android/manifest-missing-prefix	Android	Android-Attribute verwenden den Prefix android:	—
android/manifest-exported-missing	Android	android:exported wird an den erforderlichen Stellen gesetzt	—
android/manifest-multiple-uses-sdk	Android	Nur ein sdk-Element wird verwendet	—
android/manifest-duplicate-component	android	Keine duplizierten Komponenten	—
android/manifest-unique-permission	android	Benutzerdefinierte Berechtigungen sind einzigartig	—
android/manifest-hardcoded-debuggable	android	debuggable=true wird nicht verschickt	—
android/manifest-mock-location	android	ACCESS_MOCK_LOCATION wird nicht verschickt	—
android/manifest-exported-unprotected	android	Exportierte Komponenten sind geschützt	—
android/manifest-query-all-packages	android	QUERY_ALL_PACKAGES Rechtfertigung	—
android/manifest-deeplink-valid	android	Deeplinks sehen aus, als ob sie gültig sind	—
android/applicationid-present	android	Die Anwendung-ID wird in app/build.gradle deklariert	—
android/capacitor-build-gradle-applied	android	capacitor.build.gradle existiert, wenn angewendet	—
android/gradle-wrapper-present	android	Gradle-Wrapper-Dateien sind vorhanden	—
android/flavor-dimensions	android	Flavordimensionen werden deklariert, wenn Flavours existieren	—
android/google-services-file	android	google-services.json ist vorhanden, wenn Plugin angewendet wird	—
android/local-properties-committed	Android	local.properties enthält keine geheimen Daten, da diese nicht committet werden	—
android/sdk-floors	Android	min/compile/target SDK Ebenen sehen gültig aus	—
android/target-sdk-play	Android	targetSdk erfüllt Play-Anforderungen	—
android/min-sdk-capacitor	Android	minSdk erfüllt Capacitor Anforderungen	—
android/version-fields	Android	versionCode / versionName sind vorhanden	—
android/play-sa-access	Android	Der Dienstkonten kann auf die App zugreifen (remote)	—

Beispiel: remote Next.js / server.url shell

Die Lieferung einer nativen Shell, die eine Produktionsumgebung lädt server.url ist ein unterstütztes Capacitor-Muster. Prescan-Flags ios/capacitor-server-url-shipped weil es oft ein Live-Reload-Ableger ist.

Bekräftigen Sie es ohne andere Überprüfungen zu deaktivieren:

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

Oder behalten Sie die Sichtbarkeit als Warnung:

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

Zugehörige

Anfänger Erstellen Sie Ihr erstes Capgo Cloud Build.

Schulung und Support context: Unterstützung / Premium-Unterstützung oder Fußzeile-Unterstützungsabschnitt. Rolle: Abschnitt oder Seiteüberschrift. Gesehen in: Seite support-policy.astro. Nachrichten Schlüssel `support_policy_troubleshooting_title` (Support Policy Troubleshooting Title).

CLI build reference __CAPGO_KEEP_0__ Build-Referenz