💡 Pour localiser une application iOS ou Android en vietnamien : ajoutez la locale
vi(vi.lprojsur iOS,res/values-vi/sur Android), extrayez toutes les chaînes avec des commentaires de contexte et protégez les jetons interpolés avec<xliff:g>, fournissez les deux clés de pluriel CLDR ("one" et "other"), et formatez la monnaie VND avecIntl.NumberFormat('vi-VN', {style:'currency', currency:'VND'}). Les noms vietnamiens ne s'infléchissent pas pour le nombre, donc les deux clés de pluriel sont souvent identiques.
À retenir
- iOS : ajoutez
vidans la liste Localizations de Xcode ; depuis Xcode 15, les String Catalogs (.xcstrings) centralisent toutes les locales dans un seul fichier et affichent le taux de complétion des traductions en temps réel. - Android : créez
res/values-vi/strings.xml; conservez toujours un fichier par défautres/values/strings.xmlcomplet - une clé manquante dans le fichier par défaut provoque un crash sur toute locale non prise en charge. - Pluriels : le CLDR attribue au vietnamien deux catégories cardinales - "one" (n=0 ou n=1) et "other" (n≥2). Les noms ne varient pas, mais les deux clés doivent exister dans
.stringsdictou<plurals>. - Espaces réservés : encadrez chaque jeton non traduisible avec
<xliff:g id="count" example="5">%d</xliff:g>pour indiquer au traducteur ce qu'il ne doit pas modifier. - Mise en page : le texte vietnamien, riche en diacritiques de tons, est typiquement 15-25 % plus large que la source anglaise - concevez des conteneurs flexibles et testez tôt avec de vraies chaînes vietnamiennes.
Comment ajouter le vietnamien à une application iOS ?
Ouvrez votre projet dans Xcode, accédez à l'éditeur de projet et ajoutez Vietnamese (vi) sous Localizations. Pour chaque fichier ressource (Storyboard, XIB, Info.plist, strings), Xcode génère un dossier vi.lproj/.
Depuis Xcode 15, l'approche recommandée est un String Catalog (.xcstrings). Ce fichier JSON unique remplace les fichiers Localizable.strings par locale, affiche toutes les locales côte à côte, et suit automatiquement la complétion des traductions. Utilisez Editor → Export for Localization (XLIFF) pour transmettre le catalogue au traducteur et importez le résultat via Editor → Import Localizations.
Pour les pluriels, utilisez le format .stringsdict ou l'éditeur de variations dans un String Catalog. Fournissez la clé NSStringLocalizedFormatKey et les valeurs pour chaque catégorie CLDR requise.
Comment ajouter le vietnamien à une application Android ?
Créez le répertoire res/values-vi/ et ajoutez un fichier strings.xml. Le qualificateur de langue est vi ; pour une surcharge régionale, utilisez vi-rVN. Android charge automatiquement values-vi/strings.xml quand la locale de l'appareil est le vietnamien.
Conservez toujours un fichier par défaut res/values/strings.xml complet. Si une clé manque dans le fichier par défaut, Android lève une erreur d'exécution sur toute locale ne disposant pas de cette clé.
<!-- res/values/strings.xml (défaut, anglais) -->
<string name="items_count">%d items</string>
<!-- res/values-vi/strings.xml (vietnamien) -->
<string name="items_count">%d mục</string>
Protégez les textes non traduisibles avec le tag XLIFF :
<string name="welcome_user">
Xin chào, <xliff:g id="name" example="Minh">%s</xliff:g>!
</string>
Quelles sont les règles de pluriel vietnamiennes dans CLDR ?
Le vietnamien a deux catégories de pluriel cardinal CLDR : "one" (quand n=0 ou n=1) et "other" (n≥2). Contrairement au français, la catégorie "one" en vietnamien couvre 0 et 1, ce qui reflète l'absence d'inflexion grammaticale des noms vietnamiens.
Les noms vietnamiens ne changent pas de forme entre singulier et pluriel. "2 quyển sách" et "1 quyển sách" utilisent le même nom "sách". En pratique, les deux valeurs de .stringsdict iOS et <plurals> Android pour le vietnamien sont souvent identiques. Les deux clés doivent néanmoins exister.
<plurals name="photo_count">
<item quantity="one">%d ảnh</item>
<item quantity="other">%d ảnh</item>
</plurals>
Monnaie, dates et nombres en vietnamien
Le format numérique pour la locale vi-VN utilise le point comme séparateur de milliers et la virgule comme séparateur décimal (l'inverse de l'anglais). Le symbole VND "₫" se place après le montant, sans décimales.
// JavaScript
new Intl.NumberFormat('vi-VN', { style: 'currency', currency: 'VND' })
.format(1500000)
// → "1.500.000 ₫"
new Intl.DateTimeFormat('vi-VN').format(new Date(2026, 10, 5))
// → "5/11/2026" (jour/mois/année)
Les dates suivent l'ordre JJ/MM/AAAA. N'hardcodez jamais les formats - utilisez Intl.DateTimeFormat (Web/React Native), DateFormat (Android) ou Date.formatted(date:locale:) (iOS) avec la locale vi-VN.
Nord, Centre et Sud du Vietnam : votre application doit-elle gérer les dialectes ?
Le vietnamien écrit standard (basé sur le dialecte du Nord) est compris dans tout le pays, et la plupart des applications utilisent une seule locale vi. Les trois dialectes régionaux (Hanoï, Da Nang, Hô Chi Minh-Ville) diffèrent principalement en prononciation et en argot, sans impact sur le vocabulaire écrit de l'interface.
Pour les textes marketing ou les dialogues de jeu destinés aux utilisateurs du Sud, une relecture par un locuteur natif de Hô Chi Minh-Ville peut détecter une tonalité trop nordique. Cela a plus d'impact sur la voix de marque que sur les chaînes d'interface fonctionnelles.
Ce que l'on peut faire en interne, et quand un spécialiste vietnamien natif est justifié
Votre équipe technique peut gérer l'ensemble de l'échafaudage : ajout de la locale vi, configuration des clés de pluriel, branchement de Intl.NumberFormat('vi-VN',...), protection des espaces réservés. Ce sont des tâches de configuration, pas de langue.
La traduction automatique (DeepL, Google Translate) peut produire un brouillon pour les chaînes peu critiques. Elle n'est pas adaptée pour :
- L'onboarding et les contenus marketing - le ton et le registre comptent.
- Les interfaces fintech ou médicales - une erreur sur un terme sino-vietnamien peut changer radicalement le sens.
- Les fiches de store - l'équipe éditoriale de Google Play signale les descriptions vietnamiennes qui semblent auto-traduites.
Un spécialiste vietnamien natif apporte un registre sino-vietnamien cohérent (le vocabulaire financier et juridique est largement sino-vietnamien), une sensibilité aux dialectes de la ville cible, et la capacité à vérifier que les associations classificateur + nom sonnent naturellement. Pour une application de 2 000 chaînes, une passe professionnelle sur les écrans clés se rentabilise grâce à une meilleure rétention des utilisateurs vietnamiens.
Si votre application vise sérieusement le marché vietnamien, le service de localisation de sites et d'applications inclut une passe de relecture par un spécialiste vietnamien natif pour chaque projet.
FAQ
Le vietnamien utilise-t-il l'écriture de droite à gauche ?
Non. Le vietnamien utilise l'alphabet latin (Quoc ngu) avec une direction d'écriture de gauche à droite. Aucune prise en charge RTL n'est nécessaire pour la locale vietnamienne.
Quel tag BCP-47 utiliser : "vi" ou "vi-VN" ?
Utilisez vi dans la plupart des contextes (attribut lang HTML, locale Xcode, qualificateur de ressource Android). Utilisez vi-VN pour des surcharges régionales spécifiques ou pour distinguer le format VND du Vietnam. Pour l'App Store et le Play Store, vi cible le store vietnamien.
Pourquoi mes chaînes vietnamiennes font-elles planter l'application Android ?
La cause la plus fréquente est une chaîne manquante dans le fichier par défaut res/values/strings.xml. Vérifiez que chaque clé de res/values-vi/strings.xml existe aussi dans res/values/strings.xml.
Faut-il des fiches store vietnamiennes séparées sur l'App Store et le Play Store ?
Oui. Les deux stores permettent et encouragent des fiches de store localisées en vietnamien. Fournissez un nom d'application, un sous-titre (iOS) ou une courte description (Android), et une description complète en vi. Les fiches localisées améliorent la conversion dans les résultats de recherche en vietnamien.
De combien les chaînes vietnamiennes sont-elles plus larges que l'anglais ?
Le texte vietnamien, riche en diacritiques de tons, est typiquement 15-25 % plus large que la source anglaise. Utilisez des vues de texte flexibles plutôt que des étiquettes de taille fixe, et testez avec de vraies chaînes vietnamiennes avant le gel de l'interface.
Sources officielles
- Android Developer : Localiser votre application - structure strings.xml, qualificateurs de locale, espaces réservés xliff:g. Vérifié en novembre 2026.
- Unicode CLDR : Spécification des règles de pluriel - catégories cardinales de pluriel vietnamien "one" (n=0 ou n=1) et "other" (n≥2). Vérifié en novembre 2026.
- Google Play : Traduire et localiser votre application - support de la langue vietnamienne. Vérifié en novembre 2026.
- W3C Internationalisation : Balises de langue - guide BCP-47 pour le vietnamien (vi, vi-VN). Vérifié en novembre 2026.

Écrit par Đào Huy (Lucas), traducteur vietnamien et spécialiste de la localisation (anglais, chinois et français vers le vietnamien). See translation services →
