iOS - Lingo.dev CLI

Was ist iOS?

iOS ist Apples mobiles Betriebssystem, das iPhone- und iPad-Geräte antreibt.

Was ist Lingo.dev CLI?

Lingo.dev ist eine KI-gestützte Übersetzungsplattform. Die Lingo.dev CLI liest Quelldateien, sendet übersetzbare Inhalte an große Sprachmodelle und schreibt übersetzte Dateien zurück in Ihr Projekt.

Über diese Anleitung

Diese Anleitung erklärt, wie Sie Lingo.dev CLI in einer iOS-App einrichten. Sie lernen, wie Sie einen String Catalog in Xcode erstellen, eine Übersetzungspipeline konfigurieren und die Ergebnisse im iOS-Simulator testen.

Schritt 1. Erstellen Sie einen String Catalog

Öffnen Sie Ihr Projekt in Xcode.
Navigieren Sie zu Datei > Neu > Datei aus Vorlage.
Wählen Sie String Catalog aus den Vorlagenoptionen.
Klicken Sie auf Weiter.
Klicken Sie auf Erstellen.

Standardmäßig lautet der Name der String Catalog-Datei Localizable.xcstrings.

Schritt 2. Erstellen Sie lokalisierbare Strings

Öffnen Sie die String Catalog-Datei.
Wählen Sie die Quellsprache (z. B. Englisch).
Klicken Sie auf das +-Symbol, um einen neuen String hinzuzufügen.
Geben Sie einen Schlüssel ein, z. B. "welcome".
Geben Sie einen Wert ein, z. B. "Hello, world".

Schritt 3. Konfigurieren Sie die CLI

Erstellen Sie im Stammverzeichnis Ihres Xcode-Projekts eine i18n.jsonDatei:

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

Diese Datei definiert:

die String Catalog-Datei(en), die Lingo.dev CLI übersetzen soll
die Sprachen, zwischen denen übersetzt werden soll

In diesem Fall übersetzt die Konfiguration den String Catalog von Englisch nach Spanisch.

Weitere Informationen finden Sie unter i18n.json-Konfiguration.

Schritt 4. Übersetzen Sie den Inhalt

Registrieren Sie sich für ein Lingo.dev-Konto.
Melden Sie sich über die CLI bei Lingo.dev an:
```
npx lingo.dev@latest login
```
Führen Sie die Übersetzungspipeline aus:
```
npx lingo.dev@latest run
```
Die CLI aktualisiert Ihre Localizable.xcstrings Datei mit dem übersetzten Inhalt und erstellt eine i18n.lock Datei, um nachzuverfolgen, was übersetzt wurde (um unnötige erneute Übersetzungen zu vermeiden).

Schritt 5. Verwenden Sie die Übersetzungen

Referenzieren Sie in Ihrem Swift-Code die lokalisierten Strings über ihre Schlüssel:

Text("welcome")

Schritt 6. Vorschau der Übersetzungen

Navigieren Sie zu Product > Scheme > Edit Scheme.
Wählen Sie im angezeigten Dialog Run aus.
Wechseln Sie zum Tab Options.
Wählen Sie aus dem Dropdown-Menü App Language die zu testende Sprache aus.
Klicken Sie auf Close.
Führen Sie die App über den Simulator aus.