upgrading-expo

Überblick über den upgrading-expo Skill

Was der upgrading-expo Skill leistet

Der upgrading-expo Skill hilft dir, Expo-SDK-Upgrades mit deutlich weniger blinden Flecken zu planen und umzusetzen als mit einer allgemeinen Frage wie „Wie upgrade ich Expo?“. Im Fokus steht die eigentliche Arbeit: Kernpakete aktualisieren, Dependency-Drift beheben, veraltete Caches leeren und typische Breaking Changes rund um React, die New Architecture, Native Tabs und expo-av-Migrationen früh erkennen.

Für wen sich upgrading-expo eignet

Dieser upgrading-expo skill eignet sich besonders für Frontend-Entwickler, React-Native-Teams und AI-Agents, die eine bestehende Expo-App pflegen. Am meisten bringt er, wenn bereits ein Projekt vorhanden ist und ein praxisnaher Upgrade-Pfad gebraucht wird – nicht nur Zusammenfassungen von Release Notes.

Typische Einsatzfälle:

• Upgrade zwischen aktuellen Expo-SDK-Versionen
• Installations- oder Laufzeitfehler nach expo install --fix beheben
• Migration weg von geänderten oder aufgeteilten Paketen wie expo-av
• Prüfen, ob SDK-spezifische Änderungen wie React 19 oder Native Tabs die eigene Codebasis betreffen

Die eigentliche Aufgabe dahinter

Wer upgrading-expo for Frontend Development bewertet, will in der Regel schnell Antworten auf drei Fragen:

1. Welche Befehlsfolge sollte ich zuerst ausführen?
2. Welche Breaking Changes treffen meine App wahrscheinlich?
3. Welche Dateien oder Code-Muster sollte ich prüfen, bevor ich Zeit in unnötiges Debugging investiere?

Der Skill ist deshalb wertvoll, weil er diese Entscheidungen an einer Stelle bündelt und mit konkreten Migrationsreferenzen verknüpft.

Was ihn von einer generischen Upgrade-Anfrage unterscheidet

Ein normaler Prompt schlägt vielleicht vor: „Upgrade Expo und führe doctor aus.“ Der upgrading-expo Skill geht weiter und verweist auf versionsbezogene Migrationsthemen aus dem Repository, darunter:

• New Architecture als Standard in SDK 53+
• React-19-Änderungen in SDK 54
• React-Compiler-Setup in SDK 54+
• Änderungen an der Native-Tabs-API in SDK 55
• Ersatzpfade für expo-av bei Audio und Video

Damit ist er für gezielte Upgrade-Arbeit deutlich nützlicher als ein breiter React-Native-Troubleshooting-Prompt.

Was du vor der Installation wissen solltest

Dieser Skill ist stärker auf Anleitung als auf Automatisierung ausgelegt. Er bringt keine Skripte mit, die dein Repo selbstständig analysieren. Sein Wert liegt im kuratierten Upgrade-Workflow und in den Referenzdokumenten, die du auf deine eigene Codebasis anwenden kannst. Wenn du einen Push-Button-Migrator suchst, ist das nicht das Richtige. Wenn du eine signalstarke Upgrade-Checkliste mit konkreten Migrationsbeispielen willst, passt er sehr gut.

So verwendest du den upgrading-expo Skill

Installationskontext für upgrading-expo

Wenn deine AI-Umgebung Skills unterstützt, installiere das Expo-Skills-Repository und rufe daraus upgrading-expo auf. Ein gängiges Muster ist:

npx skills add https://github.com/expo/skills --skill upgrading-expo

Wenn deine Toolchain einen anderen Skill-Loader verwendet, zeige auf den Repo-Pfad:
plugins/expo/skills/upgrading-expo

Beginne mit den richtigen Repository-Dateien

Für eine praxisnahe upgrading-expo usage solltest du diese Dateien in folgender Reihenfolge lesen:

1. SKILL.md
2. references/new-architecture.md
3. references/react-19.md
4. references/react-compiler.md
5. references/native-tabs.md
6. references/expo-av-to-audio.md
7. references/expo-av-to-video.md

Diese Reihenfolge entspricht den häufigsten Upgrade-Blockern: zuerst Architektur- und React-Umstellungen, danach featurebezogene Migrationen.

Nutze zuerst die zentrale upgrading-expo Upgrade-Sequenz

Der grundlegende Upgrade-Ablauf des Skills ist kurz und sollte vor tieferem Debugging befolgt werden:

npx expo install expo@latest
npx expo install --fix
npx expo-doctor
npx expo export -p ios --clear
rm -rf node_modules .expo
watchman watch-del-all

Warum das wichtig ist:

• expo@latest richtet das SDK sauber aus
• --fix gleicht die von Expo verwalteten Paketversionen ab
• expo-doctor erkennt Kompatibilitätsprobleme frühzeitig
• das Leeren der Caches entfernt alten Metro-/Native-Status, der Upgrade-Bugs vortäuschen kann

Wenn du unter Linux arbeitest oder Watchman nicht nutzt, passe den Cleanup entsprechend an.

Wisse, wann Preview-Releases sinnvoll sind

Der Skill dokumentiert auch Expo-Beta-Builds über .preview-Versionen unter @next. Das ist hilfreich, wenn du ein kommendes SDK validierst oder einen Fix testen willst, der in Stable noch nicht enthalten ist.

npx expo install expo@next --fix

Nutze das nur bewusst. Preview-Upgrades sind für Produktions-Apps kein guter Standard, außer du testest gezielt ein Pre-Release.

Liefere die Eingaben, die der Skill wirklich braucht

Die besten Prompts für einen upgrading-expo guide enthalten deinen aktuellen und deinen Zielzustand. Gib dem Skill:

• aktuelle Expo-SDK-Version
• verwendeten Package-Manager
• ob du Expo Go oder Development Builds nutzt
• ob du prebuild ausführst
• wichtige Pakete: expo-router, expo-av, react-native-reanimated, eigene Native Modules
• aktuelle Fehler aus Installation, Build oder Runtime
• plattformspezifische Fehler auf iOS, Android oder Web

Ohne diesen Kontext bleibt die Ausgabe zwangsläufig generisch.

So wird aus einem vagen Ziel ein starker Prompt

Schwacher Prompt:

Upgrade my Expo app.

Besserer Prompt:

Use the upgrading-expo skill to move my app from Expo SDK 53 to 54. We use expo-router, expo-av, Reanimated, and development builds. After npx expo install --fix, expo-doctor reports dependency mismatches and our app fails on startup with video playback errors. Tell me the likely breaking changes, the commands to run in order, and the code areas I should inspect first.

Warum das funktioniert:

• die Ausgangs- und Ziel-SDK-Version ist genannt
• risikoreiche Pakete sind aufgeführt
• es wird priorisierte Ausgabe verlangt statt allgemeiner Ratschläge

Ordne deine App den Referenzleitfäden zu

Die Referenzen im Repository sind am nützlichsten, wenn du sie gezielt deiner Dependency-Oberfläche zuordnest:

• Du nutzt expo-av für Sound oder Aufnahmen? Lies references/expo-av-to-audio.md
• Du nutzt expo-av für Video? Lies references/expo-av-to-video.md
• Du upgradeest auf SDK 55 mit expo-router/unstable-native-tabs? Lies references/native-tabs.md
• Du gehst mit Native Modules auf SDK 53+ oder 54+? Lies references/new-architecture.md
• Du bist auf SDK 54? Prüfe sowohl references/react-19.md als auch references/react-compiler.md

Genau hier liefert der Skill echten Informationsgewinn gegenüber einem schnellen Repo-Überflug.

Behalte die risikoreichsten upgrading-expo Problemzonen im Blick

In der Praxis sind dies die häufigsten Bruchstellen, auf die der Skill hinweist:

• nicht sauber ausgerichtete Paketversionen nach einem SDK-Bump
• New-Architecture-Inkompatibilitäten in älteren Native Modules
• Änderungen beim Reanimated-Setup, einschließlich react-native-worklets in SDK 54+
• React-19-API-Änderungen in App- oder Library-Code
• expo-av-Migrationen zu expo-audio und expo-video
• UI-Änderungen auf Router-Ebene in Native Tabs

Wenn deine App einen dieser Bereiche nutzt, lass dir vom Skill lieber eine gezielte Migrations-Checkliste erstellen als nur eine allgemeine Upgrade-Zusammenfassung.

Arbeite mit einem Zwei-Durchgänge-Workflow

Ein gutes Muster für die upgrading-expo usage ist:

1. Einen Upgrade-Plan anhand deiner Versionen und Dependencies anfordern
2. Die Befehle ausführen
3. Die exakten Fehler zurückspielen und einen eingegrenzten Remediation-Plan anfordern

Dieser Skill ist bei strukturierter Triage besonders stark, wenn du konkrete Ausgaben aus expo-doctor, TypeScript, Metro oder nativen Builds mitbringst.

Prüfe release-note-artige Punkte, die der Skill impliziert

Die Breaking-Changes-Checkliste des Skills verweist auf praktische Review-Bereiche:

• entfernte APIs
• geänderte Import-Pfade
• Änderungen an Native Modules, die prebuild erfordern
• Regressionen bei Kamera, Audio und Video
• Navigations-Regressionen

Das heißt: Dein Code-Review sollte nicht bei package.json enden. Suche in deiner Codebasis gezielt nach betroffenen Imports und Komponenten, bevor du die App startest.

Setze upgrading-expo mit prebuild und Native Code mit Bedacht ein

Wenn deine App eigene Native Modules oder Config Plugins verwendet, bleibt der upgrading-expo skill nützlich – du solltest aber mit zusätzlichem Aufwand außerhalb der Markdown-Referenzen rechnen. In solchen Projekten solltest du den Skill bitten, klar zu trennen zwischen:

• reinem JS-Migrationsaufwand
• Aufgaben zur Regenerierung von prebuild
• Kompatibilitätsprüfungen nativer Abhängigkeiten

Diese Trennung reduziert Verwirrung während des Upgrades.

upgrading-expo Skill FAQ

Ist upgrading-expo gut für Einsteiger?

Ja, sofern du bereits ein Expo-Projekt hast und grundlegende Projektdetails teilen kannst. Es ist kein vollständiges Expo-Tutorial. Es ist ein auf Upgrades fokussierter Leitfaden, daher erzielen Einsteiger die besten Ergebnisse, wenn sie aktuelle SDK-Version, Fehler und wichtige Dependencies angeben.

Wo liegen die Grenzen des upgrading-expo Skills?

Der Skill unterstützt bei Upgrade-Planung, Reihenfolge der Befehle und bekannten Migrations-Hotspots. Er analysiert dein gesamtes Repo nicht automatisch und garantiert auch keine Kompatibilität für jede Native Library von Drittanbietern. Bei tieferen nativen Problemen brauchst du unter Umständen weiterhin paketbezogene Doku und GitHub-Issues.

Worin unterscheidet sich upgrading-expo davon, einfach ein LLM nach einem Expo-Upgrade zu fragen?

Der Hauptunterschied ist die Kuratierung. Der upgrading-expo skill lenkt das Modell auf Expo-spezifische Migrationsreferenzen, die ein generischer Prompt leicht übersieht – besonders bei expo-av, React 19, React Compiler, Native Tabs und dem Verhalten der New Architecture.

Wann solltest du upgrading-expo nicht verwenden?

Lass es aus, wenn:

• du eine brandneue Expo-App startest statt eine bestehende zu upgraden
• dein Problem nichts mit SDK-Upgrades zu tun hat
• du ein automatisiertes Codemod oder ein CLI-Migrationstool brauchst
• dein Hauptproblem eine einzelne Native Library eines Drittanbieters mit eigenen speziellen Migrationsschritten ist

Deckt upgrading-expo Preview-SDKs ab?

Ja. Der Skill weist darauf hin, dass Beta-Releases das Suffix .preview nutzen und über @next installiert werden. Das ist hilfreich, um kommende Änderungen zu testen – für normale Upgrades bleibt Stable aber die sicherere Wahl.

Ist upgrading-expo nur für Apps im Managed Workflow gedacht?

Nein. Er ist sowohl für Managed- als auch für prebuild-basierte Expo-Apps nützlich. Allerdings erhöhen prebuild und eigener Native Code die Wahrscheinlichkeit, dass zusätzliche manuelle Kompatibilitätsprüfungen nötig werden.

So verbesserst du den upgrading-expo Skill

Gib dem Skill deine exakte Versionsdifferenz

Die wertvollste Verbesserung ist simpel: Formuliere „von SDK X auf SDK Y“ statt nur „Upgrade Expo“. Ein Großteil der Migrationshinweise ändert sich deutlich, je nachdem, ob du nach SDK 53, 54 oder 55 wechselst.

Nenne die Paketoberfläche, die die Antwort verändert

Für bessere upgrading-expo Ergebnisse solltest du die Pakete nennen, die die Referenzdokumente auslösen:

• expo-av
• expo-router
• react-native-reanimated
• eigene Native Modules
• jedes Paket, das bei expo-doctor fehlschlägt

So kann der Skill von generischen Checklisten zu Hinweisen mit wahrscheinlicher Auswirkung übergehen.

Füge echte Diagnosen ein, keine Umschreibungen

Schlecht:

build failed after upgrade

Besser:

npx expo-doctor says package versions are invalid, Metro reports unresolved import from expo-av, and iOS dev build fails after enabling New Architecture.

Exakte Logs helfen dem Skill, Dependency-Drift von API-Migrationsproblemen zu unterscheiden.

Bitte um priorisierte Ausgabe

Ein starkes Anfrageformat ist:

1. Befehle, die ich jetzt ausführen soll
2. wahrscheinliche Bruchstellen nach Wahrscheinlichkeit
3. Dateien/Imports, nach denen ich suchen sollte
4. Verifikationsschritte nach den Fixes

Mit dieser Struktur lässt sich ein upgrading-expo guide unter Zeitdruck deutlich leichter umsetzen.

Trenne Installationsfehler von Code-Migrationen

Ein häufiger Fehler ist, Paketinstallationsprobleme mit API-Änderungen im Quellcode zu vermischen. Bitte den Skill, in dieser Reihenfolge vorzugehen:

• Dependency-Ausrichtung
• doctor-Ausgabe
• Cache-Reset
• Source-Migrationen
• Runtime-Verifikation

So vermeidest du zirkuläres Debugging.

Fordere codebasis-spezifische Suchmuster an

Eine der besten Möglichkeiten, die Ausgabe des upgrading-expo skill zu verbessern, ist die Bitte um grep-artige Suchziele. Beispiel:

Using the upgrading-expo skill, list the import paths, component names, and hooks I should search for to migrate from expo-av and to verify Native Tabs changes in SDK 55.

Damit wird aus allgemeiner Anleitung eine konkrete Code-Review-Aufgabe.

Prüfe die riskanten Pfade nach dem ersten Durchgang

Teste nach dem ersten Upgrade-Versuch gezielt:

• Audio-Wiedergabe und Aufnahme
• Video-Wiedergabe
• Tab-Navigation
• Startverhalten in Expo Go vs dev build
• jeden Screen mit intensiven Animationen oder Native Modules

In diesen Bereichen treten SDK-Übergangsprobleme, die der Skill abdeckt, am ehesten zutage.

Iteriere mit enger gefassten Folge-Prompts

Bitte den Skill nicht immer wieder, das komplette Upgrade auf einmal zu lösen. Verenge den zweiten Prompt:

• „Focus only on React 19 changes in my shared UI package“
• „Focus only on expo-av video migration“
• „Focus only on New Architecture incompatibilities“

Kleinere Teilbereiche führen meist zu klareren und zuverlässigeren Remediation-Schritten.