Der Simulator-Build bricht mit „building for iOS Simulator but linking in object file built for iOS“ ab, obwohl im Fehlertext arm64 steht.
Schnellste Lösung: Prüfen Sie, ob die betroffene Abhängigkeit einen iOS-Simulator-Slice enthält; aktualisieren Sie die Bibliothek oder erstellen Sie ein passendes XCFramework neu, statt arm64 pauschal auszuschließen.

Dieser Beitrag ist für Sie, wenn Sie nach dem Wechsel zu Apple silicon einen iOS-Simulator-Build nicht mehr verknüpfen können.
Er hilft Ihnen besonders bei Projekten mit vorgefertigten Bibliotheken, Drittanbieter-SDKs oder selbst gepflegten XCFrameworks.
Wenn Sie ausschließlich eigenen Swift- oder Objective-C-Quellcode ohne Binärabhängigkeiten bauen, ist dieser konkrete Fehlerpfad weniger wahrscheinlich.

Xcode-Fehler „building for iOS Simulator but linking in object file built for iOS“ richtig eingrenzen

Die Meldung beschreibt nicht einfach einen Konflikt zwischen zwei Prozessorarchitekturen. Sie besagt, dass der aktuelle Build für den Simulator vorgesehen ist, während eine eingebundene Objektdatei aus einem iOS-Geräte-Build stammt. arm64 benennt dabei die Architektur; es beweist nicht, dass die Bibliothek für beide Plattformvarianten gebaut wurde.

Diese Unterscheidung ist entscheidend: Ein Apple-silicon-Mac kann den iOS-Simulator mit arm64 ausführen. Ein Gerät und ein Simulator können also dieselbe Architektur verwenden, aber trotzdem unterschiedliche Plattform-Binärdateien benötigen. Apple führt iphoneos und iphonesimulator als getrennte Plattformziele und beschreibt fehlende Simulator-Architekturen als mögliche Ursache entsprechender Linkerfehler in der Technote zur Behebung von Buildfehlern auf Apple silicon.

Lesen Sie die Meldung deshalb von der betroffenen Datei aus, nicht nur vom Wort arm64:

  • „building for iOS Simulator“ bezeichnet das Plattformziel Ihres aktuellen Builds.
  • „object file built for iOS“ weist auf eine Datei hin, die für iOS-Geräte gebaut wurde.
  • arm64 bezeichnet die Architektur, für die der Linker die Datei laden möchte.
  • Der Bibliotheksname in der vollständigen Fehlermeldung grenzt die wahrscheinliche Abhängigkeit ein.
  • Das Build-Ziel und die gewählte Destination zeigen, ob Sie gerade einen Simulator oder ein Gerät bauen.

Notieren Sie den vollständigen Dateipfad der beanstandeten Bibliothek. Ist er innerhalb eines SDK- oder Paketordners, stammt die Datei wahrscheinlich aus einer extern gelieferten Binärabhängigkeit. Liegt sie im Build-Ergebnis eines eigenen Unterprojekts, prüfen Sie dagegen zuerst dessen Build-Konfiguration.

Warum lässt sich eine iOS-Gerätebibliothek nicht automatisch mit dem Simulator verknüpfen? Weil gleiche CPU-Architektur nicht dieselbe Plattform bedeutet. Der Linker braucht eine Binärdatei, die zum Ziel des Builds passt; eine arm64-Datei für das iPhone ist nicht allein durch ihre Architektur eine arm64-Datei für den Simulator. Apple erläutert diese Trennung in der Technote zu Architekturfehlern auf Apple silicon.

Die Plattform-Slices der Abhängigkeit prüfen

Ein XCFramework bündelt Binärvarianten für Plattformen und gegebenenfalls Plattformvarianten. Das heißt nicht, dass jede beliebige einzelne Framework-Datei alle benötigten Ziele enthält. Welche Slices tatsächlich verfügbar sind, muss sich aus dem gelieferten Bundle und seiner Plattformzuordnung ergeben. Apples Dokumentation erklärt, wie Sie ein Multi-Plattform-Binary-Framework-Bundle erstellen.

Prüfen Sie zunächst die vom Hersteller gelieferte Paketbeschreibung oder die Inhalte des Frameworks. Achten Sie darauf, ob neben der Gerätevariante ausdrücklich eine Simulatorvariante vorhanden ist. Eine bloße Angabe wie „arm64 unterstützt“ reicht nicht: Sie muss zur Plattform passen, die Xcode gerade baut.

Bei einem XCFramework hilft ein Blick in die Info.plist des Bundles. Dort sind die verfügbaren Bibliotheken und ihre Plattforminformationen aufgeführt. Stimmen Plattform und Variante eines Eintrags nicht mit dem Simulatorziel überein, kann Xcode die betreffende Binärdatei nicht als passenden Simulator-Slice verwenden. Die Apple-Anleitung zu XCFrameworks beschreibt das Bundle als Container für passende Framework-Varianten; sie ersetzt jedoch nicht die Prüfung, was ein konkretes Drittanbieterpaket tatsächlich mitliefert.

Für eine erste Bestandsaufnahme können Sie im Projekt nach dem in der Fehlermeldung genannten Framework suchen und dessen Bundle-Inhalte prüfen. Werkzeuge wie file oder lipo -info können zeigen, welche Architekturen in einer Binärdatei vorkommen. Sie beantworten aber nicht allein die Plattformfrage: Wenn arm64 erscheint, ist damit noch nicht belegt, ob die Datei für iphoneos oder iphonesimulator gebaut wurde. Nutzen Sie diese Ausgabe zusammen mit den Plattformangaben im XCFramework und der Herstellerdokumentation.

Achtung: Kopieren Sie nicht einfach den Geräte-Slice in den Simulator-Pfad und benennen Sie ihn um. Eine passende Architekturbezeichnung macht aus einer iOS-Gerätebibliothek keine Simulatorbibliothek.

Was ist zu tun, wenn ein Drittanbieter-SDK keinen Simulator-Slice für Apple silicon mitliefert? Fragen Sie beim Anbieter nach einer aktuellen XCFramework-Ausgabe, die das Simulatorziel abdeckt, oder aktualisieren Sie auf eine Version, in der dieser Slice enthalten ist. Falls der Anbieter nur eine einzelne Gerätebibliothek verteilt, ist das ein Lieferumfangsproblem und kein verlässlicher Hinweis darauf, dass Sie Ihre Anwendung falsch konfigurieren.

Wenn das SDK über ein binäres Swift-Paket eingebunden wird, kontrollieren Sie zusätzlich, ob das Paket auf das erwartete Binary verweist und die dazugehörigen Plattformvarianten bereitstellt. Apples Hinweise zum Verteilen binärer Frameworks als Swift-Pakete sind dafür relevant. Ein Paketmanifest oder ein erfolgreicher Paketabruf belegt für sich genommen nicht, dass die gelieferte Bibliothek für jede von Ihnen benötigte Destination geeignet ist.

Schrittweise den Verursacher finden und beheben

Gehen Sie vom betroffenen Linker-Eintrag aus und verändern Sie nicht gleichzeitig mehrere Projekteinstellungen. So bleibt klar, ob die Reparatur tatsächlich die Ursache beseitigt oder den Fehler nur verdeckt.

  1. Fehler vollständig erfassen. Kopieren Sie die Linker-Zeile mit Bibliotheksname, Dateipfad und Architektur. Halten Sie außerdem fest, welches Scheme und welche Destination ausgewählt waren. Ohne den Pfad besteht das Risiko, den falschen Eintrag zu aktualisieren.

  2. Das fehlerhafte Target bestimmen. Prüfen Sie, ob die Bibliothek von der App, einem Test-Target oder einem eingebundenen Unterprojekt referenziert wird. Ein Projekt kann für die App bereits ein geeignetes XCFramework verwenden, während ein separates Test-Target noch auf eine veraltete statische Bibliothek zeigt.

  3. Die Herkunft der Datei feststellen. Unterscheiden Sie zwischen einem Drittanbieter-SDK, einer selbst gebauten statischen Bibliothek und einer Abhängigkeit aus einem Paket. Suchen Sie in den Projekt- und Paketkonfigurationen nach der Referenz und vergleichen Sie den gefundenen Pfad mit dem Pfad aus der Fehlermeldung.

  4. Den Plattform-Slice bestätigen. Prüfen Sie die XCFramework-Metadaten, Herstellerangaben und Build-Ausgabe. Die relevanten Xcode-Build-Einstellungen und Plattformbezeichnungen finden Sie in der Xcode-Referenz zu Build Settings. Achten Sie insbesondere darauf, ob die Abhängigkeit für iphonesimulator oder nur für iphoneos bereitsteht.

  5. Die passende Quelle wählen. Bei einem Drittanbieterprodukt verwenden Sie nach Möglichkeit eine aktualisierte Ausgabe mit Simulator-Slice. Bei einer selbst gepflegten Bibliothek bauen Sie das Framework für die benötigten Plattformziele neu und verpacken die Ergebnisse als XCFramework. Apple beschreibt das Zusammenstellen der Plattformvarianten in seiner Dokumentation zur Erstellung eines Multi-Plattform-Bundles.

  6. Eine Architektur-Ausnahme nur als begrenzten Test behandeln. EXCLUDED_ARCHS kann in einem konkreten Kompatibilitätsfall helfen, ist aber kein Ersatz für einen fehlenden Plattform-Slice. Apple beschreibt in der Technote zu Buildfehlern auf Apple silicon, in welchem Zusammenhang Architektur-Ausschlüsse als Ausweichmaßnahme vorkommen. Übernehmen Sie eine solche Einstellung nicht ungeprüft auf alle Targets oder Konfigurationen.

  7. Die Änderung für jede relevante Destination bauen. Bauen Sie zuerst das Simulatorziel, auf dem der Fehler auftrat, und anschließend das Geräte-Ziel. Apple unterscheidet beim Ausführen und Bauen ausdrücklich zwischen Simulator und physischem Gerät. Ein erfolgreicher Simulator-Build allein belegt nicht, dass der Geräte-Slice weiterhin korrekt verknüpft wird.

  8. Abhängigkeitsstand und Ergebnis dokumentieren. Halten Sie fest, welche Paket- oder SDK-Version verwendet wurde, aus welcher Quelle das Binary stammt und welche Ziele erfolgreich gebaut wurden. Wenn Xcode, SDK oder eine Binärabhängigkeit später aktualisiert wird, können Sie Veränderungen gezielt vergleichen, statt den Fehler erneut ohne Ausgangspunkt zu untersuchen.

Kann EXCLUDED_ARCHS den Xcode-Fehler beheben? Nur unter einer klar eingegrenzten Bedingung: Die Abhängigkeit muss tatsächlich an einer nicht unterstützten Architektur scheitern, und die Änderung muss auf das betroffene Ziel und die erforderliche Konfiguration beschränkt bleiben. Wenn der Bibliothek der Simulator-Slice fehlt, macht ein Ausschluss aus einem Geräte-Binary keine gültige Simulatorbibliothek. Prüfen Sie nach einem solchen Versuch unbedingt auch den Geräte-Build und alle weiteren Targets, die dieselbe Abhängigkeit nutzen.

Den Reparaturweg nach Risiko und Reichweite bewerten

Vergleichen Sie die Optionen nach der Frage, ob sie die Plattformursache beheben oder lediglich die aktuellen Buildbedingungen verändern. Die Wertung ist eine qualitative Einschätzung des Eingriffs, keine gemessene Leistungsbewertung.

Maßnahme Wann sie passt Wirkung auf die Plattformursache Risiko für andere Ziele Einschätzung
Abhängigkeit mit passendem Simulator-Slice aktualisieren Der Anbieter stellt ein geeignetes XCFramework bereit Behebt die fehlende Plattformvariante an der Quelle Niedrig, sofern Paketversion und übrige Ziele geprüft werden Bevorzugt
Eigenes XCFramework neu bauen Sie kontrollieren die Bibliotheksquellen und den Build Stellt die benötigten Varianten gezielt bereit Mittel, wenn Export und Paketierung nicht geprüft werden Sauberer Weg bei eigener Bibliothek
EXCLUDED_ARCHS gezielt setzen Eine dokumentierte Architektur-Inkompatibilität ist nachgewiesen Behebt keinen fehlenden Plattform-Slice Erhöht, wenn die Einstellung auf weitere Targets übergreift Nur begrenzter Workaround
Gerätebibliothek im Simulator weiterverwenden Für die Abhängigkeit ist kein Simulator-Slice vorhanden Löst den Plattformkonflikt nicht Hoch: der Link bleibt inkompatibel Nicht als dauerhafte Lösung geeignet

Die Tabelle ordnet keine Anbieter nach Qualität. Entscheidend ist, ob Ihr konkretes Bundle die benötigte Plattformvariante enthält. Wenn die Ursache eine fehlende Simulatorbibliothek ist, führen ein Update oder ein sauberer Neuaufbau der Abhängigkeit zum eigentlichen Problem zurück. Der Architektur-Ausschluss ist dagegen nur dann vertretbar, wenn Sie den konkreten Kompatibilitätsgrund identifiziert und die Auswirkungen auf weitere Build-Ziele überprüft haben.

Apple weist in der Referenz für Xcode-Build-Einstellungen darauf hin, dass Einstellungen wie EXCLUDED_ARCHS die zur Kompilierung verfügbaren Architekturen beeinflussen. Behandeln Sie sie daher nicht als harmlose Projektkosmetik. Prüfen Sie, ob die Einstellung nur für das beabsichtigte Simulatorziel greift, ob sie in gemeinsam genutzten Konfigurationen landet und ob andere Entwickler dieselbe Änderung übernehmen würden.

Abnahme mit einer ausführbaren Prüfliste

Verwenden Sie diese Liste nach dem Update oder Neuaufbau. Jeder Punkt muss anhand des tatsächlich verwendeten Targets und der ausgewählten Destination überprüfbar sein:

  • [ ] Der in der Fehlermeldung genannte Bibliothekspfad ist der Abhängigkeit zugeordnet, die Sie geändert haben.
  • [ ] Die Binärdatei bietet eine Variante für das Simulatorziel und nicht lediglich eine Architektur mit passendem Namen.
  • [ ] Das betroffene App- oder Test-Target referenziert die neue Bibliothek statt eines veralteten Artefakts.
  • [ ] Der Build für die zuvor fehlerhafte Simulator-Destination wird abgeschlossen.
  • [ ] Der Build für die vorgesehene Geräte-Destination wird ebenfalls abgeschlossen.
  • [ ] Eine gesetzte EXCLUDED_ARCHS-Einstellung ist auf den notwendigen Geltungsbereich begrenzt und mit den übrigen Targets geprüft.
  • [ ] Abhängigkeitsversion, Quelle des Binaries und geprüfte Build-Ziele sind im Projektteam nachvollziehbar festgehalten.

Die Punkte sind keine Ersatzdiagnose für unvollständige Herstellerpakete. Sie verhindern vielmehr, dass ein scheinbar erfolgreicher lokaler Simulator-Build als vollständige Abnahme gilt. Apple beschreibt das Ausführen auf Simulator und echtem Gerät als unterschiedliche Zielumgebungen in seiner Anleitung zum Bauen und Ausführen einer App.

Wenn ein unabhängiger Build auf einer zweiten Mac-Umgebung scheitert, obwohl Ihr lokaler Ordner bereits aktualisiert wurde, prüfen Sie zuerst, ob beide Umgebungen tatsächlich dieselbe Abhängigkeitsversion und denselben Projektstand verwenden. Ein separates Umfeld hilft dabei, lokale Altartefakte oder nicht dokumentierte Build-Einstellungen als Ursache einzugrenzen; es ersetzt aber nicht den fehlenden Simulator-Slice. Gerade bei Remote-Zugriff sollten Sie vor dem Übertragen von Quellcode und Zugangsdaten die Hinweise zur Datenschutzrichtlinie lesen. Bei Fragen zur Nutzung einer Umgebung finden Sie ergänzende Informationen im SSHMac-Hilfezentrum.

Ihre Situation Nächster Schritt Wann Sie nicht bei dieser Option bleiben sollten
Drittanbieter-SDK enthält nur die Gerätevariante Beim Anbieter eine Simulator-kompatible XCFramework-Ausgabe anfordern oder auf eine geeignete Version wechseln Wenn die neue Ausgabe den benötigten Slice weiterhin nicht enthält
Sie kontrollieren die Bibliotheksquellen Für Simulator und Gerät passende Varianten bauen und als XCFramework bereitstellen Wenn Quellcode oder Build-Abhängigkeiten die erforderlichen Zielplattformen nicht unterstützen
Ein Architektur-Ausschluss lässt den lokalen Build durchlaufen Ausschluss begrenzen und anschließend Simulator- sowie Geräteziel getrennt prüfen Wenn ein anderes Target, eine weitere Konfiguration oder ein Team-Build damit nicht mehr baut
Die lokale Umgebung verhält sich anders als eine frische Umgebung Abhängigkeitsversion, Projektstand und Build-Einstellungen vergleichen Wenn die zugrunde liegende Binärdatei weiterhin nur für iOS-Geräte gebaut wurde

Für einen reproduzierbaren Gegencheck können Sie die Projektdateien in einer getrennten Mac-Umgebung bauen, statt Änderungen an Ihrer funktionierenden Entwicklungsumgebung zu überlagern. Die bisherige Alternative – nur lokal weiterzuarbeiten – kann durch zwischengespeicherte Artefakte, nicht dokumentierte Einstellungen und eine fehlende unabhängige Bestätigung unzuverlässig werden; ein dauerhafter Architektur-Ausschluss kann wiederum andere Targets beeinträchtigen. Wenn Sie für diese Prüfung vorübergehend einen separaten Mac benötigen, können Sie dafür eine Mac-Umgebung von SSHMac nutzen; für kontinuierliche, langfristige Builds oder Anforderungen an physische Anschlüsse ist dagegen ein eigener Mac oft die passendere Wahl.