iOS - Lingo.dev CLI

Qu'est-ce qu'iOS ?

iOS est le système d'exploitation mobile d'Apple qui équipe les appareils iPhone et iPad.

Qu'est-ce que Lingo.dev CLI ?

Lingo.dev est une plateforme de traduction alimentée par l'IA. Le CLI Lingo.dev lit les fichiers sources, envoie le contenu traduisible aux grands modèles de langage et réécrit les fichiers traduits dans votre projet.

À propos de ce guide

Ce guide explique comment configurer Lingo.dev CLI dans une application iOS. Vous apprendrez à créer un catalogue de chaînes dans Xcode, à configurer un pipeline de traduction et à tester les résultats dans le simulateur iOS.

Étape 1. Créer un catalogue de chaînes

Ouvrez votre projet dans Xcode.
Accédez à Fichier > Nouveau > Fichier à partir d'un modèle.
Sélectionnez Catalogue de chaînes dans les options de modèle.
Cliquez sur Suivant.
Cliquez sur Créer.

Par défaut, le nom du fichier de catalogue de chaînes est Localizable.xcstrings.

Étape 2. Créer des chaînes localisables

Ouvrez le fichier de catalogue de chaînes.
Sélectionnez la locale source (par exemple, Anglais).
Cliquez sur l'icône + pour ajouter une nouvelle chaîne.
Saisissez une clé, telle que "welcome".
Saisissez une valeur, telle que "Hello, world".

Étape 3. Configurer le CLI

À la racine de votre projet Xcode, créez un fichier i18n.json :

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "xcode-xcstrings": {
      "include": ["Localizable.xcstrings"]
    }
  }
}

Ce fichier définit :

le(s) fichier(s) de catalogue de chaînes que Lingo.dev CLI doit traduire
les langues entre lesquelles traduire

Dans ce cas, la configuration traduit le catalogue de chaînes de l'anglais vers l'espagnol.

Pour en savoir plus, consultez Configuration i18n.json.

Étape 4. Traduire le contenu

Créez un compte Lingo.dev.
Connectez-vous à Lingo.dev via le CLI :
```
npx lingo.dev@latest login
```
Exécutez le pipeline de traduction :
```
npx lingo.dev@latest run
```
La CLI mettra à jour votre fichier Localizable.xcstrings avec le contenu traduit et créera un fichier i18n.lock pour suivre ce qui a été traduit (afin d'éviter les retraductions inutiles).

Étape 5. Utilisez les traductions

Dans votre code Swift, référencez les chaînes localisées en utilisant leurs clés :

Text("welcome")

Étape 6. Prévisualisez les traductions

Accédez à Product > Scheme > Edit Scheme.
Dans la boîte de dialogue qui apparaît, sélectionnez Run.
Basculez vers l'onglet Options.
Dans le menu déroulant App Language, sélectionnez la langue à tester.
Cliquez sur Close.
Exécutez l'application via le simulateur.