Zum Hauptinhalt springen

Jutro Platform CLI verwenden

In dieser Lernmission lernen Sie die Verwendung der Jutro Platform Command Line Interface (Jutro Platform CLI) kennen.

Was ist die Jutro Platform CLI?​

Die Jutro Platform CLI ist ein einheitliches, auf Plugins basierendes Tool zur Verwaltung Ihrer Jutro-Apps. Mit einem einzigen Tool können Sie mehrere Teile Ihrer Jutro-App über die Befehlszeile steuern.

Wie wird Jutro Platform CLI dokumentiert?​

Die Dokumentation zu Jutro Platform CLI finden Sie hier. Dieser Abschnitt der Dokumentation enthält Anweisungen zur Installation der Jutro CLI und Informationen zu den Befehlen, die Sie damit ausführen können.

Los geht's: Prüfen, ob Jutro Platform CLI installiert ist​

Wenn Sie die Anweisungen zur Einrichtung der Sandbox befolgt haben, ist eine Version von Jutro Platform CLI auf App-Ebene installiert. Sie können die Installation prüfen, indem Sie npm run jutro über ein Terminal in Ihrem jutro-sandbox-app-Verzeichnis ausführen.

> npm run jutro

The CLI tool for the Jutro Platform

VERSION
  @jutro/cli-platform/10.10.3 darwin-arm64 node-v22.11.0

USAGE
  $ jutro [COMMAND]

TOPICS
  app       Starts, builds, and runs unit tests for your app
  generate  Generates i18n translations, components, and product metadata for your Jutro application
  validate  Validates your Jutro App to ensure that it follows Guidewire standards
Note: Die Angaben im Abschnitt VERSION können je nach Jutro-Version, Knoten und lokaler Hardware abweichen.

Los geht's: Jutro CLI-Übersetzungsbefehl verwenden​

Einer der Anwendungsfälle für Jutro Platform CLI ist die Erstellung von Übersetzungsdateien. Wie auf der Seite Jutro Platform CLI-Befehle erläutert, extrahiert der Befehl generate:i18n Meldungen aus allen JSX- und Metadatendateien, die in der App gefunden wurden, und gruppiert sie standardmäßig in zwei Übersetzungsdateien: src/i18n/lang.json (Vorlagenübersetzungsdatei) und src/i18n/yy.json (Sherlock-Übersetzung).

Die Sandbox-App, die Sie in der Lernmission „Starter-App abrufen“ heruntergeladen haben, enthält nur eine en.json-Datei im Ordner i18n. Es fehlen die Dateien src/i18n/lang.json und src/i18n/yy.json.

jutro-sandbox
└── jutro-sandbox-app
    ├── i18n
    │   └── en.json
    └── ...

Zum Ausführen eines Jutro Platform CLI-Befehls müssen Sie dem Befehl das Präfix npm run jutro voranstellen, um die App-Version von Jutro Platform CLI verwenden zu können. Um den Befehl zum Generieren dieser fehlenden Dateien auszuführen, geben Sie npm run jutro generate:i18n über ein Terminal in Ihrem jutro-sandbox-app-Verzeichnis ein.

> npm run jutro generate:i18n

/___ \         /\ __
/__/\ \  __  __\ \ ,_\  _ __   ___
   _\ \ /\ /\ \ \ / /`'__/ __`\
  /\ _\ \ \ _\ \ \ _\ \ //\ \L\ \
  \ ____/\ ____/ \ __\ _\ ____/
   /___/  /___/   /__/ /_/ /___/


[jutro-cli-platform] - Beginning jsx message extraction.
[jutro-cli-platform] - Jsx message extraction completed successfully.
[jutro-cli-platform] - Extracting UI metadata messages
[jutro-cli-platform] - Finished UI metadata message extraction
[jutro-cli-platform] - Starting pseudo translation (pseudoType: SHERLOCK) from src/i18n/lang.json
[jutro-cli-platform] - Generated pseudo translations to file: src/i18n/yy.json

Nachdem Sie diesen Befehl ausgeführt haben, sehen Sie die neuen Dateien in Ihrem i18n-Ordner.

jutro-sandbox
└── jutro-sandbox-app
    ├── i18n
    │   ├── en.json
    │   ├── lang.json
    │   └── yy.json
    └── ...

Erweitern Sie Ihr Wissen​

Weitere Informationen zur Internationalisierung und Übersetzung in Jutro finden Sie in der Dokumentation zur Internationalisierung.

Eine vollständige Liste der Jutro Platform CLI-Befehle finden Sie auf der Seite mit den Jutro Platform CLI-Befehlen.