Prüfung von Build-Vorabprüfungen durchführen

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

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 Überprüfung zu deaktivieren.

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.

Tip

Benötigt @capgo/cli@latest mit Unterstützung für pro-Check-Übernahmen. Vorziehen --prescan-skip / --prescan-warn damit jeder andere Check immer noch Ihre 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)	Scan durchführen, Bericht drucken, nie blockieren
--fail-on-warnings	Warnungen als fatal behandeln (CI)

--no-prescan und --prescan-ignore-fatal verstecken oder umgehen alle übrigen Prüfungen. Verwenden Sie stattdessen per-Prüfungs-Überprüfungen, wenn Sie nur mit einer Regel nicht einverstanden sind.

Prüfungs-Katalog

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

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

Geteilt

Id	Plattformen	Was es überprüft	Schrittweise durchsetzen
shared/apikey-permission	ios, android	Der API-Schlüssel kann native Builds anfordern	—
shared/app-exists	iOS, Android	Die App-ID existiert und ist für den API-Schlüssel sichtbar	—
shared/credentials-saved	iOS, Android	Für iOS/Android werden die erforderlichen Anmeldeinformationen lokal gespeichert	—
shared/cap-sync-stale	iOS, Android	Web-Assets werden erstellt und Capacitor-Plugins werden synchronisiert	—
shared/node-linker-layout	iOS, Android	Die node_modules-Struktur funktioniert mit Capacitor-Pfaden für native Anwendungen	—
shared/bundle-id-consistency	iOS, Android	Der Capacitor-appId entspricht dem native Bundle-Id / ApplicationId	—

iOS

Id	Plattformen	Was es überprüft	Schrittweise durchsetzen
ios/p12-opens	iOS	iOS-Zertifikat ö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	Provisioning-Profil-Bundle-Id entspricht der App	—
ios/profile-type-vs-mode	ios	Profil-Typ entspricht der App-Store- / Ad-hoc-Modus	—
ios/cert-profile-pairing	ios	Das Zertifikat ist im Provisioning-Profil eingebettet	—
ios/targets-covered	ios	Alle iOS-Ziele haben ein Provisioning-Profil	—
ios/infoplist-sanity	ios	Info.plist enthält erforderliche Version / Identitäts-Schlüssel	—
ios/asc-key-valid	ios	App-Store-Connect API-Schlüsselfelder sehen aus, als ob sie gültig sind	—
ios/asc-key-access	ios	ASC API Schlüssel kann auf die App zugreifen (remote)	—
ios/plist-bundle-id-format	iOS	Die CFBundleIdentifier-Format ist gültig	Ja
ios/plist-version-short-format	iOS	Die CFBundleShortVersionString-Format ist gültig	Ja
ios/plist-version-build-format	iOS	Die CFBundleVersion-Format 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-Anzeige ist deklariert	Ja
ios/plist-orientations-multitasking	ios	Die Orientierung / Multitasking-Einstellungen sind konsistent	Ja
ios/plist-orientations-present	ios	UISupportedInterfaceOrientations ist 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	Das Signierungsteam ist gesetzt	Ja
ios/xcode-bundle-id-mismatch-across-configs	ios	Der Bundle-Id ist konsistent über Xcode-Konfigurationen	Ja
ios/xcode-enable-bitcode-leftover	ios	ENABLE_BITCODE-Reste werden entfernt	Ja
ios/xcode-swift-version-sanity	ios	Die Swift-Versionseinstellung sieht vernünftig aus	Ja
ios/xcode-no-app-target	ios	Das Xcode-Projekt hat ein Anwendungsziel	Ja
ios/xcode-multiple-app-targets	ios	Mehrere App-Ziele werden absichtlich behandelt	Ja
ios/entitlements-vs-profile-capability	ios	Zustimmungen passen zu Profilfähigkeiten	Ja
ios/entitlements-aps-environment-vs-mode	ios	aps-environment passt zum Verteilungsmodus	Ja
ios/entitlements-associated-domains-format	ios	Assoziierte Domains-Format ist gültig	Ja
ios/entitlements-app-groups-format	ios	Die App-Gruppen-Format ist gültig	Ja
ios/capacitor-server-url-shipped	ios	server.url wird nicht als lebendes Reload- / Remote-Shell-Endpunkt für Store-Builds belassen	Ja
ios/capacitor-server-cleartext	ios	server.cleartext wird für die Produktion nicht aktiviert	Ja
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-Versions	Ja
ios/pods-capacitor-missing	ios	Podfile verbindet Capacitor	Ja
ios/spm-package-resolved-missing	ios	SPM Package.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	Contents.json Icondateien existieren auf der Festplatte	Ja
ios/appicon-marketing-missing	ios	1024×1024 Marketing-Icon existiert	Ja
ios/spm-deployment-target-consistency	ios	Die Zielplattform für die SPM-Bereitstellung ist konsistent	Ja

Android

Id	Plattformen	Was es überprüft	Schrittweise durchsetzen
android/keystore-opens	android	Das Android-Keystore öffnet sich mit den bereitgestellten Passwörtern	—
android/keystore-expiry	Android	Das Android-Zertifikat ist nicht abgelaufen	—
android/cordova-vars-present	Android	Die Datei cordova.variables.gradle ist nach cap sync vorhanden	—
android/gradle-props-heuristics	Android	Gradle-Eigenschaften heuristiken für häufige Build-Brecher	—
android/play-sa-json	Android	Das Play-Service-Konto-JSON ist vorhanden, wenn konfiguriert	—
android/flavor-exists	Android	Das angeforderte Produktflavor existiert	—
android/agp8-package-attr	Android	Das Manifest-Paket-Attribut wurde für AGP 8+ entfernt	—
android/manifest-well-formed	Android	AndroidManifest.xml liest aus	—
android/manifest-tag-typo	Android	Gemeinsame Manifest-Tagsyndrome	—
android/manifest-namespace-uri	Android	xmlns:android-Namespace-URI ist korrekt	—
android/manifest-missing-prefix	Android	Android-Attribute verwenden den Prefix android:	—
android/manifest-exported-missing	Android	android:exported wird dort gesetzt, wo erforderlich	—
android/manifest-multiple-uses-sdk	Android	Nur ein uses-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 nicht für den Vertrieb geeignet	—
android/manifest-mock-location	Android	ACCESS_MOCK_LOCATION nicht für den Vertrieb geeignet	—
android/manifest-exported-unprotected	Android	Exportierte Komponenten sind geschützt	—
android/manifest-query-all-packages	Android	Begründung für QUERY_ALL_PACKAGES	—
android/manifest-deeplink-valid	android	Die Deeplink-Intent-Filter sehen aus	—
android/applicationid-present	android	Die Anwendungs-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	Schmackenabmessungen werden deklariert wenn Schmacken existieren	—
android/google-services-file	android	google-services.json ist vorhanden wenn Plugin angewendet wird	—
android/local-properties-committed	Android	lokale properties ist nicht mit geheimen Informationen committet	—
android/sdk-floors	Android	min/compile/target SDK Etagen sehen aus wie gültig	—
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 Play-Dienst kann auf das App (remote) zugreifen	—

Beispiel: Remote Next.js / server.url shell

Ein native Shell bereitstellen, der eine Produktionsumgebung lädt server.url ist ein unterstütztes Capacitor Muster. Prüfflags vorab ios/capacitor-server-url-shipped weil es oft ein Live-Reload-Ableger ist.

Bekenntnis ohne andere Überprüfungen zu deaktivieren:

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

Oder behalte die Sichtbarkeit als Warnung:

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

Verwandte

Einstieg Erstellen Sie Ihr erstes Capgo Cloud Build.

Fehlerbehebung Gemeinsame Cloud Build-Fehler und -Lösungen.

CLI Build-Referenz Vollständige Build-Anforderung / Präzisionskommando-Optionen.