Freigeben über

Xcode-Anforderung

Jede Version von .NET für iOS-, tvOS-, Mac Catalyst- oder macOS-Workloads erfordert eine bestimmte Version von Xcode.

Wir geben in unseren Versionshinweisen die genaue Xcode-Version für jede Version an.

Hinweis

In einigen eingeschränkten Szenarien kann es mit einer anderen Version von Xcode trotzdem funktionieren, wird jedoch nicht unterstützt, auch wenn keine Buildfehler oder Warnungen vorhanden sind.

Neue Workloads

Eine neue Version einer Workload erfordert möglicherweise eine andere Version von Xcode. Dies geschieht in der Regel, wenn Apple eine neue Version von Xcode veröffentlicht: Bald danach veröffentlichen wir neue Versionen der Workloads, die die neue Version von Xcode unterstützen. Das Aktualisieren der Workloads erfordert daher letztendlich eine neue Version von Xcode.

Dies manifestiert sich häufig mit einem Buildfehler wie folgt:

Diese Version von Microsoft.iOS erfordert das iOS 18.4 SDK (ausgeliefert mit Xcode 16.3). Die aktuelle Version von Xcode ist 16.2. Installieren Sie entweder Xcode 16.3, oder verwenden Sie eine andere Version von Microsoft.iOS. Weitere Informationen finden Sie unter https://aka.ms/xcode-requirement.

oder:

Diese Version von .NET für iOS (18.4.9288) erfordert Xcode 16.3. Die aktuelle Version von Xcode ist 16.2. Installieren Sie entweder Xcode 16.3, oder verwenden Sie eine andere Version von .NET für iOS. Weitere Informationen finden Sie unter https://aka.ms/xcode-requirement.

Die einfachste Lösung besteht in der Regel darin, ein Upgrade auf die Version von Xcode durchzuführen, in der die Fehlermeldung erwähnt wird.

Es ist auch möglich, eine ältere Version der entsprechenden Workload zu installieren, um zu vermeiden, dass Xcode aktualisiert werden muss.

In einigen Fällen erfordert die neuere Version von Xcode auch eine Aktualisierung auf eine neuere Hauptversion von macOS (dies geschieht in der Regel rund um April jedes Jahr). Wenn die neue macOS-Version auf der aktuellen Hardware des Entwicklers nicht unterstützt wird, besteht die einzige Option darin, eine ältere Version der Workload zu verwenden (oder neue Hardware zu erhalten).

Neuer Xcode

Es gibt ein Zeitfenster zwischen der Veröffentlichung einer neuen Version von Xcode und der Veröffentlichung der Unterstützung für diese neue Xcode-Version. Manchmal aktualisiert macOS die installierte Version von Xcode automatisch, was zu Problemen während dieses Zeitrahmens führen kann.

Die einfachste Lösung besteht darin, mehrere Versionen von Xcode zu installieren und die Xcode-Version auszuwählen, die der Xcode-Anforderung für die installierten Arbeitslasten entspricht.

Hinweis

Es wird empfohlen, automatische Updates im App Store unter macOS zu deaktivieren, um dieses Szenario zu vermeiden.

Installieren mehrerer Versionen von Xcode

Es ist möglich, mehrere Xcode-Versionen gleichzeitig installiert zu haben.

Dies kann mit den folgenden Schritten durchgeführt werden:

  • Wechseln Sie zur Apple Developer Downloads-Website .
  • Melden Sie sich mit Ihrer Apple-ID an.
  • Suchen Sie nach den gewünschten Versionen von Xcode.
  • Laden Sie die .xip Datei(n) herunter.
  • Extrahieren Sie die Dateien, indem Sie auf sie doppelklicken.
  • Benennen Sie Xcode.app im Ordner "Downloads" in etwas Aussageskräftigeres um (z. B. Xcode_15.app).
  • Verschieben Sie die extrahierten *.app Dateien in das /Applications/ Verzeichnis.

Hinweis

Wir haben seltsame Probleme gesehen, wenn die Xcode-App nach dem Öffnen mindestens einmal umbenannt wird, daher empfehlen wir, die App direkt nach dem Herunterladen und Extrahieren nur umzubenennen.

Nachdem die gewünschten Versionen von Xcode installiert wurden, können Entwickler die Auswahl entweder über die Einstellungen in Xcode (Menü Xcode -> Einstellungen -> Standorte -> Befehlszeilentools) treffen oder das xcode-select-Tool direkt über die Befehlszeile nutzen.

$ sudo xcode-select --switch /Applications/Xcode_15.app

Von Bedeutung

Die Datei ~/Library/Preferences/Xamarin/Settings.plist kann auch verwendet werden, um eine bestimmte Version von Xcode auszuwählen, und diese Datei hat Vorrang vor der in Xcode oder in der Befehlszeile angegebenen Einstellung.xcode-select Um Verwirrung zu vermeiden, empfehlen wir, einfach diese Datei zu löschen.

Installieren einer älteren Version einer Workload

Eine bestimmte Version einer Workload wird mithilfe eines Workloadsatzes installiert.

Die genaue Workload-Set-Version ist nicht vorhersagbar, aber wir geben die Workload-Set-Version für eine bestimmte Workload-Version bei jedem Release an: https://github.com/dotnet/macios/releases.

Hier ist ein Beispiel für unsere Version mit Unterstützung für Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Häufig gestellte Fragen

Ist es sicher, mein Xcode zu aktualisieren?

Es ist möglich, zu überprüfen, ob wir die Unterstützung für eine bestimmte Version von Xcode veröffentlicht haben, indem sie sich unsere Liste der Versionen ansehen.

Wenn wir Unterstützung für eine bestimmte Version von Xcode veröffentlicht haben, ist es sicher, auf diese Version von Xcode zu aktualisieren (dies schließt auch MAUI-Entwickler ein). Möglicherweise gibt es andere Dokumente, die angeben, dass eine ältere Version von Xcode die unterstützte Version ist; Diese Dokumente liegen in der Regel teilweise hinter unseren Veröffentlichungen.

Das Gegenteil ist auch wahr: Wenn wir keine Unterstützung für eine bestimmte Version von Xcode veröffentlicht haben, ist es wahrscheinlich, dass das Upgrade von Xcode Probleme verursacht. Für Entwickler, die eine neuere Version von Xcode wünschen, besteht die beste Lösung in diesem Fall darin, mehrere Versionen von Xcode zu installieren.