Bestehende React-Nachrichten migrieren

Stelle eine kleine React-Test-Fixture auf Nachrichten mit explizitem Quelltext und Kontext um, ohne Platzhalter, Pluralverhalten oder akzeptierte Übersetzungen zu verlieren.

Ein bestehender React-Katalog enthält bereits wertvolle Festlegungen: Identitäten für das Nachschlagen von Nachrichten, Interpolationsregeln, Pluralverhalten und Übersetzungen, die bereits eine Prüfung durchlaufen haben. Die Umstellung auf Nachrichten mit Quelltext und Kontext sollte diese Arbeit erhalten. Konvertiere zunächst eine vollständige Komponente, ordne ihre akzeptierten Übersetzungen den neuen Identitäten zu und vergleiche die gerenderte Ausgabe, bevor du die Migration ausweitest.

Erfasse das bisherige Verhalten, bevor du die Identität änderst #

Wähle eine Komponente mit einer Beschriftung, einer Variablen, einem Link, einer Anzahl und einer bedingten Nachricht. Halte ihre bisherigen Schlüssel, Quell- und Zieltexte, die Interpolationssyntax, den Namensraum und die Sprache des Providers fest. Rendere sie mit festen Werten in der Quellsprache und einer Zielsprache. So erhältst du ein konkretes Ergebnis, das bei der Migration erhalten bleiben soll.

Ein bestehender Aufruf im i18next-Stil könnte zum Beispiel so aussehen:

tsx
t("account.greeting", { name });

Der zugehörige Quellkatalog könnte Welcome, {{name}} enthalten. Übernimm diese Interpolationssyntax nicht unverändert in einen neuen Nachrichtenvertrag. Die explizite React-Nachricht verwendet eine benannte Variable {name}:

tsx
l.text("Welcome, {name}", {
  context: "Greeting on the signed-in account page",
  values: { name },
});

Die hier gezeigte Änderung der Begrenzungszeichen gilt nur für diese Konfiguration der bisherigen Bibliothek. Kontrolliere die installierte Bibliothek, bevor du weitere Nachrichten konvertierst: Benutzerdefinierte Begrenzungszeichen für die Interpolation und andere Pluralkonventionen können andere Anpassungen erfordern.

Bilde das Nachrichtenverhalten ab, nicht nur die Methodennamen #

Verwende text für einfache Nachrichten mit Werten, rich für benannte Komponenten-Slots, plural für anzahlabhängige Formen und select für Alternativen bei exakten Werten mit other als Rückfalloption. Interaktive Nachrichten mit Rich-Text enthält ein vollständiges Beispiel für alle vier Varianten.

Eine bisherige Rich-Text-Nachrichtenkomponente kodiert Links möglicherweise über Indizes. Ersetze diese Indizes durch aussagekräftige benannte Slots und belasse das Linkziel im Code. Behalte Variablennamen, Typen und semantische Rollen bei. Ein bisheriger Pluralkatalog speichert möglicherweise Schlüssel mit Suffixen; die neue Laufzeit setzt ihre Pluralnachricht aus Formen zusammen. Stelle sicher, dass das Verhalten in der Zielsprache stimmt, statt Suffixschlüssel mechanisch umzubenennen.

Wähle einen Kontext, der den Verwendungszweck der Nachricht erklärt. Die neue Identität ergibt sich aus Quelltext und Kontext statt aus account.greeting. Führe eine Migrationstabelle mit dem bisherigen Schlüssel, der Sprache, dem extrahierten neuen Schlüssel und etwaigen Syntaxanpassungen. Für die Begrüßung hält die entsprechende Zeile die Umstellung von {{name}} auf {name} fest. Anhand dieser Zuordnung kann ein Prüfer akzeptierte Formulierungen bis in den neuen Katalog nachverfolgen und erkennen, welche Nachrichten noch nicht zugeordnet sind.

Extrahiere und importiere gezielt einen kleinen Katalog #

Installiere @lingo.dev/react und konfiguriere LingoProvider mithilfe des React-Schnellstarts. Verwende React 19 für die aktuelle Provider-Implementierung; der deklarierte Versionsbereich der Peer-Abhängigkeit für React 18 ersetzt keine Tests mit einer älteren Anwendung. Führe nach der Konvertierung der Komponente die installierte CLI aus:

sh
lingo extract --src src --source-locale en

Wenn du keine abweichenden Pfade angegeben hast, sieh dir locales/en.jsonc und lingo.d.ts an. Suche jede Quellnachricht und ihren Kontext und kopiere dann den tatsächlich extrahierten Schlüssel in die Migrationstabelle. Wenn du den bisherigen Schlüssel beibehältst oder einen Hash erfindest, lässt sich der Zieltext zur Laufzeit nicht mehr über den richtigen Schlüssel finden.

Lege jeden akzeptierten Zieltext unter dem zugeordneten neuen Schlüssel ab. Passe die Syntax für Platzhalter, Rich-Text-Slots und Pluralformen gezielt an und bewahre dabei die Bedeutung. Lade über den Workflow zum Laden von Katalogen eine Zuordnung von Hashes zu Zeichenfolgen für die Zieltexte. Verwende dabei die aktiven Schlüssel aus der passenden Quelle, wenn Zielmetadaten fehlen. Lass nicht zugeordnete Einträge als ausstehende Arbeit sichtbar, statt sie als veraltet einzustufen.

Übergib die gewünschte Sprache und die zugehörigen Zielnachrichten gemeinsam an LingoProvider. Belasse während der schrittweisen Migration den bisherigen und den neuen Provider jeweils um die zugehörigen Aufrufer. Der Provider-Vertrag erläutert das Zusammenführen bei gleicher Sprache und die Isolation bei unterschiedlichen Sprachen; kontrolliere diese Aspekte bei der Migration einer verschachtelten Ansicht.

Kontrolliere Fälle mit fehlenden und fehlerhaften Nachrichten #

Rendere die Test-Fixture mit denselben Werten wie vor der Migration. Vergleiche die sichtbare Bedeutung, die Platzierung der Variablen, das Linkverhalten, die Pluralausgabe und die Auswahl der Rückfalloption. Berücksichtige Anzahlen von null, eins und größeren Werten, lange Variablenwerte sowie einen unbekannten Auswahlwert.

Entferne einen Zieleintrag in einer lokalen Test-Fixture und kontrolliere den Rückfall auf den Quelltext. Bei fehlenden oder leeren Nachrichten kann der Quelltext ausgegeben werden. Eine nutzbare Ansicht beweist daher nicht, dass alle Zieltexte vorhanden sind. Führe Konsistenzprüfungen für die Extraktion und TypeScript-Prüfungen unter Einbeziehung der generierten Deklarationen aus. Führe anschließend die bestehenden Rendering-Tests der Anwendung aus. Typen stellen die Kompatibilität der Aufrufe sicher, nicht die Übersetzungsqualität.

Sieh dir bei einem fehlerhaften Rich-Text-Tag oder einer fehlerhaften ICU-Nachricht die Ausgabe und die Diagnosemeldungen an. Die neue Laufzeit kann Markup unverändert oder eine unformatierte Vorlage anzeigen. Gleiche dieses Verhalten daher mit den Anforderungen der Anwendung ab, bevor du die bisherige Laufzeit entfernst. Die React-Fehlerbehebung dokumentiert diese Grenzen.

Nutze Agentenunterstützung mit anschließender Prüfung #

Bitte den Agenten, die bestehende Bibliothek zu untersuchen, eine Schlüsselzuordnung beizubehalten, nicht unterstützte Muster zu erkennen und Quelltextänderungen vom Katalogimport zu trennen. Führe eine Prüfung seiner vorgeschlagenen Quelltext- und Katalogänderungen durch, bevor du sie übernimmst.

Weite die Migration komponenten- oder namensraumweise aus, sobald die Test-Fixture ihre Rendering- und nativen Prüfungen bestanden hat. Behalte beide Kataloge bei, bis für jeden Aufrufer und jeden akzeptierten Zieltext ein verifiziertes Ziel vorhanden ist. Entferne den bisherigen Provider und die Abhängigkeit erst, wenn sie im verbleibenden Code nicht mehr verwendet werden. API-Clients und Router-Adapter haben eigene Aufgaben; die Umstellung der Nachrichtenlaufzeit ersetzt sie nicht.