Skip to content
Guide du centre d'aide · Modèles de passes
5 min de lectureVérifié 2026-11-16

Langues des cartes et localisation

Distribuez des cartes Apple et Google Wallet multilingues avec les dictionnaires .lproj/pass.strings, des images localisées et des arborescences de secours.

Dans ce guide

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 .lproj Apple Wallet : dictionnaires de chaînes Apple PassKit standard (<language>.lproj/pass.strings) empaquetés directement dans l'archive .pkpass avec les images localisées.
  • Ressources LocalizedString Google 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

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : LOCALISATION DE PASSES & COMPILATION DE CHAÎNES
ÉTAPE 01 RÉPERTOIRE DE LOCALISATION DU MODÈLE (templateLocalization.ts)
Langue de base (ex. en) : libellés, valeurs et messages push canoniques
Dictionnaires de traduction : de, es, fr, it, nl, pt, ja, etc.
Surcharges d'actifs localisés : localizedImages[locale] (ex. bandeau DE)
ÉTAPE 02 COMPILATEUR DE LOCALISATION (template-localization.util.ts)
1
Échappe les littéraux Apple UTF-16 / UTF-8 ("Key" = "Translated Value";)
2
Préserve les spécificateurs (%@) dans changeMessage pour chaque langue
3
Construit la hiérarchie de repli : ExacteLangue de baseModèle maître
ÉTAPE 03A APPLE WALLET (Bundle .pkpass)
de.lproj/pass.strings de.lproj/logo.png, strip.png fr.lproj/pass.strings fr.lproj/logo.png iOS affiche selon la locale système
ÉTAPE 03B GOOGLE WALLET (Class/Object)
"label": { "defaultValue": { "language": "en", "value": "POINTS" }, "translatedValues": [ { "language": "de", "value": "PUNKTE" } ]
}

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. 1
    Correspondance exacte de locale : si l'appareil demande de-AT (allemand - Autriche) et qu'un dictionnaire de-AT existe, il est chargé en priorité.
  2. 2
    Correspondance sur la langue de base : si de-AT est absent, le moteur se replie sur de (allemand).
  3. 3
    Langue principale du modèle : si de est absent, le moteur se replie sur la langue canonique de base du modèle (par défaut : en).
  4. 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émentMécanisme Apple WalletMécanisme Google WalletExemple
Libellés de champsClé mappée dans pass.stringstranslatedValues sur le libellé LocalizedString"POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ"
Valeurs de champs statiquesClé mappée dans pass.stringstranslatedValues sur la valeur LocalizedString"Gold Member" -> "Membre Or"
Messages push de modificationClé 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'organisationClé logoText dans pass.stringslocalizedString sur l'en-tête de classe"Artisan Cafe" -> "Café Artisan"
Images localiséesStockées dans le dossier <lang>.lproj/ du .pkpassURI d'image fournisseur par classe localiséeBandeau promotionnel localisé avec texte traduit
Champs au verso & conditionsClés de texte long dans pass.stringsModules localisés textModulesDataConditions 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. 1
    Ouvrez votre modèle dans l'éditeur visuel.
  2. 2
    Dans la barre latérale gauche, accédez à Design & contenu -> Langues & traductions (Design & content -> Languages & translations).
  3. 3
    Cliquez sur + Ajouter une langue (+ Add Language) et sélectionnez les codes de langues cibles (par ex. allemand de, français fr, espagnol es).
  4. 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. 5
    Saisissez les chaînes traduites pour chaque champ.
  6. 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 / @3x correspondants.
  7. 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) :

JSON
{
  "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/ :

TEXT
/* 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. 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.

  1. 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.

  1. 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.

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.