Localiser une application iOS en vietnamien : guide Xcode et App Store

💡 Pour localiser une app iOS en vietnamien : ajoutez vi dans Xcode Project Settings, utilisez les String Catalogs (.xcstrings) pour le suivi automatique des chaînes, écrivez une seule branche de pluriel (le vietnamien n'a qu'une catégorie CLDR), localisez Info.plist et renseignez toutes les métadonnées App Store Connect. Testez les mises en page avant la publication : les chaînes vietnamiennes sont 10-20% plus longues.

Que couvre la localisation iOS en vietnamien ?

La localisation iOS en vietnamien couvre quatre couches indépendantes : l'extraction des chaînes au niveau du code (NSLocalizedString / String(localized:)), les règles de pluriel (stringsdict ou variantes dans String Catalog), la localisation des ressources (images, storyboards, Info.plist) et les métadonnées de la fiche App Store (nom, sous-titre, description, mots-clés, captures d'écran). Les quatre doivent être complètes avant que votre application soit prête pour le marché vietnamien.

Pour ajouter le vietnamien, ouvrez votre .xcodeproj dans Xcode, sélectionnez le projet dans l'onglet Info, cliquez sur + sous Localizations et choisissez Vietnamese (vi). Xcode crée un dossier vi.lproj/ pour chaque ressource localisée. Pour les projets SwiftUI avec String Catalogs, Xcode collecte automatiquement les chaînes vietnamiennes au prochain build. L'identifiant de langue est vi ; n'utilisez vi-VN que si un SDK tiers l'exige.

Comment String Catalogs gère-t-il les règles de pluriel vietnamiennes dans Xcode 27 ?

Les String Catalogs (.xcstrings) sont l'approche recommandée pour les nouveaux projets depuis Xcode 16. Ce fichier JSON structuré centralise toutes les variantes de traduction, règles de pluriel et textes par appareil. Après l'ajout du vietnamien et un build, Xcode scanne automatiquement les vues SwiftUI et les appels UIKit pour collecter les chaînes localisables et les ajouter au catalog.

Le vietnamien n'a qu'une catégorie de pluriel CLDR : other. Chaque nombre, 1, 2, 100, correspond à la même forme du mot. Le vietnamien exprime la quantité par des classificateurs et le contexte, non par des déclinaisons. "1 mục" et "5 mục" (1 et 5 éléments) sont identiques en forme.

Dans un String Catalog, le slot de pluriel vietnamien ne montre qu'une seule branche : other. Pour les fichiers .stringsdict, vous ne définissez que la clé other pour le vietnamien. Pour des messages d'état vide spécifiques, utilisez la clé de correspondance exacte =0 avec un texte tel que "Không có mục nào" (Aucun élément).

<!-- Exemple .stringsdict pour le vietnamien (branche unique) -->
<key>item_count</key>
<dict>
  <key>NSStringLocalizedFormatKey</key>
  <string>%#@item_count@</string>
  <key>item_count</key>
  <dict>
    <key>NSStringPluralRuleType</key>
    <string>other</string>
    <key>other</key>
    <string>%d mục</string>
  </dict>
</dict>

Comment localiser les descriptions d'utilisation Info.plist en vietnamien ?

iOS affiche les chaînes de description d'utilisation telles quelles dans les boîtes de dialogue système. Si elles restent en anglais ou en français, les utilisateurs vietnamiens voient une langue étrangère dans une popup iOS, ce qui peut entraîner un refus lors de l'App Review pour localisation incomplète.

Avec String Catalogs (Xcode 16+), créez ou ouvrez InfoPlist.xcstrings. Xcode collecte automatiquement les clés reconnues : NSCameraUsageDescription, NSMicrophoneUsageDescription, NSLocationWhenInUseUsageDescription, NSPhotoLibraryUsageDescription, et autres. Ajoutez une traduction vietnamienne pour chaque clé utilisée dans votre application.

Exemple : "NSCameraUsageDescription" = "Ứng dụng cần truy cập camera để chụp ảnh hồ sơ của bạn.";

Soyez précis sur la raison pour laquelle l'application a besoin de cette permission. Apple et les utilisateurs vietnamiens attendent une justification claire. Les descriptions vagues peuvent attirer l'attention lors de la revue.

Quelles métadonnées App Store Connect doivent être en vietnamien ?

Apple n'affiche pas automatiquement votre fiche anglaise aux utilisateurs au Vietnam. Ajoutez la localisation Vietnamese (vi) dans App Store Connect sous App Information > Localizations, puis renseignez ces champs :

• Nom de l'application : 30 caractères maximum. Chaque caractère vietnamien accentué compte pour 1 caractère. "Quản lý tài chính" fait 18 caractères, bien en dessous de la limite.
• Sous-titre : 30 caractères maximum. S'affiche sous le nom de l'app dans les résultats de recherche.
• Description : 4 000 caractères maximum. Les trois premières lignes (~255 caractères) apparaissent avant le "Lire la suite". Placez-y votre proposition de valeur principale en vietnamien.
• Mots-clés : 100 caractères au total, séparés par des virgules sans espaces. Les utilisateurs vietnamiens tapent souvent sans accents quand ils cherchent rapidement : envisagez d'inclure les deux formes si votre budget le permet.
• Captures d'écran : chargez des captures montrant l'interface en vietnamien. App Review vérifie que vos captures correspondent à la localisation soumise.

Qu'est-ce qui se casse dans les mises en page iOS vietnamiennes, et comment corriger ?

Les polices système iOS (San Francisco, Helvetica Neue) rendent le vietnamien correctement dès le départ. Les problèmes apparaissent avec les polices personnalisées et les contraintes de labels à largeur fixe.

• Polices personnalisées : vérifiez que la police couvre toutes les variantes de lettres de base vietnamiennes (ă, â, ê, ô, ơ, ư, đ) et l'ensemble des marques tonales combinatoires. Les glyphes manquants se substituent silencieusement à la police système, créant un rendu de polices mixtes au milieu d'un mot.
• Troncature des labels : les chaînes vietnamiennes sont 10-20% plus longues que leurs équivalents anglais. Un UILabel avec numberOfLines = 1 et lineBreakMode = .byTruncatingTail tronquera le texte vietnamien qui tenait en anglais. Lancez le schéma vietnamien dans le simulateur iOS et vérifiez tous les labels principaux à la largeur iPhone SE (375 pt).
• Normalisation NFC : les diacritiques vietnamiens peuvent être encodés en NFC précomposé (un code point) ou en NFD décomposé (caractère de base plus marque combinatoire). Les deux s'affichent identiquement dans iOS, mais NFD échoue lors des comparaisons de chaînes. Utilisez string.precomposedStringWithCanonicalMapping en Swift pour normaliser en NFC.
• Direction du texte : le vietnamien s'écrit de gauche à droite. Aucune gestion RTL n'est nécessaire.

En interne ou avec un spécialiste : la vraie limite pour les équipes iOS

Le travail d'ingénierie, soit ajouter vi dans Xcode, configurer les String Catalogs, localiser Info.plist et paramétrer App Store Connect, est entièrement réalisable en interne en un à deux jours de développement.

La traduction automatique fonctionne bien pour les chaînes utilitaires : libellés de formulaires, messages d'erreur, écrans de paramètres. Ces chaînes sont courtes, leur contexte est structurel, et la qualité de la TA suffit pour un premier lancement.

Un spécialiste vietnamien natif génère de réelles économies pour la fiche App Store, les écrans d'intégration et le vocabulaire métier. Les termes sino-vietnamiens (vocabulaire Hán Việt) sont attendus dans les applications financières et médicales : "giao dịch" pour transaction, "tài khoản" pour compte, "xác thực" pour authentification. Un traducteur natif les emploie correctement dès la première version ; la traduction automatique renvoie souvent des équivalents vietnamiens purs qui sonnent informels pour les utilisateurs professionnels.

Répartition pratique : utilisez la TA pour toutes les chaînes utilitaires, et faites appel à un spécialiste vietnamien natif pour la fiche App Store et les 20-30 écrans de flux principal que les utilisateurs voient à chaque session. Pour une traduction professionnelle français-vietnamien d'applications iOS, le service de localisation de sites web et d'applications en vietnamien sur ce site couvre traduction technique et révision des contenus App Store.

FAQ

Sources officielles

• Apple Developer : Localisation - Fonctionnalités des String Catalogs dans Xcode 27, App Store couvrant 50 langues et 175 régions, workflow complet de localisation. Vérifié en novembre 2026.
• Apple Developer Documentation : Localisation Xcode - Types de fichiers .strings, .stringsdict, .xcstrings, API NSLocalizedString, workflow de localisation Info.plist. Vérifié en novembre 2026.
• Unicode CLDR : Règles de pluriel par langue - Catégories de pluriel CLDR pour le vietnamien : forme unique "other", sans pluriel morphologique. Vérifié en novembre 2026.