Symptom: Ihr React-Native-Projekt startet, aber Sie wissen nicht, ob es wirklich für iOS gebaut wurde.
Schnellste Lösung: Verwenden Sie für ein neues Projekt die React-Native-0.88-Vorlage; sichern und vergleichen Sie ein älteres Projekt zuerst. Für den nativen iOS-Build und den Simulator brauchen Sie macOS mit einer passenden Xcode-Umgebung.

Diese Anleitung ist für Sie, wenn Sie React Native lernen und Ihr erstes Projekt im iOS-Simulator prüfen möchten.
Sie haben bereits ein Kursprojekt und möchten es auf Version 0.88 bringen? Dann beginnen Sie mit dem Vergleich der nativen Projektdateien.
Arbeiten Sie überwiegend unter Windows oder auf einem Schulrechner, erfahren Sie hier, an welcher Stelle macOS und Xcode unverzichtbar werden.

Zuletzt aktualisiert am 20.10.2026; geprüft anhand der offiziellen React-Native-Veröffentlichung, der Upgrade-Dokumentation und der Apple-Unterlagen zum Szenenlebenszyklus.

Zuerst den passenden Projektweg wählen

React Native 0.88 kann für iOS-Projekte verwendet werden. Die offizielle Veröffentlichung vom 19.10.2026 beschreibt die Unterstützung des SceneDelegate-Lebenszyklus und nennt keine nutzerseitigen Breaking Changes. Das heißt aber nicht, dass jedes ältere iOS-Projekt ohne Prüfung aktualisiert werden kann. Für einen Simulator-Build benötigen Sie weiterhin macOS und Xcode. Die Release-Hinweise zu React Native 0.88 sind der Ausgangspunkt für diese Versionsentscheidung.

Ein neues Projekt und ein bestehendes Kursprojekt sind zwei verschiedene Fälle. Bei einer Neuanlage übernehmen Sie die Struktur der aktuellen Vorlage. Bei einem Upgrade müssen Sie die Änderungen zwischen Ihrer bisherigen Version und 0.88 prüfen, bevor Sie Projektdateien überschreiben.

Ihr Ausgangspunkt Vorgehen Häufiger Fehler
Sie beginnen ein neues Kursprojekt Erstellen Sie es mit der für 0.88 vorgesehenen offiziellen Vorlage und kontrollieren Sie danach die erzeugten iOS-Dateien. Eine Anleitung für eine ältere Vorlage blind nachbauen.
Sie haben ein bestehendes Projekt Sichern Sie den Arbeitsstand und vergleichen Sie die Versionsunterschiede im Upgrade Helper. „Keine Breaking Changes“ als Garantie für alle nativen Bibliotheken und Projektdateien verstehen.
Sie arbeiten nur an JavaScript-Aufgaben Bearbeiten und prüfen Sie den JavaScript-Teil in Ihrer bisherigen Umgebung. Annehmen, dass ein laufender JavaScript-Server bereits einen iOS-Build beweist.
Der Kurs verlangt eine iOS-Simulator-Abnahme Organisieren Sie Zugriff auf macOS und eine kompatible Xcode-Installation. Erst am Abgabetag feststellen, dass Windows den nativen iOS-Simulator nicht bereitstellt.

Vor dem Start macOS, Xcode und Projektstand abgleichen

Ein React-Native-Projekt enthält JavaScript- beziehungsweise TypeScript-Code und zusätzlich ein natives iOS-Projekt. Die JavaScript-Dateien beschreiben unter anderem Oberfläche und Programmlogik. Das iOS-Projekt verbindet diese Teile mit dem Betriebssystem und wird mit Apples Entwicklungswerkzeugen gebaut. Der Simulator führt die gebaute iOS-App aus; er ist nicht dasselbe wie ein Browserfenster mit einer geöffneten Entwicklungsseite.

Diese Trennung ist für Einsteiger wichtig: Metro kann JavaScript-Dateien bereitstellen, während der native iOS-Build noch fehlschlägt. Ebenso kann ein Projekt erfolgreich kompilieren, aber beim Start eine leere oder fehlerhafte Ansicht zeigen. Erfassen Sie daher den Build-Status und das sichtbare Ergebnis getrennt.

Prüfen Sie vor Änderungen die folgenden Punkte:

  • Welche React-Native-Version steht in der Projektkonfiguration?
  • Welchen Paketmanager und welche Sperrdatei verwendet das Kursprojekt?
  • Ist macOS verfügbar, und lässt sich Xcode auf diesem Mac starten?
  • Welche iOS-Version und welcher Simulator sind für die Kursaufgabe vorgesehen?
  • Müssen Sie nur die JavaScript-Oberfläche entwickeln oder ausdrücklich einen iOS-Build vorzeigen?
  • Verwendet das Projekt native Bibliotheken, URL-Schemata oder eigene Änderungen an der iOS-App?

Die offizielle Anleitung zur Einrichtung der React-Native-Umgebung beschreibt die erforderlichen Werkzeuge abhängig von Entwicklungsplattform und Projektweg. Prüfen Sie dort die aktuelle Anforderung, statt eine Versionsangabe aus einem alten Video ungeprüft zu übernehmen. Eine Xcode-Version, die auf einem Mac installiert ist, ist nicht automatisch für jede Kombination aus React Native, macOS und iOS-SDK passend.

Wenn Sie auf einem Schulrechner arbeiten, prüfen Sie auch die Berechtigungen. Ein eingeschränktes Benutzerkonto kann verhindern, dass Sie Xcode installieren, Komponenten ergänzen oder Projektdateien an den erforderlichen Stellen ablegen. Klären Sie das vor der Abnahme mit der zuständigen Stelle. Sonst verlieren Sie Zeit mit einem Problem, das nicht durch eine Änderung am JavaScript-Code lösbar ist.

Schritt für Schritt ein neues Projekt vorbereiten

Bei einem neuen Projekt ist die offizielle Vorlage die sicherste Referenz. Verwenden Sie die Einstiegsschritte der React-Native-Dokumentation und kontrollieren Sie, dass die gewählte Anleitung tatsächlich zur gewünschten Version passt. Die Dateinamen und Menüpfade können sich zwischen Vorlagen ändern; kopieren Sie deshalb keine ältere AppDelegate-Anleitung, nur weil sie in einem Suchergebnis häufig auftaucht.

Führen Sie die Vorbereitung in dieser Reihenfolge aus:

  1. Projektziel festhalten. Notieren Sie, ob Ihr Kurs ein neues Grundgerüst, eine bestimmte React-Native-Version oder eine konkrete iOS-Abnahme verlangt.
  2. Vorlage und Anleitung abgleichen. Öffnen Sie die offizielle Einführung und prüfen Sie, welche Erzeugungsmethode für die gewünschte Version vorgesehen ist.
  3. Projekt sauber anlegen. Verwenden Sie den Paketmanager und die Befehle, die für dieses Projekt dokumentiert sind. Mischen Sie nicht mehrere Installationswege, ohne zu verstehen, welche Dateien sie erzeugen.
  4. iOS-Ordner untersuchen. Öffnen Sie die generierten iOS-Dateien und suchen Sie nach dem Einstiegspunkt sowie der SceneDelegate-Struktur. Die 0.88-Veröffentlichung nennt Unterstützung für den SceneDelegate-Lebenszyklus; die Vorlage sollte daher Ihre erste Referenz sein.
  5. Simulator auswählen. Wählen Sie in Xcode ein verfügbares iOS-Simulatormodell, das zu Ihrer Entwicklungsumgebung passt.
  6. Build und Start getrennt beobachten. Warten Sie zunächst auf den Abschluss des nativen Builds. Prüfen Sie danach, ob die App tatsächlich im Simulatorfenster geöffnet wird.

Die konkrete Startanweisung hängt von der Anleitung und dem Projekt ab. Die offizielle Dokumentation zum Starten unter dem iOS-Simulator zeigt den vorgesehenen Ablauf und die verfügbaren Optionen. Übernehmen Sie die dort für Ihr Projekt genannte Befehlsform. Wenn ein Kursprojekt eigene Skripte definiert, kontrollieren Sie diese in der Projektkonfiguration, bevor Sie einen Befehl aus einem anderen Tutorial ausprobieren.

Bei einem neuen Projekt müssen Sie SceneDelegate nicht vorsorglich selbst ergänzen, wenn die verwendete Vorlage die benötigte Struktur bereits erzeugt. Eine manuelle Ergänzung kann zu doppelten oder widersprüchlichen Einstiegspunkten führen. Öffnen Sie zuerst das erzeugte iOS-Projekt und vergleichen Sie es mit der Dokumentation zur verwendeten Version.

Bei einem Upgrade SceneDelegate und UIScene gezielt prüfen

Beim Upgrade ist ein direkter Versionsvergleich verlässlicher als eine allgemeine Anleitung. Öffnen Sie den React-Native-Upgrade-Helper und wählen Sie Ihre Ausgangsversion sowie die Zielversion 0.88. Übertragen Sie Änderungen nicht blind: Ihre iOS-Dateien können bereits angepasst sein, und zusätzliche native Bibliotheken können eigene Anforderungen mitbringen.

Die Veröffentlichung von React Native 0.88 beschreibt Unterstützung für den SceneDelegate-Lebenszyklus. Sie nennt außerdem die Relevanz der UIScene-Anforderungen des iOS-27-SDK und eine Grenze bei der Unterstützung mehrerer Szenen. Daraus folgt keine pauschale Pflicht, jedes bestehende Projekt sofort umzubauen. Entscheidend ist, ob Sie mit dem iOS-27-SDK arbeiten und wie Ihre App-Einstiegspunkte konfiguriert sind. Prüfen Sie die Aussagen direkt in den Release-Hinweisen zu Version 0.88.

Prüfbereich Was Sie vergleichen Warum es relevant ist
App-Einstieg Änderungen an AppDelegate und SceneDelegate zwischen Ausgangsversion und 0.88 Der Einstieg in die App kann sich mit dem Szenenlebenszyklus ändern.
Info.plist Vorhandene Szenendeklarationen und weitere Einträge des iOS-Projekts Die Konfiguration muss zur Lebenszyklus-Implementierung passen.
URL-Rückrufe Ob Rückrufe aus Links oder anderen Apps an die vorgesehene Stelle weitergereicht werden Eine App kann starten, aber Verknüpfungen trotzdem nicht korrekt verarbeiten.
SDK-Ziel Ob Sie mit dem iOS-27-SDK bauen möchten Die Veröffentlichung weist auf UIScene-Anforderungen in diesem SDK hin.
Native Abhängigkeiten Welche Bibliotheken eigene iOS-Dateien oder Startlogik verändern Die Aussage zu nutzerseitigen Breaking Changes garantiert keine Kompatibilität jeder Drittanbieterbibliothek.

Die Apple-Dokumentation zum Übergang auf den UIKit-Szenenlebenszyklus erklärt, wie Szenen den Lebenszyklus einer App strukturieren. Die Apple-Unterlagen zur Konfiguration unterstützter Szenen beschreiben die zugehörige Konfiguration. Sie müssen diese Dokumente nicht vollständig auswendig lernen. Nutzen Sie sie, wenn der Upgrade Helper Änderungen an Einstiegspunkten oder Szenendeklarationen zeigt.

Ein vorsichtiger Upgrade-Ablauf sieht so aus:

  • Erstellen Sie eine wiederherstellbare Kopie oder einen separaten Versionskontrollstand.
  • Vergleichen Sie die nativen Dateien im Upgrade Helper.
  • Übernehmen Sie die Änderungen einzeln und behalten Sie eigene Anpassungen bei.
  • Kontrollieren Sie App-Einstieg, Info.plist und URL-Rückrufe.
  • Bauen und starten Sie die App, bevor Sie weitere Änderungen bündeln.
  • Notieren Sie, welche Änderung einen Fehler behoben oder ausgelöst hat.

Wenn Ihr Kurs kein iOS-27-SDK verlangt und Ihr bestehendes Projekt mit seiner bisherigen Konfiguration funktioniert, gibt es keinen Grund, allein wegen der Versionsnummer ungezielt Dateien umzubauen. Wenn Sie hingegen auf das iOS-27-SDK wechseln, prüfen Sie die UIScene-Anforderungen ausdrücklich. Die Veröffentlichung nennt außerdem eine Grenze für die Unterstützung mehrerer Szenen; planen Sie daher nicht ohne Prüfung mit einem Mehrfenster-Verhalten, das Ihre App-Version nicht abdeckt.

Häufige Fragen vor der Simulator-Abnahme

Kann ich React Native 0.88 ohne Mac im iOS-Simulator testen?

Für den nativen iOS-Build und den iOS-Simulator benötigen Sie eine macOS-Umgebung mit einer passenden Xcode-Installation. Auf einem Windows-Rechner können Sie JavaScript-Code bearbeiten und viele Lernaufgaben erledigen, aber den iOS-Build dort nicht wie auf macOS ausführen. Für die Abnahme kommt ein eigener oder zeitweise gemieteter Mac infrage.

Muss ich bei einem neuen Projekt SceneDelegate selbst einrichten?

Beginnen Sie mit der offiziellen Vorlage für React Native 0.88 und prüfen Sie die erzeugten iOS-Dateien, statt eine SceneDelegate-Konfiguration aus einem älteren Tutorial zu übernehmen. Die Veröffentlichung nennt Unterstützung für den SceneDelegate-Lebenszyklus. Ändern Sie die Vorlage nur, wenn Ihr Kursprojekt oder die tatsächlich verwendete iOS-SDK-Version es erfordert.

Was sollte ich vor dem Upgrade eines älteren Projekts vergleichen?

Vergleichen Sie zuerst Ihre aktuelle React-Native-Version mit Version 0.88 im offiziellen Upgrade Helper. Prüfen Sie dabei nicht nur JavaScript-Abhängigkeiten, sondern auch die iOS-Projektdateien, App-Einstiegspunkte, Info.plist und weitergeleitete URL-Aufrufe. Erstellen Sie eine wiederherstellbare Kopie, bevor Sie Änderungen übernehmen; „keine nutzerseitigen Breaking Changes“ ersetzt diesen Dateivergleich nicht.

Brauche ich für React Native 0.88 zwingend Xcode 27?

Leiten Sie keine pauschale Xcode-Pflicht allein aus der Versionsnummer ab. Prüfen Sie die aktuelle React-Native-Umgebungsanleitung sowie die Release-Hinweise für Ihre konkrete macOS-, Xcode- und iOS-SDK-Kombination. Relevant wird Xcode 27 insbesondere dann, wenn Ihr Projekt mit dem iOS-27-SDK gebaut werden soll; kontrollieren Sie in diesem Fall zusätzlich die UIScene-Anforderungen.

Erst nach einem echten Projekt über die Kursumgebung entscheiden

Ein leeres Beispielprojekt belegt nicht, dass Ihre Kursaufgabe funktioniert. Führen Sie die Abnahme mit dem Projekt durch, das Sie tatsächlich abgeben möchten. So entdecken Sie früh, ob eine native Bibliothek, ein Einstiegspunkt oder eine projektbezogene Einstellung zusätzliche Arbeit verursacht.

  • [ ] Die Projektversion ist notiert und stimmt mit dem Kursziel überein.
  • [ ] Das Arbeitsverzeichnis enthält eine wiederherstellbare Kopie vor Änderungen.
  • [ ] macOS und Xcode sind verfügbar; die offizielle Umgebungsanleitung wurde für die eigene Kombination geprüft.
  • [ ] Abhängigkeiten wurden mit dem Paketmanager des Projekts vorbereitet.
  • [ ] Der iOS-Build wurde bis zu einem eindeutigen Abschluss beobachtet.
  • [ ] Die App wurde im Simulator gestartet und nicht nur der JavaScript-Server geöffnet.
  • [ ] Die Startansicht und die für den Kurs verlangte Funktion wurden kontrolliert.
  • [ ] Bei einem Upgrade wurden SceneDelegate, Info.plist und URL-Rückrufe geprüft.
  • [ ] Die verwendeten Werkzeugversionen und das Abnahmeergebnis sind für die spätere Fehlersuche notiert.

Ordnen Sie Fehler danach ein, was Sie tatsächlich sehen. Kein erfolgreicher Build: Prüfen Sie zuerst Xcode-Ausgabe, Abhängigkeiten und native Projektkonfiguration. Build erfolgreich, App startet nicht: Kontrollieren Sie das gewählte Simulatormodell und den Startfehler. App läuft, Seite ist falsch oder leer: Prüfen Sie JavaScript-Ausgabe, Metro-Verbindung und den Einstieg in die App. Ein laufender Metro-Prozess allein ist keine iOS-Abnahme.

Wenn Sie auf Windows entwickeln und nur für diese Kursprüfung einen nativen iOS-Build benötigen, können Sie Aufgaben teilen: JavaScript-Arbeit bleibt auf Ihrem bisherigen Rechner, während der Simulator-Test auf einem Mac stattfindet. Ein lokaler Mac ist sinnvoll, wenn Sie regelmäßig lange und stabile Entwicklungsphasen ohne Netzwerkabhängigkeit benötigen oder physische Anschlüsse und Geräte direkt nutzen müssen. Für einen dauerhaften Arbeitsplatz können Sie sich vorab über die Möglichkeiten zum Kauf eines Mac mini informieren. Eine virtuelle macOS-Umgebung ersetzt nicht automatisch einen verlässlich verfügbaren Mac mit Xcode.

Bleibt Ihnen für die Abnahme nur ein Windows- oder verwalteter Schulrechner, sind die praktischen Grenzen klar: Sie können dort den nativen iOS-Simulator nicht wie unter macOS starten, Installationsrechte können fehlen, und ein JavaScript-Test bestätigt keinen erfolgreichen iOS-Build. Für einen zeitlich begrenzten Kursabschnitt kann ein gemieteter Remote-Mac eine Alternative zum Kauf sein. Prüfen Sie vorab, ob Ihre Verbindung, der Zugriff auf Xcode und die Kursanforderungen zusammenpassen. Informationen zum Mac-Angebot von MACCOME können Sie dafür als nächsten Schritt heranziehen; wenn Sie dauerhaft an derselben Maschine arbeiten, vergleichen Sie die Mietlösung mit einem eigenen Mac. Für die eigentliche Abnahme zählt am Ende nicht der Zugang allein, sondern dass Ihr Kursprojekt mit der passenden macOS- und Xcode-Umgebung gebaut und im Simulator geprüft wurde.