
Den kompletta guiden till lokalisering av iOS-appar
Från Localizable.strings till App Store-metadata: lokalisera din iOS-app med Xcode, SwiftUI, Fastlane och automatiserad AI-översättning.
Aktivera lokalisering i Xcode
Öppna projektinställningarna i Xcode, gå till Info > Localizations och lägg till språken som du vill stödja. Xcode skapar automatiskt .lproj-kataloger för varje språk.
// In Xcode:
// 1. Select your project in the navigator
// 2. Go to Info tab > Localizations
// 3. Click + to add languages (e.g., German, Japanese)
// 4. Select which files to localize
//
// Xcode creates .lproj directories automatically:
// en.lproj/Localizable.strings
// de.lproj/Localizable.strings
// ja.lproj/Localizable.stringsSkapa Localizable.strings
Standardfilen för iOS-lokalisering använder nyckel-värde-par som avgränsas med likhetstecken och varje rad avslutas med semikolon. Placera den i mappen Base.lproj för källspråket.
// Base.lproj/Localizable.strings
"welcome_title" = "Welcome to MyApp";
"login_button" = "Sign In";
"settings_label" = "Settings";
"greeting" = "Hello, %@!"; // %@ = string placeholder
"item_count" = "%d items"; // %d = integer placeholder// ❌ Common mistakes in .strings files:
// Missing semicolon — file loads but translations are empty
"welcome_title" = "Welcome"
// Unescaped quotes — causes parse error
"message" = "Click "here" to continue";
// ✅ Correct versions:
"welcome_title" = "Welcome";
"message" = "Click \"here\" to continue";Migrera till String Catalogs (Xcode 15+)
String Catalogs (.xcstrings) är Apples moderna ersättning för .strings-filer. De erbjuder en visuell redigerare i Xcode, automatisk extrahering av strängar från dina SwiftUI-vyer och inbyggt stöd för pluralformer.
// Xcode 15+ String Catalog (Localizable.xcstrings)
// Xcode automatically extracts strings from your code
// and manages translations in a visual editor.
// In SwiftUI, strings are automatically localizable:
Text("Welcome to MyApp")
Text("Hello, \(userName)!")
// Mark strings explicitly:
let title = String(localized: "welcome_title")Använd lokaliserade strängar i SwiftUI och UIKit
SwiftUI-vyn Text lokaliserar automatiskt strängliteraler. UIKit använder NSLocalizedString. För iOS 16+ ger det moderna API:et String(localized:comment:) en tydligare syntax med inbyggt kompilatorstöd.
import SwiftUI
struct ContentView: View {
let userName: String
var body: some View {
VStack {
// ✅ SwiftUI auto-localizes string literals
Text("welcome_title")
// ⚠️ This does NOT localize (String interpolation)
// Text("Hello, \(userName)")
// ✅ Use String(localized:) for dynamic strings
Text(String(localized: "greeting \(userName)"))
// ✅ UIKit style (works everywhere)
let title = NSLocalizedString(
"settings_label",
comment: "Settings screen title"
)
// ✅ Modern API (iOS 16+)
let modern = String(
localized: "welcome_title",
comment: "Main screen title"
)
}
}
}Hantera pluralformer
iOS använder .stringsdict-filer för pluralregler med stöd för alla CLDR-kategorier: zero, one, two, few, many, other. String Catalogs hanterar pluralformer med en visuell redigerare i Xcode, vilket är betydligt enklare än att skriva stringsdict-XML för hand.
<!-- Localizable.stringsdict -->
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>items_count</key>
<dict>
<key>NSStringLocalizedFormatKey</key>
<string>%#@count@</string>
<key>count</key>
<dict>
<key>NSStringFormatSpecTypeKey</key>
<string>NSStringPluralRuleType</string>
<key>NSStringFormatValueTypeKey</key>
<string>d</string>
<key>zero</key>
<string>No items</string>
<key>one</key>
<string>%d item</string>
<key>other</key>
<string>%d items</string>
</dict>
</dict>
</dict>
</plist>
// Usage in Swift:
String(format: NSLocalizedString("items_count", comment: ""),
itemCount)Lokalisera App Store-metadata med Fastlane
Använd verktyget deliver i Fastlane för att lagra App Store-metadata – appnamn, undertitel, beskrivning, sökord och versionsinformation – som versionshanterade textfiler i ditt repository, organiserade efter språkvariant.
# Install Fastlane
$ gem install fastlane
# Initialize deliver for App Store metadata
$ fastlane deliver init
# Directory structure created:
# fastlane/metadata/
# ├── en-US/
# │ ├── name.txt # App name (30 chars)
# │ ├── subtitle.txt # Subtitle (30 chars)
# │ ├── description.txt # Full description
# │ ├── keywords.txt # Search keywords (100 chars)
# │ ├── release_notes.txt # What's New
# │ └── promotional_text.txt
# ├── de-DE/
# │ └── ...
# └── ja/
# └── ...
# Push metadata to App Store Connect:
$ fastlane deliverTesta lokaliseringen
Testa lokaliserat innehåll utan att ändra enhetens språk. Använd åsidosättningar i Xcode-scheman för att köra appen på valfritt språk, SwiftUI-förhandsvisningar med språkmiljö och XCUITest med startargument för automatiserade tester.
// 1. Xcode Scheme Override:
// Edit Scheme > Run > Options > App Language > Choose language
// 2. SwiftUI Preview with locale:
struct ContentView_Previews: PreviewProvider {
static var previews: some View {
ContentView()
.environment(\.locale, Locale(identifier: "de"))
ContentView()
.environment(\.locale, Locale(identifier: "ja"))
ContentView()
.environment(\.locale, Locale(identifier: "ar"))
}
}
// 3. XCUITest with language override:
let app = XCUIApplication()
app.launchArguments += ["-AppleLanguages", "(de)"]
app.launchArguments += ["-AppleLocale", "de_DE"]
app.launch()Automatisera översättningskvaliteten
Automatisera översättningar
Översätt dina .strings-, .xcstrings- och Fastlane-metadatafiler med AI. Automatisera översättningen av både strängar i appen och App Store-metadata för en helt lokaliserad närvaro.
# Translate .strings files
> Translate Base.lproj/Localizable.strings
to Japanese, German, and Spanish
# Translate App Store metadata too
> Translate fastlane/metadata/en-US/
to de-DE, ja, es-MX
✓ 6 files translated in 3.2sBonus: smart reservspråk med LocaleChain
Som standard går iOS över till ditt utvecklingsspråk när användarens exakta språkvariant inte är tillgänglig. En användare med pt-BR ser engelska i stället för portugisiska om endast översättningar för pt-PT finns. LocaleChain löser detta med konfigurerbara reservkedjor.
LocaleChain är ett Swift-paket med öppen källkod. Visa på GitHub
// Swift Package Manager
// File > Add Package Dependencies >
// https://github.com/i18n-agent/ios-localechain.gitimport LocaleChain
// In your App init or AppDelegate:
LocaleChain.configure() // Activates all default chains
// pt-BR user with only pt-PT translations?
// → Shows Portuguese instead of falling back to English
// Custom overrides for your specific locales:
LocaleChain.configure(
overrides: ["es-MX": ["es-419", "es"]]
)Vanliga fallgropar
Syntaxfel i .strings-filer
SwiftUI-textinterpolering lokaliseras inte
Widgetar och tillägg visar råa nycklar
Saknade översättningar visar nycklar i produktion
Rekommenderad filstruktur
MyApp/
├── MyApp.xcodeproj
├── MyApp/
│ ├── Base.lproj/
│ │ ├── Localizable.strings # Source strings
│ │ └── Localizable.stringsdict # Plural rules
│ ├── en.lproj/
│ │ └── Localizable.strings
│ ├── de.lproj/
│ │ └── Localizable.strings
│ ├── ja.lproj/
│ │ └── Localizable.strings
│ ├── Localizable.xcstrings # OR String Catalog
│ └── Info.plist
├── MyAppTests/
├── fastlane/
│ ├── Fastfile
│ └── metadata/
│ ├── en-US/
│ │ ├── name.txt
│ │ ├── description.txt
│ │ └── keywords.txt
│ ├── de-DE/
│ └── ja/
└── Package.swiftProva i18n Agent nu
Släpp din översättningsfil här
JSON, YAML, PO, XML, CSV, Markdown, Properties
eller klicka för att välja en fil
Målspråk
Reservspråk med ios-localechain
När en översättningsnyckel saknas i en regional språkvariant som de-AT går iOS direkt över till utvecklingsspråket i stället för att först kontrollera det överordnade språket de.
// Swift Package Manager
// https://github.com/i18n-agent/ios-localechainimport LocaleChain
LocaleChain.configure(overrides: [
"de": ["en-GB", "en"],
"pt-BR": ["pt", "en"],
"zh-Hant-HK": ["zh-Hant", "zh", "en"],
])Se vår guide till reservspråk för en fullständig lista över ramverk som stöds och 75 inbyggda kedjor. Learn more →