Watch-Modus: Automatische Neuübersetzung bei Dateiänderungen

Die Lingo.dev CLI unterstützt jetzt einen leistungsstarken Watch-Modus für den run Befehl, der eine automatische Neuübersetzung ermöglicht, sobald sich Ihre Quelldateien ändern.

Funktionsweise

Wenn Sie die CLI mit dem --watch Flag ausführen, überwacht sie kontinuierlich Ihre konfigurierten Quelldateien (wie in Ihren i18n.json Buckets definiert) auf Änderungen. Wenn eine Datei hinzugefügt, geändert oder gelöscht wird, löst die CLI automatisch den Übersetzungsworkflow aus und aktualisiert Ihre Zielsprachdateien und die i18n.lock nach Bedarf.

Dies ist ideal für schnelle Entwicklung, Live-Vorschau-Umgebungen oder jeden Workflow, bei dem Sie möchten, dass Übersetzungen in Echtzeit mit Ihrem Quellinhalt synchronisiert bleiben.

Verwendung

npx lingo.dev@latest run --watch
  • Die CLI startet im Watch-Modus und zeigt Logs für erkannte Änderungen und den Übersetzungsfortschritt an.
  • Standardmäßig werden Änderungen für 5 Sekunden entprellt, um redundante Durchläufe bei schnellen Bearbeitungen zu vermeiden.
  • Der Prozess läuft weiter, bis Sie ihn stoppen (Strg+C).

Debounce-Option

Sie können die Debounce-Verzögerung (in Millisekunden) mit dem --debounce Flag anpassen:

npx lingo.dev@latest run --watch --debounce 10000

Dieses Beispiel setzt ein 10-Sekunden-Debounce-Fenster zwischen erkannten Änderungen und dem nächsten Übersetzungsdurchlauf.

Funktionen

  • Automatische Neuübersetzung: Aktualisiert Übersetzungen sofort, während Sie Ihre Quelldateien bearbeiten.
  • Entprellte Durchläufe: Verhindert übermäßige Übersetzungsanfragen bei schnellen Dateiänderungen.
  • Fehlerbehandlung: Der Watch-Modus behandelt Fehler elegant und setzt die Überwachung nach Fehlern fort.
  • Alle Dateitypen: Funktioniert mit allen Dateitypen, die von Ihrer i18n.json Konfiguration unterstützt werden.

Wann der Watch-Modus verwendet werden sollte

  • Während der aktiven Entwicklung mehrsprachiger Funktionen
  • Bei der Live-Vorschau von Übersetzungsänderungen in Ihrer App
  • Für kontinuierliche Integration mit lokalen oder cloudbasierten Entwicklungsumgebungen

Tipp: Der Watch-Modus ist für die Entwicklung und schnelle Iteration konzipiert. Für Produktionsumgebungen oder CI/CD verwenden Sie den Standard-Befehl run ohne --watch für einmalige Übersetzungsdurchläufe.