Aperçu
Les marques internationales, compagnies aériennes, événements internationaux et enseignes de retail émettent fréquemment des passes Wallet auprès de clients répartis dans plusieurs zones linguistiques. Passinstance intègre un moteur de localisation multilingue natif qui compile les chaînes et actifs traduits vers :
-
Bundles
.lprojApple Wallet : dictionnaires de chaînes Apple PassKit standard (<language>.lproj/pass.strings) empaquetés directement dans l'archive.pkpassavec les images localisées. -
Ressources
LocalizedStringGoogle Wallet : structures d'API Google Wallet combinant chaînes de repli et traductions par langue (translatedValues[]).
Lorsqu'un client installe un passe, iOS et Android détectent automatiquement la langue et les réglages régionaux du système d'exploitation pour afficher les libellés de champs, valeurs, notifications d'écran verrouillé et visuels de marque dans sa langue maternelle — sans avoir besoin de créer plusieurs modèles distincts.
Architecture système : compilation multilingue PassKit & Google
La hiérarchie de repli linguistique à 4 niveaux
Lorsqu'un appareil mobile affiche un passe localisé, Passinstance applique une hiérarchie de résolution à 4 niveaux afin de garantir qu'aucun texte n'apparaisse vide ou cassé :
-
1
Correspondance exacte de locale : si l'appareil demande
de-AT(allemand - Autriche) et qu'un dictionnairede-ATexiste, il est chargé en priorité. -
2
Correspondance sur la langue de base : si
de-ATest absent, le moteur se replie surde(allemand). -
3
Langue principale du modèle : si
deest absent, le moteur se replie sur la langue canonique de base du modèle (par défaut :en). -
4
Première traduction disponible : si les chaînes de base manquent, le compilateur affiche la première chaîne traduite disponible.
Éléments & actifs localisables
Vous pouvez localiser les composants suivants sur n'importe quel modèle de passe :
| Élément | Mécanisme Apple Wallet | Mécanisme Google Wallet | Exemple |
|---|---|---|---|
| Libellés de champs | Clé mappée dans pass.strings | translatedValues sur le libellé LocalizedString | "POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ" |
| Valeurs de champs statiques | Clé mappée dans pass.strings | translatedValues sur la valeur LocalizedString | "Gold Member" -> "Membre Or" |
| Messages push de modification | Clé mappée dans pass.strings avec variable %@ | Charge utile de notification push Google Wallet | "Your balance is %@" -> "Ihr Guthaben beträgt %@" |
| Texte du logo & nom d'organisation | Clé logoText dans pass.strings | localizedString sur l'en-tête de classe | "Artisan Cafe" -> "Café Artisan" |
| Images localisées | Stockées dans le dossier <lang>.lproj/ du .pkpass | URI d'image fournisseur par classe localisée | Bandeau promotionnel localisé avec texte traduit |
| Champs au verso & conditions | Clés de texte long dans pass.strings | Modules localisés textModulesData | Conditions générales traduites par région |
Important : lors de la localisation des notifications push de mise à jour (
changeMessage), vous devez conserver le spécificateur de format Apple%@dans chaque traduction (par exemple,"Votre solde est désormais de %@"). Si%@est omis dans une traduction, iOS supprime la notification sur l'écran verrouillé lorsque cette langue est active.
Configurer la localisation dans l'éditeur visuel
-
1
Ouvrez votre modèle dans l'éditeur visuel.
-
2
Dans la barre latérale gauche, accédez à Design & contenu -> Langues & traductions (Design & content -> Languages & translations).
-
3
Cliquez sur + Ajouter une langue (+ Add Language) et sélectionnez les codes de langues cibles (par ex. allemand
de, françaisfr, espagnoles). -
4
L'éditeur affiche une grille de traduction côte à côte répertoriant toutes les clés de champs, libellés, valeurs et messages de modification.
-
5
Saisissez les chaînes traduites pour chaque champ.
-
6
Pour téléverser des visuels propres à une langue (comme un bandeau promotionnel en allemand), cliquez sur Images localisées (Localized Images) dans l'onglet de la langue sélectionnée et importez les fichiers PNG
@2x/@3xcorrespondants. -
7
Cliquez sur Enregistrer le brouillon (Save Draft) et vérifiez le rendu dans le simulateur en changeant le sélecteur de langue d'aperçu.
API programmatique : configurer des chaînes multilingues
Vous pouvez gérer les traductions via l'API REST Passinstance en mettant à jour template.localization (PATCH /api/v1/templates/:id) :
{
"localization": {
"defaultLanguage": "en",
"languages": ["de", "fr", "es"],
"translations": {
"de": {
"MEMBER_LABEL": "MITGLIED",
"POINTS_LABEL": "PUNKTESTAND",
"TIER_GOLD": "Goldstatus",
"CHANGE_POINTS_MSG": "Ihr neuer Punktestand ist %@",
"TERMS_TITLE": "ALLGEMEINE GESCHÄFTSBEDINGUNGEN",
"TERMS_BODY": "Punkte verfallen nach 12 Monaten Inaktivität."
},
"fr": {
"MEMBER_LABEL": "MEMBRE",
"POINTS_LABEL": "POINTS DE FIDÉLITÉ",
"TIER_GOLD": "Statut Or",
"CHANGE_POINTS_MSG": "Votre nouveau solde est de %@",
"TERMS_TITLE": "CONDITIONS GÉNÉRALES",
"TERMS_BODY": "Les points expirent après 12 mois d'inactivité."
}
}
}
}
Référence du format de fichier Apple pass.strings
Lorsque Passinstance compile un bundle Apple Wallet .pkpass, il génère automatiquement des fichiers pass.strings encodés en UTF-16 (ou UTF-8 avec BOM) dans les dossiers <locale>.lproj/ :
/* de.lproj/pass.strings */
"MEMBER_LABEL" = "MITGLIED";
"POINTS_LABEL" = "PUNKTESTAND";
"CHANGE_POINTS_MSG" = "Ihr neuer Punktestand ist %@";
"TERMS_TITLE" = "ALLGEMEINE GESCHÄFTSBEDINGUNGEN";
Tester des passes localisés sur appareils mobiles
Pour vérifier que vos règles de localisation s'affichent correctement :
-
1
Test sur iOS :
- Ouvrez Réglages -> Général -> Langue et région sur votre iPhone. - Ajoutez votre langue de test (par ex. allemand) et définissez-la comme langue principale du système. - Ouvrez Apple Wallet : tous les libellés de champs et notifications push du passe basculent en allemand.
-
2
Test sur Android :
- Ouvrez Paramètres -> Système -> Langues et saisie sur votre appareil Android. - Placez l'allemand ou le français en tête de votre liste de langues préférées. - Ouvrez Google Wallet pour constater la traduction des champs textModulesData et des valeurs d'en-tête.
-
3
Test de la page de téléchargement :
- Les pages de téléchargement PassFlow (/p/:token) détectent automatiquement l'en-tête Accept-Language du navigateur et proposent un sélecteur de langue en pied de page.
Explorez Design & configuration des modèles pour ajuster la structure visuelle des cartes ou Versions de modèles & publication pour publier votre modèle localisé en production.
