Lokalisierung & Internationalisierung
Umfassender Leitfaden zur App-Lokalisierung mit String Catalogs. Gewinner des Apple Design Awards für Inklusivität unterstützen stets mehrere Sprachen mit exzellenter RTL-Unterstützung (Rechts-nach-Links).
Übersicht
String Catalogs (.xcstrings) sind das einheitliche Format von Xcode 15 für die Verwaltung von App-Lokalisierungen. Sie ersetzen veraltete .strings- und .stringsdict-Dateien durch ein einziges JSON-basiertes Format, das einfacher zu warten, zu diffen und in Übersetzungsworkflows zu integrieren ist.
Diese Fähigkeit behandelt String Catalogs, SwiftUI/UIKit-Lokalisierungs-APIs, Plural-Handhabung, RTL-Unterstützung, gebietsschemabasierte Formatierung und Migrationsstrategien von Legacy-Formaten.
Wann diese Fähigkeit verwenden
- Einrichten von String Catalogs in Xcode 15+
- Lokalisieren von SwiftUI- und UIKit-Apps
- Korrekte Handhabung von Pluralformen (entscheidend für viele Sprachen)
- Unterstützung von RTL-Sprachen (Arabisch, Hebräisch)
- Formatieren von Daten, Zahlen und Währungen je nach Gebietsschema
- Migration von veralteten
.strings/.stringsdict-Dateien - Vorbereiten von App Shortcuts und App Intents für die Lokalisierung
- Fehlersuche bei fehlenden Übersetzungen oder falschen Pluralformen
Systemanforderungen
- Xcode 15+ für String Catalogs (
.xcstrings) - Xcode 26+ für automatische Symbolgenerierung,
#bundle-Makro und KI-gestützte Kommentargenerierung - iOS 15+ für
LocalizedStringResource - iOS 16+ für App Shortcuts-Lokalisierung
- Frühere iOS-Versionen verwenden veraltete
.strings-Dateien
Teil 1: String Catalogs (WWDC 2023/10155)
Erstellen eines String Catalogs
Methode 1: Xcode Navigator
- Datei → Neu → Datei
- „String Catalog“ auswählen
- Benennen (z. B.
Localizable.xcstrings) - Zum Ziel hinzufügen
Methode 2: Automatische Extraktion
Xcode 15 kann Zeichenfolgen automatisch extrahieren aus:
- SwiftUI-Ansichten (Zeichenfolgenliterale in
Text,Label,Button) - Swift-Code (
String(localized:)) - Objective-C (
NSLocalizedString) - C (
CFCopyLocalizedString) - Interface Builder-Dateien (
.storyboard,.xib) - Info.plist-Werte
- App Shortcuts-Phrasen
Erforderliche Buildeinstellungen:
- „Compiler zum Extrahieren von Swift-Zeichenfolgen verwenden“ → Ja
- „Lokalisierung bevorzugt String Catalogs“ → Ja
String Catalog-Struktur
Jeder Eintrag hat:
- Schlüssel: Eindeutige Kennung (Standard: der englische Text)
- Standardwert: Fallback, falls Übersetzung fehlt
- Kommentar: Kontext für Übersetzer
- Zeichenfolgentabelle: Organisationscontainer (Standard: „Localizable“)
Beispiel .xcstrings-JSON:
{
"sourceLanguage" : "en",
"strings" : {
"Thanks for shopping with us!" : {
"comment" : "Label above checkout button",
"localizations" : {
"en" : {
"stringUnit" : {
"state" : "translated",
"value" : "Thanks for shopping with us!"
}
},
"es" : {
"stringUnit" : {
"state" : "translated",
"value" : "¡Gracias por comprar con nosotros!"
}
}
}
}
},
"version" : "1.0"
}
Übersetzungszustände
Xcode verfolgt den Zustand jeder Übersetzung:
- Neu (⚪) – Zeichenfolge wurde noch nicht übersetzt
- Benötigt Überprüfung (🟡) – Quelle geändert, Übersetzung möglicherweise veraltet
- Überprüft (✅) – Übersetzung genehmigt und aktuell
- Veraltet (🔴) – Zeichenfolge nicht mehr im Quellcode gefunden
Workflow:
- Entwickler fügt Zeichenfolge hinzu → Neu
- Übersetzer fügt Übersetzung hinzu → Überprüft
- Entwickler ändert Quelle → Benötigt Überprüfung
- Übersetzer aktualisiert → Überprüft
- Entwickler entfernt Code → Veraltet
Teil 2: SwiftUI-Lokalisierung
LocalizedStringKey (Automatisch)
SwiftUI-Ansichten mit String-Parametern unterstützen automatisch Lokalisierung:
// ✅ Automatisch lokalisierbar
Text("Welcome to WWDC!")
Label("Thanks for shopping with us!", systemImage: "bag")
Button("Checkout") { }
// Xcode extrahiert diese Zeichenfolgen in den String Catalog
Wie es funktioniert: SwiftUI verwendet intern LocalizedStringKey, das Zeichenfolgen in String Catalogs nachschlägt.
String(localized:) mit Kommentaren
Für explizite Lokalisierung in Swift-Code:
// Einfach
let title = String(localized: "Welcome to WWDC!")
// Mit Kommentar für Übersetzer
let title = String(localized: "Welcome to WWDC!",
comment: "Notification banner title")
// Mit benutzerdefinierter Tabelle
let title = String(localized: "Welcome to WWDC!",
table: "WWDCNotifications",
comment: "Notification banner title")
// Mit Standardwert (Schlüssel ≠ englischer Text)
let title = String(localized: "WWDC_NOTIFICATION_TITLE",
defaultValue: "Welcome to WWDC!",
comment: "Notification banner title")
Best Practice: Immer comment angeben, um Übersetzern Kontext zu geben.
LocalizedStringResource (Aufgeschobene Lokalisierung)
Zum Übergeben lokalisierbarer Zeichenfolgen an andere Funktionen:
import Foundation
struct CardView: View {
let title: LocalizedStringResource
let subtitle: LocalizedStringResource
var body: some View {
ZStack {
RoundedRectangle(cornerRadius: 10.0)
VStack {
Text(title) // Wird zur Renderzeit aufgelöst
Text(subtitle)
}
.padding()
}
}
}
// Verwendung
CardView(
title: "Recent Purchases",
subtitle: "Items you've ordered in the past week."
)
Hauptunterschied: LocalizedStringResource verschiebt die Suche bis zur Verwendung, sodass benutzerdefinierte Ansichten vollständig lokalisierbar sind.
AttributedString mit Markdown
// Markdown-Formatierung bleibt über Lokalisierungen hinweg erhalten
let subtitle = AttributedString(localized: "**Bold** and _italic_ text")
Teil 3: UIKit & Foundation
NSLocalizedString-Makro
// Einfach
let title = NSLocalizedString("Recent Purchases", comment: "Button Title")
// Mit Tabelle
let title = NSLocalizedString("Recent Purchases",
tableName: "Shopping",
comment: "Button Title")
// Mit Bundle
let title = NSLocalizedString("Recent Purchases",
tableName: nil,
bundle: .main,
value: "",
comment: "Button Title")
Bundle.localizedString
let customBundle = Bundle(for: MyFramework.self)
let text = customBundle.localizedString(forKey: "Welcome",
value: nil,
table: "MyFramework")
Benutzerdefinierte Makros
// Objective-C
#define MyLocalizedString(key, comment) \
[myBundle localizedStringForKey:key value:nil table:nil]
Info.plist-Lokalisierung
App-Namen, Berechtigungen usw. lokalisieren:
Info.plistauswählen- Editor → Lokalisierung hinzufügen
InfoPlist.stringsfür jede Sprache erstellen:
// InfoPlist.strings (Spanisch)
"CFBundleName" = "Mi Aplicación";
"NSCameraUsageDescription" = "La app necesita acceso a la cámara para tomar fotos.";
Teil 4: Pluralbildung
Verschiedene Sprachen haben unterschiedliche Pluralregeln:
- Englisch: 2 Formen (one, other)
- Russisch: 3 Formen (one, few, many)
- Polnisch: 3 Formen (one, few, other)
- Arabisch: 6 Formen (zero, one, two, few, many, other)
SwiftUI-Plural-Handhabung
// Xcode erstellt automatisch Pluralvarianten
Text("\(count) items")
// Mit benutzerdefinierter Formatierung
Text("\(visitorCount) Recent Visitors")
Im String Catalog:
{
"strings" : {
"%lld Recent Visitors" : {
"localizations" : {
"en" : {
"variations" : {
"plural" : {
"one" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Recent Visitor"
}
},
"other" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Recent Visitors"
}
}
}
}
}
}
}
}
}
XLIFF-Exportformat
Beim Exportieren für die Übersetzung (Datei → Lokalisierungen exportieren):
Legacy (stringsdict):
<trans-unit id="/%lld Recent Visitors:dict/NSStringLocalizedFormatKey:dict/:string">
<source>%#@recentVisitors@</source>
</trans-unit>
<trans-unit id="/%lld Recent Visitors:dict/recentVisitors:dict/one:dict/:string">
<source>%lld Recent Visitor</source>
<target>%lld Visitante Recente</target>
</trans-unit>
String Catalog (sauberer):
<trans-unit id="%lld Recent Visitors|==|plural.one">
<source>%lld Recent Visitor</source>
<target>%lld Visitante Recente</target>
</trans-unit>
<trans-unit id="%lld Recent Visitors|==|plural.other">
<source>%lld Recent Visitors</source>
<target>%lld Visitantes Recentes</target>
</trans-unit>
Substitutionen mit Pluralvariablen
// Mehrere Variablen mit unterschiedlichen Pluralformen
let message = String(localized: "\(songCount) songs on \(albumCount) albums")
Xcode erstellt Varianten für jede Pluralform einer Variable:
songCount: one, otheralbumCount: one, other- Gesamtkombinationen: 2 × 2 = 4 Übersetzungseinträge
Teil 5: Geräte- und Breitenvarianten
Gerätespezifische Zeichenfolgen
Unterschiedlicher Text für verschiedene Plattformen:
// Gleicher Code, unterschiedliche Zeichenfolgen pro Gerät
Text("Bird Food Shop")
String Catalog-Varianten:
{
"Bird Food Shop" : {
"localizations" : {
"en" : {
"variations" : {
"device" : {
"applewatch" : {
"stringUnit" : {
"value" : "Bird Food"
}
},
"other" : {
"stringUnit" : {
"value" : "Bird Food Shop"
}
}
}
}
}
}
}
}
Ergebnis:
- iPhone/iPad: „Bird Food Shop“
- Apple Watch: „Bird Food“ (kürzer für kleinen Bildschirm)
Breitenvarianten
Für dynamische Schriftarten und Größenklassen:
Text("Application Settings")
String Catalog kann kürzeren Text für schmale Breiten bereitstellen.
Teil 6: RTL-Unterstützung
Layout-Spiegelung
SwiftUI spiegelt Layouts automatisch für RTL-Sprachen:
// ✅ Wird automatisch für Arabisch/Hebräisch gespiegelt
HStack {
Image(systemName: "chevron.right")
Text("Next")
}
// iPhone (Englisch): [>] Next
// iPhone (Arabisch): Next [<]
Leading/Trailing vs. Left/Right
Immer semantische Richtungen verwenden:
// ✅ Richtig – wird automatisch gespiegelt
.padding(.leading, 16)
.frame(maxWidth: .infinity, alignment: .leading)
// ❌ Falsch – wird nicht gespiegelt
.padding(.left, 16)
.frame(maxWidth: .infinity, alignment: .left)
Bilder und Symbole
Bilder markieren, die gespiegelt werden sollen oder nicht:
// ✅ Richtungsabhängig – wird für RTL gespiegelt
Image(systemName: "chevron.forward")
// ✅ Nicht richtungsabhängig – wird nie gespiegelt
Image(systemName: "star.fill")
// Benutzerdefinierte Bilder
Image("backButton")
.flipsForRightToLeftLayoutDirection(true)
Testen im RTL-Modus
Xcode-Schema:
- Schema bearbeiten → Ausführen → Optionen
- Anwendungssprache: Arabisch / Hebräisch
- ODER: App-Sprache → Rechts-nach-Links-Pseudosprache
Simulator: Einstellungen → Allgemein → Sprache & Region → Bevorzugte Sprachen
SwiftUI-Vorschau:
struct ContentView_Previews: PreviewProvider {
static var previews: some View {
ContentView()
.environment(\.layoutDirection, .rightToLeft)
.environment(\.locale, Locale(identifier: "ar"))
}
}
Teil 7: Gebietsschemabasierte Formatierung
DateFormatter
let formatter = DateFormatter()
formatter.locale = Locale.current // ✅ Aktuelles Gebietsschema verwenden
formatter.dateStyle = .long
formatter.timeStyle = .short
let dateString = formatter.string(from: Date())
// USA: „January 15, 2024 at 3:30 PM“
// Frankreich: „15 janvier 2024 à 15:30“
// Japan: „2024年1月15日 15:30"
Nie Datumsformatzeichenfolgen hartcodieren:
// ❌ Falsch – bricht in anderen Gebietsschemata
formatter.dateFormat = "MM/dd/yyyy"
// ✅ Richtig – passt sich an das Gebietsschema an
formatter.dateStyle = .short
NumberFormatter für Währung
let formatter = NumberFormatter()
formatter.locale = Locale.current
formatter.numberStyle = .currency
let priceString = formatter.string(from: 29.99)
// USA: „$29.99“
// UK: „£29.99“
// Japan: „¥30“ (rundet auf ganze Zahl)
// Frankreich: „29,99 €“ (Komma als Dezimaltrennzeichen, Leerzeichen vor Symbol)
MeasurementFormatter
let distance = Measurement(value: 100, unit: UnitLength.meters)
let formatter = MeasurementFormatter()
formatter.locale = Locale.current
let distanceString = formatter.string(from: distance)
// USA: „328 ft“ (konvertiert in angloamerikanisches Maß)
// Metrische Länder: „100 m“
Gebietsschemaspezifische Sortierung
let names = ["Ångström", "Zebra", "Apple"]
// ✅ Gebietsschemabewusste Sortierung
let sorted = names.sorted { (lhs, rhs) in
lhs.localizedStandardCompare(rhs) == .orderedAscending
}
// Schweden: ["Ångström", "Apple", "Zebra"] (Å kommt im Schwedischen an erster Stelle)
// USA: ["Ångström", "Apple", "Zebra"] (Å wird wie A behandelt)
Teil 8: App Shortcuts-Lokalisierung
Phrasen mit Parametern
import AppIntents
struct ShowTopDonutsIntent: AppIntent {
static var title: LocalizedStringResource = "Show Top Donuts"
@Parameter(title: "Timeframe")
var timeframe: Timeframe
static var parameterSummary: some ParameterSummary {
Summary("\(.applicationName) Trends for \(\$\.timeframe)") {
\$\.timeframe
}
}
}
String Catalog enthält Einträge für:
Show Top Donuts– KurzbefehlstitelTimeframe– Parameterbezeichnung\(.applicationName) Trends for \(\$\.timeframe)– Zusammenfassung mit Platzhaltern
Teil 9: Migration von Strings zu String Catalogs
Manuelle Migration
- String Catalog erstellen: Datei → Neu → Datei → „String Catalog“
- Schlüssel manuell hinzufügen: Xcode-Editor für jeden Schlüssel
- Übersetzungen kopieren: Manuelles Übertragen aus
.strings-Dateien
Automatische Migration (Xcode 15+)
- Legacy
.strings-Dateien beibehalten: Xcode extrahiert daraus - Automatischen Export aktivieren: Buildeinstellungen → „Localization Prefers String Catalogs“ → Ja
- Build ausführen: Xcode generiert
.xcstringsaus vorhandenen.strings-Dateien
Wichtig: Migration ist ein Einwegprozess für XLIFF-Exporte – stellen Sie sicher, dass String Catalogs vollständig sind, bevor Sie Legacy-Dateien entfernen.
Teil 10: Fortgeschrittene Themen
Symbolgenerierung (Xcode 26+)
Xcode 26 kann automatisch typsichere Symbole aus String Catalogs generieren:
// String Catalog definiert den Schlüssel: "welcome_message"
// Xcode generiert:
let text = String(localized: Localizable.welcomeMessage)
KI-gestützte Kommentargenerierung (Xcode 26+)
Xcode 26 kann automatisch Kontextkommentare für Übersetzer generieren, indem es den Quellcode analysiert.
#bundle-Makro (Xcode 26+)
Das #bundle-Makro vereinfacht die Bundle-Referenzierung für Frameworks:
// Vor Xcode 26:
let text = String(localized: "Hello", bundle: .module)
// Ab Xcode 26:
let text = String(localized: "Hello", bundle: #bundle)
Fehlerbehebung
| Problem | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Zeichenfolge nicht lokalisierbar | LocalizedStringKey nicht verwendet | Text() oder String(localized:) verwenden |
| XLIFF-Import schlägt fehl | Veraltete .stringsdict-Plurale | Zu String Catalogs migrieren |
| RTL-Layout nicht gespiegelt | Explizites .leading/.trailing` fehlt | .leading/.trailingstatt.left/.right verwenden |
| Falsches Plural-Format | Falsche Pluralvariablen | Var1 plural other ...-Syntax prüfen |
| Standardtext angezeigt | Sprache wird nicht unterstützt | Sprache zu Xcode-Projekt hinzufügen |
| App Shortcuts nicht lokalisierbar | LocalizedStringResource nicht verwendet | LocalizedStringResource-Typ verwenden |
Zusammenfassung
- String Catalogs sind der empfohlene Weg ab Xcode 15
- LocalizedStringKey automatisiert SwiftUI-Lokalisierung
- Pluralformen variieren stark zwischen Sprachen – String Catalogs handhabt dies nativ
- RTL-Unterstützung ist meist automatisch, erfordert aber semantische Layout-APIs
- Gebietsschemabasierte Formatierung verwendet
Locale.currentanstelle von hartcodierten Mustern - Migration von Legacy-Formaten ist mit Xcode 15+ weitgehend automatisiert