Localisation et Internationalisation
Guide complet pour la localisation d'applications à l'aide des catalogues de chaînes. Les lauréats de l'Apple Design Award pour l'inclusivité prennent toujours en charge plusieurs langues avec un excellent support RTL (Right-to-Left).
Aperçu
Les catalogues de chaînes (.xcstrings) sont le format unifié d'Xcode 15 pour gérer la localisation des applications. Ils remplacent les fichiers .strings et .stringsdict hérités par un format unique basé sur JSON, plus facile à maintenir, à différencier et à intégrer avec les workflows de traduction.
Cette compétence couvre les catalogues de chaînes, les API de localisation SwiftUI/UIKit, la gestion des pluriels, le support RTL, le formatage adapté à la locale, et les stratégies de migration depuis les formats hérités.
Quand utiliser cette compétence
- Configuration de catalogues de chaînes dans Xcode 15+
- Localisation d'applications SwiftUI et UIKit
- Gestion correcte des formes plurielles (essentielle pour de nombreuses langues)
- Prise en charge des langues RTL (arabe, hébreu)
- Formatage des dates, nombres et devises par locale
- Migration depuis les fichiers
.strings/.stringsdicthérités - Préparation des App Shortcuts et App Intents pour la localisation
- Débogage des traductions manquantes ou des formes plurielles incorrectes
Configuration système requise
- Xcode 15+ pour les catalogues de chaînes (
.xcstrings) - Xcode 26+ pour la génération automatique de symboles, la macro
#bundleet la génération de commentaires assistée par IA - iOS 15+ pour
LocalizedStringResource - iOS 16+ pour la localisation des App Shortcuts
- Les versions antérieures d'iOS utilisent les fichiers
.stringshérités
Partie 1 : Catalogues de chaînes (WWDC 2023/10155)
Création d'un catalogue de chaînes
Méthode 1 : Navigateur Xcode
- Fichier → Nouveau → Fichier
- Choisir « String Catalog »
- Nommez-le (par exemple,
Localizable.xcstrings) - Ajouter à la cible
Méthode 2 : Extraction automatique
Xcode 15 peut extraire automatiquement les chaînes depuis :
- Vues SwiftUI (littéraux de chaîne dans
Text,Label,Button) - Code Swift (
String(localized:)) - Objective-C (
NSLocalizedString) - C (
CFCopyLocalizedString) - Fichiers Interface Builder (
.storyboard,.xib) - Valeurs Info.plist
- Phrases des App Shortcuts
Paramètres de build requis :
- « Use Compiler to Extract Swift Strings » → Oui
- « Localization Prefers String Catalogs » → Oui
Structure du catalogue de chaînes
Chaque entrée comporte :
- Clé : Identifiant unique (par défaut : la chaîne anglaise)
- Valeur par défaut : Valeur de repli si la traduction manque
- Commentaire : Contexte pour les traducteurs
- Table de chaînes : Conteneur d'organisation (par défaut : « Localizable »)
Exemple de JSON .xcstrings :
{
"sourceLanguage" : "en",
"strings" : {
"Merci d'avoir fait vos achats chez nous !" : {
"comment" : "Étiquette au-dessus du bouton de paiement",
"localizations" : {
"en" : {
"stringUnit" : {
"state" : "translated",
"value" : "Merci d'avoir fait vos achats chez nous !"
}
},
"es" : {
"stringUnit" : {
"state" : "translated",
"value" : "¡Gracias por comprar con nosotros!"
}
}
}
}
},
"version" : "1.0"
}
États de traduction
Xcode suit l'état de chaque traduction :
- Nouveau (⚪) - La chaîne n'a pas encore été traduite
- Nécessite une révision (🟡) - La source a changé, la traduction peut être obsolète
- Révisé (✅) - Traduction approuvée et à jour
- Obsolète (🔴) - La chaîne n'est plus trouvée dans le code source
Workflow :
- Le développeur ajoute une chaîne → Nouveau
- Le traducteur ajoute une traduction → Révisé
- Le développeur modifie la source → Nécessite une révision
- Le traducteur met à jour → Révisé
- Le développeur supprime le code → Obsolète
Partie 2 : Localisation SwiftUI
LocalizedStringKey (Automatique)
Les vues SwiftUI avec des paramètres String prennent automatiquement en charge la localisation :
// ✅ Automatiquement localisable
Text("Bienvenue à la WWDC !")
Label("Merci d'avoir fait vos achats avec nous !", systemImage: "bag")
Button("Paiement") { }
// Xcode extrait ces chaînes vers le catalogue de chaînes
Comment cela fonctionne : SwiftUI utilise LocalizedStringKey en interne, qui recherche les chaînes dans les catalogues de chaînes.
String(localized:) avec commentaires
Pour une localisation explicite dans le code Swift :
// Basique
let title = String(localized: "Bienvenue à la WWDC !")
// Avec commentaire pour les traducteurs
let title = String(localized: "Bienvenue à la WWDC !",
comment: "Titre de la bannière de notification")
// Avec table personnalisée
let title = String(localized: "Bienvenue à la WWDC !",
table: "WWDCNotifications",
comment: "Titre de la bannière de notification")
// Avec valeur par défaut (clé ≠ texte anglais)
let title = String(localized: "WWDC_NOTIFICATION_TITLE",
defaultValue: "Bienvenue à la WWDC !",
comment: "Titre de la bannière de notification")
Bonne pratique : Incluez toujours un comment pour donner du contexte aux traducteurs.
LocalizedStringResource (Localisation différée)
Pour passer des chaînes localisables à d'autres fonctions :
import Foundation
struct CardView: View {
let title: LocalizedStringResource
let subtitle: LocalizedStringResource
var body: some View {
ZStack {
RoundedRectangle(cornerRadius: 10.0)
VStack {
Text(title) // Résolu au moment du rendu
Text(subtitle)
}
.padding()
}
}
}
// Utilisation
CardView(
title: "Achats récents",
subtitle: "Articles que vous avez commandés la semaine dernière."
)
Différence clé : LocalizedStringResource diffère la recherche jusqu'à son utilisation, permettant aux vues personnalisées d'être entièrement localisables.
AttributedString avec Markdown
// Le formatage Markdown est préservé à travers les localisations
let subtitle = AttributedString(localized: "Texte **gras** et _italique_")
Partie 3 : UIKit & Foundation
Macro NSLocalizedString
// Basique
let title = NSLocalizedString("Achats récents", comment: "Titre du bouton")
// Avec table
let title = NSLocalizedString("Achats récents",
tableName: "Shopping",
comment: "Titre du bouton")
// Avec bundle
let title = NSLocalizedString("Achats récents",
tableName: nil,
bundle: .main,
value: "",
comment: "Titre du bouton")
Bundle.localizedString
let customBundle = Bundle(for: MyFramework.self)
let text = customBundle.localizedString(forKey: "Bienvenue",
value: nil,
table: "MyFramework")
Macros personnalisées
// Objective-C
#define MyLocalizedString(key, comment) \
[myBundle localizedStringForKey:key value:nil table:nil]
Localisation d'Info.plist
Localisez le nom de l'application, les autorisations, etc. :
- Sélectionnez
Info.plist - Éditeur → Ajouter une localisation
- Créez
InfoPlist.stringspour chaque langue :
// InfoPlist.strings (Espagnol)
"CFBundleName" = "Mi Aplicación";
"NSCameraUsageDescription" = "La aplicación necesita acceso a la cámara para tomar fotos.";
Partie 4 : Pluriel
Différentes langues ont des règles de pluriel différentes :
- Anglais : 2 formes (un, autre)
- Russe : 3 formes (un, peu, plusieurs)
- Polonais : 3 formes (un, peu, autre)
- Arabe : 6 formes (zéro, un, deux, peu, plusieurs, autre)
Gestion du pluriel dans SwiftUI
// Xcode crée automatiquement des variations plurielles
Text("\(count) articles")
// Avec formatage personnalisé
Text("\(visitorCount) Visiteurs récents")
Dans le catalogue de chaînes :
{
"strings" : {
"%lld Visiteurs récents" : {
"localizations" : {
"en" : {
"variations" : {
"plural" : {
"one" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Visiteur récent"
}
},
"other" : {
"stringUnit" : {
"state" : "translated",
"value" : "%lld Visiteurs récents"
}
}
}
}
}
}
}
}
}
Format d'exportation XLIFF
Lors de l'exportation pour traduction (Fichier → Exporter les localisations) :
Hérité (stringsdict) :
<trans-unit id="/%lld Visiteurs récents:dict/NSStringLocalizedFormatKey:dict/:string">
<source>%#@recentVisitors@</source>
</trans-unit>
<trans-unit id="/%lld Visiteurs récents:dict/recentVisitors:dict/one:dict/:string">
<source>%lld Visiteur récent</source>
<target>%lld Visitante Recente</target>
</trans-unit>
Catalogue de chaînes (plus propre) :
<trans-unit id="%lld Visiteurs récents|==|plural.one">
<source>%lld Visiteur récent</source>
<target>%lld Visitante Recente</target>
</trans-unit>
<trans-unit id="%lld Visiteurs récents|==|plural.other">
<source>%lld Visiteurs récents</source>
<target>%lld Visitantes Recentes</target>
</trans-unit>
Substitutions avec variables plurielles
// Plusieurs variables avec différentes formes plurielles
let message = String(localized: "\(songCount) chansons sur \(albumCount) albums")
Xcode crée des variations pour la forme plurielle de chaque variable :
songCount: un, autrealbumCount: un, autre- Total des combinaisons : 2 × 2 = 4 entrées de traduction
Partie 5 : Variations d'appareil et de largeur
Chaînes spécifiques à l'appareil
Texte différent pour différentes plateformes :
// Même code, chaînes différentes par appareil
Text("Boutique de nourriture pour oiseaux")
Variations dans le catalogue de chaînes :
{
"Boutique de nourriture pour oiseaux" : {
"localizations" : {
"en" : {
"variations" : {
"device" : {
"applewatch" : {
"stringUnit" : {
"value" : "Nourriture pour oiseaux"
}
},
"other" : {
"stringUnit" : {
"value" : "Boutique de nourriture pour oiseaux"
}
}
}
}
}
}
}
}
Résultat :
- iPhone/iPad : « Boutique de nourriture pour oiseaux »
- Apple Watch : « Nourriture pour oiseaux » (plus court pour les petits écrans)
Variations de largeur
Pour le texte dynamique et les classes de taille :
Text("Paramètres de l'application")
Le catalogue de chaînes peut fournir un texte plus court pour les largeurs étroites.
Partie 6 : Support RTL
Mise en miroir de la disposition
SwiftUI met automatiquement en miroir les dispositions pour les langues RTL :
// ✅ Se met automatiquement en miroir pour l'arabe/l'hébreu
HStack {
Image(systemName: "chevron.right")
Text("Suivant")
}
// iPhone (Anglais) : [>] Suivant
// iPhone (Arabe) : Suivant [<]
leading/trailing vs gauche/droite
Utilisez toujours les directions sémantiques :
// ✅ Correct - se met en miroir automatiquement
.padding(.leading, 16)
.frame(maxWidth: .infinity, alignment: .leading)
// ❌ Faux - ne se met pas en miroir
.padding(.left, 16)
.frame(maxWidth: .infinity, alignment: .left)
Images et icônes
Marquez les images qui doivent / ne doivent pas être retournées :
// ✅ Directionnel - se met en miroir pour RTL
Image(systemName: "chevron.forward")
// ✅ Non directionnel - jamais en miroir
Image(systemName: "star.fill")
// Images personnalisées
Image("backButton")
.flipsForRightToLeftLayoutDirection(true)
Test en mode RTL
Schéma Xcode :
- Modifier le schéma → Exécuter → Options
- Langue de l'application : Arabe / Hébreu
- OU : Langue de l'application → Pseudo-langue droite-à-gauche
Simulateur : Réglages → Général → Langue et région → Ordre des langues préférées
Aperçu SwiftUI :
struct ContentView_Previews: PreviewProvider {
static var previews: some View {
ContentView()
.environment(\.layoutDirection, .rightToLeft)
.environment(\.locale, Locale(identifier: "ar"))
}
}
Partie 7 : Formatage adapté à la locale
DateFormatter
let formatter = DateFormatter()
formatter.locale = Locale.current // ✅ Utilisez la locale actuelle
formatter.dateStyle = .long
formatter.timeStyle = .short
let dateString = formatter.string(from: Date())
// US : "January 15, 2024 at 3:30 PM"
// France : "15 janvier 2024 à 15:30"
// Japon : "2024年1月15日 15:30"
Ne codez jamais en dur les chaînes de format de date :
// ❌ Faux - cassé dans d'autres locales
formatter.dateFormat = "MM/dd/yyyy"
// ✅ Correct - s'adapte à la locale
formatter.dateStyle = .short
NumberFormatter pour la devise
let formatter = NumberFormatter()
formatter.locale = Locale.current
formatter.numberStyle = .currency
let priceString = formatter.string(from: 29.99)
// US : "$29.99"
// UK : "£29.99"
// Japon : "¥30" (arrondit à l'entier)
// France : "29,99 €" (virgule décimale, espace avant le symbole)
MeasurementFormatter
let distance = Measurement(value: 100, unit: UnitLength.meters)
let formatter = MeasurementFormatter()
formatter.locale = Locale.current
let distanceString = formatter.string(from: distance)
// US : "328 ft" (convertit en impérial)
// Pays métriques : "100 m"
Tri adapté à la locale
let names = ["Ångström", "Zebra", "Apple"]
// ✅ Tri adapté à la locale
let sorted = names.sorted { (lhs, rhs) in
lhs.localizedStandardCompare(rhs) == .orderedAscending
}
// Suède : ["Ångström", "Apple", "Zebra"] (Å vient en premier en suédois)
// US : ["Ångström", "Apple", "Zebra"] (Å traité comme A)
Partie 8 : Localisation des App Shortcuts
Phrases avec paramètres
import AppIntents
struct ShowTopDonutsIntent: AppIntent {
static var title: LocalizedStringResource = "Afficher les meilleurs donuts"
@Parameter(title: "Période")
var timeframe: Timeframe
static var parameterSummary: some ParameterSummary {
Summary("\(.applicationName) Tendances pour \(\.$timeframe)") {
\.$timeframe
}
}
}
Le catalogue de chaînes extrait automatiquement :
- Le titre de l'intention
- Les noms des paramètres
- Les modèles de phrases avec espaces réservés
Phrases localisées :
Anglais : "Food Truck Trends for this week"
Espagnol : "Tendencias de Food Truck para esta semana"
Localisation d'AppShortcutsProvider
struct FoodTruckShortcuts: AppShortcutsProvider {
static var appShortcuts: [AppShortcut] {
AppShortcut(
intent: ShowTopDonutsIntent(),
phrases: [
"\(.applicationName) Tendances pour \(\.$timeframe)",
"Afficher les