localize.dev

Dokumentation / Übersetzen / String Catalog

Übersetzen von Xcode-String-Katalogen

Füllen Sie Localizable.xcstrings für SwiftUI- und UIKit-Apps aus, mit %@ und %lld Platzhaltern, Pluralvarianten, %#@name@ Ersetzungen und Kommentaren als Kontext. Auch Legacy .strings Dateien.

Funktionsweise

Ein String-Katalog enthält alle Sprachen in einer Datei. localize-dev translate fügt die fehlenden Sprachen jedem Eintrag hinzu, wobei state auf translated gesetzt ist, bewahrt die Reihenfolge der Schlüssel und das JSON-Layout von Xcode, damit der Diff klein bleibt, und sendet den comment jedes Strings als Kontext. Strings mit shouldTranslate werden übersprungen.

Pluralvarianten erhalten die Formen, die jede Sprache verwendet. Ein Satz mit mehreren Zählungen (%#@photos@ in %#@albums@) wird als Satz plus die Formen jeder Zählung übersetzt und nur einmal geschrieben, wenn alle fertig sind. Gerätespezifische Variationen bleiben für den Xcode-Editor. Legacy en.lproj/Localizable.strings Dateien werden ebenfalls in <lang>.lproj übersetzt, Kommentare bleiben erhalten.

Vorher und nachher

Reale Ausgabe von localize-dev translate --locales de in der ersten Datei. Deutsch wird jedem Eintrag hinzugefügt, inklusive der Pluralvariation, im eigenen Format von Xcode.

Localizable.xcstrings
{
  "sourceLanguage" : "en",
  "strings" : {
    "Delete Photo" : {
      "comment" : "Button in the photo detail toolbar"
    },
    "Hello, %@!" : {

    },
    "%lld photos" : {
      "localizations" : {
        "en" : {
          "variations" : {
            "plural" : {
              "one" : { "stringUnit" : { "state" : "translated", "value" : "%lld photo" } },
              "other" : { "stringUnit" : { "state" : "translated", "value" : "%lld photos" } }
            }
          }
        }
      }
    }
  },
  "version" : "1.0"
}
Localizable.xcstrings · Deutsch
{
  "sourceLanguage" : "en",
  "strings" : {
    "Delete Photo" : {
      "comment" : "Button in the photo detail toolbar",
      "localizations" : {
        "de" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Foto löschen"
          }
        }
      }
    },
    "Hello, %@!" : {
      "localizations" : {
        "de" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Hallo, %@!"
          }
        }
      }
    },
    "%lld photos" : {
      "localizations" : {
        "de" : {
          "variations" : {
            "plural" : {
              "one" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Foto"
                }
              },
              "other" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Fotos"
                }
              }
            }
          }
        },
        "en" : {
          "variations" : {
            "plural" : {
              "one" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld photo"
                }
              },
              "other" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld photos"
                }
              }
            }
          }
        }
      }
    }
  },
  "version" : "1.0"
}

Was intakt bleibt

  • %@, %lld, %1$@ und andere Spezifizierer, überprüft
  • Pluralvarianten und %#@name@ Ersetzungen
  • Xcodes Schlüsselreihenfolge und JSON-Layout, damit Xcode die Datei nicht neu schreibt
  • Übersetzerkommentare, auch in .strings-Dateien

Häufige Fehler und wie sie vermieden werden

Umordnete Argumente

Deutsch und Japanisch erfordern oft eine andere Reihenfolge der Satzargumente. Unnummerierte %@-Argumente bedeuten etwas durch ihre Position, daher wird eine Übersetzung, die sie umordnet, abgelehnt. Nummerierte wie %1$@ können verschoben werden.

Halb übersetzte Ersatzteile

Ein String mit %#@name@ benötigt seinen Satz und alle Formen der Zählungen in jeder Sprache. Sie werden zusammen geschrieben oder gar nicht.

Englische Pluralformen kopiert nach Japanisch

Japanisch, Chinesisch und Koreanisch haben eine Pluralform. Nur other wird für sie geschrieben, statt einer one aus dem Englischen kopiert.

Ausführen

In dem Ordner, der Ihre Lokalisierungsdateien enthält. Sprachen ohne eine Datei erhalten eine. --dry-run zeigt, was sich zuerst ändern würde.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Dann halten Sie es in der CI vollständig. Dies erfordert keinen API-Schlüssel und schlägt fehl, wenn eine Sprache Übersetzungen vermisst:

npx localize-dev check --only translations

Kostenlos für 1.000 Strings pro Monat. Ein String zählt einmal, egal in wie viele Sprachen er übersetzt wird. Erstellen Sie ein kostenloses Konto

Anleitungen für Apps, die dieses Format verwenden

Wenn der Text noch fest in Ihrem Code codiert ist, verschiebt localize-dev run ihn zuerst in dieses Format.