Utiliser la CLI de la plate-forme Jutro
Dans cette mission d’apprentissage, vous allez apprendre à utiliser l’interface de ligne de commande de la plate-forme Jutro (CLI de la plate-forme Jutro).
Qu'est-ce que l'interface de ligne de commande de la plate-forme Jutro ?
L'interface de ligne de commande de la plate-forme Jutro est un outil unifié, basé sur des plug-ins et vous permettant de gérer vos applications Jutro. Avec un seul outil, vous pouvez contrôler plusieurs parties de votre application Jutro à partir de la ligne de commande.
Comment la CLI de la plate-forme Jutro est-elle documentée ?
Vous trouverez la documentation sur l'interface de ligne de commande de la plate-forme Jutro ici. Cette section de la documentation contient des instructions d’installation de la CLI Jutro et des informations sur les commandes que vous pouvez exécuter avec.
Activité pratique : vérifier que la CLI de la plate-forme Jutro est installée
Si vous avez suivi les instructions de configuration de Sandbox, une version de niveau application de la CLI de la plate-forme Jutro sera installée. Vous pouvez confirmer qu’elle est bien installée en exécutant npm run jutro à partir d’un terminal de votre répertoire jutro-sandbox-app.
> 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
VERSION peuvent varier en fonction de votre version de Jutro, de Node et de votre matériel local.Activité pratique : utiliser la commande de traduction de la CLI Jutro
L’un des cas d’utilisation de la CLI de la plate-forme Jutro est la création de fichiers de traduction. Comme indiqué dans la page Commandes CLI de la plate-forme Jutro, la commande generate:i18n extrait les messages de tous les fichiers JSX et de métadonnées trouvés dans l’application et les regroupe, par défaut, dans deux fichiers de traduction : src/i18n/lang.json (fichier de traduction du modèle) et src/i18n/yy.json (traduction Sherlock).
L’application Sandbox que vous avez téléchargée dans le cadre de la mission d’apprentissage Obtenir l'application de démarrage contient uniquement un fichier en.json dans son dossier i18n ; il manque les fichiers src/i18n/lang.json et src/i18n/yy.json.
jutro-sandbox
└── jutro-sandbox-app
├── i18n
│ └── en.json
└── ...
Pour exécuter une commande de la CLI de la plate-forme Jutro, vous devez ajouter un préfixe npm run jutro à la commande afin d’utiliser la version de l’application de la CLI de la plate-forme Jutro. Pour exécuter la commande afin de générer ces fichiers manquants, entrez npm run jutro generate:i18n depuis un terminal de votre répertoire jutro-sandbox-app.
> 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
Après avoir exécuté cette commande, les nouveaux fichiers apparaîtront dans votre dossier i18n.
jutro-sandbox
└── jutro-sandbox-app
├── i18n
│ ├── en.json
│ ├── lang.json
│ └── yy.json
└── ...
Approfondir votre apprentissage
Pour en savoir plus sur l’internationalisation et la traduction dans Jutro, reportez-vous à notre documentation sur l’internationalisation.
Pour obtenir la liste complète des commandes de la CLI de la plate-forme Jutro, reportez-vous à notre page Liste des commandes de la CLI.