iOS Internationalisierungs- und Lokalisierungsleitfaden + Demo-App

Teil 2: Einrichten Ihres Xcode-Projekts

Wir werden mit Bookshelf arbeiten, einer einfachen Demo-App, die es Benutzern ermöglicht, zu verfolgen, wie viele Bücher sie gelesen haben. Sie ist mit SwiftUI erstellt und bewusst minimalistisch gehalten.

Am Ende dieses Leitfadens wird BookShelf in Englisch, Spanisch und Arabisch laufen, Plural-Strings in allen drei Sprachen korrekt behandeln und sein Layout für arabische Leser automatisch spiegeln.

Öffnen Sie BookShelf in Xcode und wählen Sie die Projektdatei im Navigator aus. Scrollen Sie unter dem Tab Info zum Abschnitt Localizations. Englisch ist bereits als Basissprache aufgeführt. Klicken Sie auf die Schaltfläche +, um Ihre erste Sprache hinzuzufügen. Für diese Demo fügen wir Spanisch und Arabisch hinzu.

Fügen Sie als Nächstes einen String Catalog hinzu.

1. Klicken Sie mit der rechten Maustaste auf Ihr Projekt und wählen Sie New File from Template.
2. Suchen Sie nach String Catalog und fügen Sie es hinzu. Der Standardname ist Localizable.xcstrings. Sie müssen ihn nicht ändern.
3. Erstellen Sie das Projekt einmal mit Cmd+B. Xcode scannt Ihren Code, findet jeden lokalisierbaren String und füllt den Katalog automatisch aus.

Selecting New File from Template

Adding String Catalog

Nachdem Sie das Projekt erstellt haben, öffnen Sie Localizable.xcstrings und Sie werden sehen, dass Xcode bereits jedes String-Literal aus Ihren SwiftUI-Ansichten extrahiert und mit ihren englischen Werten in den Katalog aufgenommen hat. Für die meisten Strings ist das alles, was Sie tun müssen.

Es gibt ein paar Muster, bei denen Xcode dies nicht automatisch tun kann, und beide schlagen stillschweigend fehl, wobei die App einfach den unübersetzten String ohne Warnung anzeigt.

Wenn Sie eine Variable an eine Textansicht anstelle eines String-Literals übergeben, behandelt SwiftUI sie als einfachen String und überspringt die Katalogsuche vollständig.

// NOT localized
let title = "welcome_title"
Text(title)

// Localized correctly
Text(LocalizedStringKey(title))

// NOT localized
let title = "welcome_title"
Text(title)

// Localized correctly
Text(LocalizedStringKey(title))

Für Strings, die Sie in einem View Model, einer Hilfsfunktion oder an einem beliebigen Ort außerhalb einer SwiftUI-Ansicht lokalisieren müssen, verwenden Sie String(localized:) anstelle eines einfachen Strings.

let errorMessage = String(localized: "error_generic")

let errorMessage = String(localized: "error_generic")

Strings benötigen manchmal unterschiedliche Versionen je nach Kontext. Dazu gehören Pluralformen, die sich mit einer Zahl ändern, oder Text, der sich je nach Gerät unterscheidet. Sie können beides direkt im String Catalog verwalten.

Pluralisierung

BookShelf, unsere Demo-App, zeigt die Anzahl der Bücher im Regal des Benutzers an. Im Englischen ist das einfach: „1 book“ vs. „3 books“. Aber Pluralregeln variieren in verschiedenen Sprachen, und ein Fehler hierbei führt zu unnatürlichem Text in anderen Locales.

Beginnen Sie mit dem String in Ihrer SwiftUI-Ansicht:

Text("\(bookCount) books on your shelf")

Öffnen Sie den String Catalog, klicken Sie mit der rechten Maustaste auf den Schlüssel und wählen Sie Vary by Plural. Xcode generiert die Pluralkategorien automatisch und füllt sie mit dem Quellstring vorab aus.

Selecting Vary by Plural

Automatically generated plurals

Für Englisch sehen Sie One und Other. Korrigieren Sie einfach das Feld One in die Singularform: „%lld book on your shelf“. Die Form Other ist bereits korrekt.

Xcode markiert beide als Needs Review, bis Sie sie bestätigen. Sobald Sie die Form One korrigiert haben, können Sie sie als überprüft markieren.

Sie werden auch Arabisch und Spanisch in der Seitenleiste mit 0 % sehen. Sie müssen für diese Sprachen jetzt nichts tun. Später, wenn Sie für die Übersetzung nach PTC exportieren, wird die Pluralstruktur mit der Datei übertragen. Für Arabisch generiert PTC Übersetzungen für alle sechs Pluralkategorien (Null, Eins, Zwei, Wenige, Viele und Andere), da die arabische Grammatik alle sechs erfordert. Für Spanisch sind es zwei, genau wie im Englischen.

Gerätevariationen

Einige Texte sollten je nach Gerät variieren, z. B. „Zum Fortfahren tippen“ auf dem iPhone vs. „Zum Fortfahren klicken“ auf dem Mac. Um dies einzurichten, klicken Sie mit der rechten Maustaste auf den Schlüssel im Katalog und wählen Sie Vary by Device. Fügen Sie die Geräte hinzu, die Sie anpassen möchten, und geben Sie den entsprechenden String für jedes Gerät ein. Zur Laufzeit liefert iOS die Version, die dem aktuellen Gerät entspricht.

Gerätevariationen sind seltener als Pluralvariationen, aber nützlich für Apps, die sowohl auf iOS als auch auf macOS laufen.