iOS - Lingo.dev CLI

Qu'est-ce qu'iOS ?

iOS est le système d'exploitation mobile d'Apple qui alimente 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 source, envoie le contenu traduisible aux modèles de langage avancés, et écrit les fichiers traduits dans votre projet.

À propos de ce guide

Ce guide explique comment configurer le CLI Lingo.dev 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.
Naviguez vers Fichier > Nouveau > Fichier à partir d'un modèle.
Sélectionnez Catalogue de chaînes parmi 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.
Entrez une clé, comme "welcome".
Entrez une valeur, comme "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.8,
  "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 l'interface CLI :
```
npx lingo.dev@latest login
```
Exécutez le pipeline de traduction :
```
npx lingo.dev@latest run
```
L'interface 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 des retraductions inutiles).

Étape 5. Utiliser les traductions

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

Text("welcome")

Étape 6. Prévisualiser les traductions

Naviguez vers Product > Scheme > Edit Scheme.
Dans la boîte de dialogue qui apparaît, sélectionnez Run.
Passez à 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.