Start Debugging
DE
2026-05-17 errorsflutteriosxcode Edit on GitHub

Fix: Failed to build iOS app mit Xcode 16 und Flutter 3.x

Der Fix in 60 Sekunden: Aktualisieren Sie Flutter auf 3.24.4 oder höher, heben Sie die Podfile-Plattform auf iOS 13 an, löschen Sie Pods und DerivedData, dann pod install. Der Fehler steckt selten in Ihrem Dart-Code.

Von Marius Bughiu · 8 Min. Lesezeit ·

Der Fix in einem Satz: Failed to build iOS app nach dem Upgrade auf Xcode 16 ist fast nie Ihr Dart-Code. Es ist eine von vier Ursachen, in dieser Reihenfolge der Häufigkeit: ein Flutter-SDK älter als 3.24.4, das den neuen Modul-Verifier von Xcode 16 nicht kennt, ein Podfile, das noch platform :ios, '11.0' fixiert (Xcode 16 hat die Unterstützung für den iOS-11-Simulator entfernt), ein veralteter Cache aus ios/Pods und ~/Library/Developer/Xcode/DerivedData/ModuleCache.noindex vom vorherigen Xcode, oder ein Plugin, das noch kein mit Swift 6 / Xcode 16 kompatibles Release veröffentlicht hat. Aktualisieren Sie Flutter, heben Sie das Podfile auf iOS 13 an, löschen Sie beide Caches, führen Sie pod install aus, kompilieren Sie neu. Greifen Sie nicht mehr als ersten Schritt zu flutter clean; es berührt die iOS-Caches, die tatsächlich kaputt sind, nicht.

Launching lib/main.dart on iPhone 16 Pro in debug mode...
Running Xcode build...
Xcode build done.                                           38.4s
Failed to build iOS app
Error (Xcode): Swift Compiler Error (Xcode): No such module 'Flutter'
/Users/me/MyApp/ios/Runner/AppDelegate.swift:2:8

Could not build the application for the simulator.
Error launching application on iPhone 16 Pro.

Dieser Leitfaden wurde gegen Flutter 3.41.5 (Stable-Kanal, Mai 2026), die Xcode 16.x-Linie (16.0 bis 16.4 zum Zeitpunkt des Schreibens), CocoaPods 1.16.2 und macOS Sequoia 15.3 auf Apple Silicon geschrieben. Die gleichen Fixes gelten für Flutter 3.24.4 und höher; wenn Sie auf Flutter 3.19 oder älter sind, lesen Sie zuerst den Upgrade-Schritt, denn keine Menge an Pod-Fummelei wird Sie auf diesem Branch retten. Die relevanten Flutter-Änderungen, die Xcode 16 sauber zum Laufen brachten, landeten in flutter/flutter#155438, und die folgenden modulemap-Fixes in flutter/flutter#157461.

Was Failed to build iOS app Ihnen tatsächlich sagt

Failed to build iOS app ist die Dachmeldung des Flutter-Tools. Sie bedeutet nur “xcodebuild hat einen Exit-Code ungleich null zurückgegeben”. Die eigentliche Diagnose ist die Zeile direkt darüber oder darunter, mit Error (Xcode): als Präfix. Es gibt etwa sechs verschiedene zugrunde liegende Fehler, die alle unter demselben Dach erscheinen:

  1. No such module 'Flutter' — der Swift-Compiler findet das Flutter-Framework-Modul nicht. Fast immer ein Podfile- oder pod-install-Problem nach dem Xcode-16-Upgrade.
  2. no such file or directory: '.../ModuleCache.noindex/Session.modulevalidation' — der neue Modul-Verifier von Xcode 16 kann eine von Xcode 15 geschriebene Cache-Datei nicht lesen. Siehe Issue #157461.
  3. Using bridging headers with module interfaces is unsupported — ein Muster aus module.modulemap plus Bridging Header eines Plugins, das in Xcode 15 funktionierte, ist jetzt ein harter Fehler.
  4. type 'UIApplication' does not conform to protocol 'Launcher' — ein strikter Konformitätsfehler von Swift 6 in einem veralteten Plugin (häufig url_launcher_ios vor 6.3.0).
  5. Undefined symbol: _swift_FORCE_LOAD$_swiftCompatibility56 — Swift-Runtime-ABI-Inkompatibilität, fast immer ein CocoaPods-Cache von einem vorherigen Xcode-SDK.
  6. The iOS deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 11.0, but the range of supported deployment target versions is 12.0 to 18.4 — Ihr Podfile fixiert immer noch iOS 11, das Xcode 16 entfernt hat.

Jeder dieser Fehler ist ein anderer Bug mit einer anderen Wurzelursache. Die erste Aufgabe ist, zu identifizieren, welcher davon das Tool tatsächlich getroffen hat. Scrollen Sie im Terminal nach oben, bis Sie die error:-Zeile finden, die einen Dateipfad und eine Zeilennummer hat. Das ist die Wahrheit; Failed to build iOS app ist das Symptom.

Den tatsächlichen Fehler aus flutter build lesen

Führen Sie mit ausführlichem Logging aus, damit die zugrunde liegende xcodebuild-Ausgabe nicht zusammengefasst wird:

# Flutter 3.41.5
flutter build ios --verbose 2>&1 | tee build.log

Suchen Sie dann im Log nach dem ersten error: (Kleinbuchstaben, das ist das Xcode-Präfix), nicht nach Error (Xcode) (das ist Flutters Umformatierung):

grep -n "error:" build.log | head -20

Der erste Treffer ist der, den Sie beheben müssen. Nachfolgende Fehler sind in der Regel Kaskaden des ersten. Wenn Sie die ausführliche Ausgabe nicht haben, raten Sie.

Eine minimale Reproduktion, die eine der häufigen Formen demonstriert

Die häufigste Form 2026 ist die Kombination aus dem Plattform-Pin im Podfile und einem veralteten Pods-Verzeichnis. Erstellen Sie ein frisches Flutter-Projekt und fixieren Sie das iOS-Deployment-Target auf 11.0:

# ios/Podfile, Flutter 3.41.5, CocoaPods 1.16.2
platform :ios, '11.0'

# CocoaPods analytics sends network stats synchronously affecting flutter build latency.
ENV['COCOAPODS_DISABLE_STATS'] = 'true'

project 'Runner', {
  'Debug' => :debug,
  'Profile' => :release,
  'Release' => :release,
}

# ... rest of the default Podfile ...

Führen Sie flutter build ios --no-codesign unter Xcode 16 aus, und die Kompilierung schlägt fehl mit:

[!] Automatically assigning platform `iOS` with version `11.0` on target `Runner`
    because no platform was specified. Please specify a platform for this target
    in your Podfile.
...
error: The iOS deployment target 'IPHONEOS_DEPLOYMENT_TARGET' is set to 11.0,
       but the range of supported deployment target versions is 12.0 to 18.4.
       (in target 'firebase_core' from project 'Pods')
Failed to build iOS app

Dasselbe Podfile unter Xcode 15.4 kompiliert klaglos. Der Bug ist die neue Deployment-Target-Untergrenze in Xcode 16, nicht Ihr Code.

Fix, in Reihenfolge der Häufigkeit als Antwort

Wenden Sie diese Schritte der Reihe nach an. Jeder Schritt setzt voraus, dass der vorherige nicht funktioniert hat.

1. Aktualisieren Sie Flutter auf 3.24.4 oder höher

Flutter 3.24.4 (Oktober 2024) ist das erste stabile Release, das die Xcode-16-Fixes für xcode_backend.sh und die Generated.xcconfig-Vorlage enthält. Jedes Release der 3.41.x-Linie in 2026 ist aktuell. Prüfen Sie, was Sie haben, und aktualisieren Sie:

flutter --version
flutter upgrade

Wenn flutter upgrade sich weigert, weil Ihr Kanal auf master ist oder Sie lokale Engine-Modifikationen haben, wechseln Sie zurück auf stable:

flutter channel stable
flutter upgrade

Dieser einzelne Schritt löst die Mehrheit der No such module 'Flutter'-Meldungen, die 2024 und 2025 gegen Xcode 16 eingereicht wurden. Das Flutter-Team hat Issue #155438 genau aus diesem Grund als in 3.24.4 behoben geschlossen.

2. Heben Sie die Podfile-Plattform auf iOS 13 an

Xcode 16 unterstützt iOS 12 als Deployment-Target noch immer, aber die meisten modernen Plugins (Firebase, Google Maps, alles, was SwiftUI berührt) erfordern jetzt iOS 13. iOS 13 als Untergrenze festzulegen ist der sichere Standard in 2026:

# ios/Podfile, Flutter 3.41.5
platform :ios, '13.0'

Sie müssen das auch im Runner-Projekt spiegeln. Öffnen Sie ios/Runner.xcworkspace, wählen Sie das Runner-Target, gehen Sie zu Build Settings und setzen Sie iOS Deployment Target auf 13.0 für Debug und Release. Die Build Settings des Workspace gewinnen für das Runner-Target gegenüber dem Podfile; die Podfile-Zeile wirkt sich nur auf die Pod-Targets aus.

Wenn Sie einen post_install-Block im Podfile haben, zwingen Sie jeden Pod, dasselbe Minimum zu erben (das ist der Snippet aus der modernen Flutter-Vorlage):

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
    end
  end
end

3. Löschen Sie Pods, das Lockfile und den Modul-Cache

Das ist der Schritt, der den ModuleCache.noindex-Fehler und die meisten Undefined symbol: _swift_FORCE_LOAD$_swiftCompatibility56-Meldungen behebt. Der Swift-ABI-Cache Ihres vorherigen Xcode ist mit dem swiftc von Xcode 16 inkompatibel, und flutter clean rührt ihn nicht an. Aus dem Projektstammverzeichnis:

# Flutter 3.41.5, CocoaPods 1.16.2
flutter clean
cd ios
rm -rf Pods Podfile.lock .symlinks
rm -rf ~/Library/Developer/Xcode/DerivedData
pod cache clean --all
pod install --repo-update
cd ..
flutter pub get

pod install --repo-update (Achtung: nicht pod install allein) aktualisiert das CocoaPods-Specs-Repository, damit Sie alle Plugin-Podspecs erhalten, die seit Ihrem letzten Build veröffentlicht wurden. Überspringen Sie das, und Sie installieren die gestrige firebase_core.podspec, die noch immer iOS 11 fixiert.

4. Aktualisieren Sie Plugins, besonders die im Fehler genannten

Wenn der Fehler type 'UIApplication' does not conform to protocol 'Launcher' lautet, ist das Plugin veraltet. Die zwei häufigsten Übeltäter sind url_launcher_ios und webview_flutter_wkwebview. Heben Sie auf die neueste Minor-Version:

flutter pub upgrade --major-versions

Wenn Sie kein Pauschal-Upgrade machen können, weil eine Abhängigkeit fixiert ist, aktualisieren Sie nur das im Fehler genannte Plugin:

flutter pub upgrade --major-versions url_launcher_ios

Wiederholen Sie dann Schritt 3 (Pods werden nach Version gecacht; eine Änderung an pubspec.yaml führt pod install nicht automatisch erneut aus). Für einen tieferen Leitfaden zum Lesen der Beschwerden des pubspec-Resolvers, falls pub upgrade selbst fehlschlägt, siehe warum “Version solving failed” ein Beweis und kein Bug ist.

5. Erzwingen Sie eine einzige Swift-Version über alle Pods

Eine Teilmenge der Build-Fehler kommt von Pods, die keine SWIFT_VERSION deklariert haben, was unter Xcode 16 standardmäßig auf den strikten Modus von Swift 6 fällt und dann an völlig legalem Swift-5-Code explodiert. Der Fix ist, jeden Pod im selben post_install-Block auf Swift 5 zu fixieren:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
      config.build_settings['SWIFT_VERSION'] = '5.0'
    end
  end
end

Das ist ein Workaround, kein Fix. Die korrekte langfristige Lösung ist, ein Issue gegen das Plugin zu eröffnen, damit es seine eigene Swift-Version deklariert, aber die Fixierung wird Sie heute entsperren.

6. Löschen und regenerieren Sie die ios/Runner.xcodeproj-Einstellungen nur als letzten Ausweg

Wenn Sie die project.pbxproj von Hand bearbeitet haben (native Targets hinzugefügt, benutzerdefinierte Build-Phasen, App-Clip-Erweiterungen) und nichts davon funktioniert hat, kann das Runner-Target veraltete Build Settings vor Xcode 16 haben. Sichern Sie ios/Runner.xcodeproj und vergleichen Sie es dann mit einem frisch generierten:

# Flutter 3.41.5
flutter create --platforms=ios --project-name=runner /tmp/scratch
diff -r ios/Runner.xcodeproj /tmp/scratch/ios/Runner.xcodeproj

Übertragen Sie die relevanten Build Settings (IPHONEOS_DEPLOYMENT_TARGET, SWIFT_VERSION, ENABLE_USER_SCRIPT_SANDBOXING, STRING_CATALOG_GENERATE_SYMBOLS) vom Scratch-Projekt in Ihres, eine nach der anderen, und kompilieren Sie zwischen jeder neu. Das ist mühsam, aber auch der einzig verlässliche Weg, ein Projekt zu retten, das fünf Jahre Xcode-Upgrade-Geröll angesammelt hat.

Fallstricke und Ähnlichkeiten

Einige Fälle, die wie dieser Fehler aussehen, es aber nicht sind:

Wenn Sie die Schritte 1 bis 5 zweimal durchgegangen sind und immer noch denselben Fehler sehen, ist der nächste Schritt, Plugins zu bisektieren. Kommentieren Sie jede direkte Abhängigkeit in pubspec.yaml außer flutter und cupertino_icons aus, führen Sie den Lösch-und-Build-Zyklus aus und bestätigen Sie, dass das leere Projekt baut. Dann auskommentieren Sie Abhängigkeiten in Dreiergruppen. Die erste Gruppe, die den Fehler wieder einführt, enthält das schuldige Plugin. Das ist langsam, aber deterministisch und liefert Ihnen einen einreichbereiten Bug-Report.

Verwandt

Quellen

Comments

Sign in with GitHub to comment. Reactions and replies thread back to the comments repo.

< Zurück