Skip to content
Helpcentrum-gids · Pass-sjablonen
4 min leestijdGecontroleerd 2026-11-16

Pass-talen en lokalisatie

Lever meertalige Apple- en Google Wallet-passen met .lproj/pass.strings-woordenboeken, gelokaliseerde afbeeldingen en terugvalstructuren.

In deze gids

Overzicht

Internationale merken, luchtvaartmaatschappijen, grote evenementen en winkelketens geven vaak wallet-passen uit aan klanten in uiteenlopende taalregio's. Passinstance biedt een native meertalige lokalisatie-engine die gelokaliseerde teksten en assets compileert naar:

  • Apple Wallet .lproj-bundels: Standaard Apple PassKit-tekstwoordenboeken (<language>.lproj/pass.strings) die samen met gelokaliseerde afbeeldingen rechtstreeks in het .pkpass-archief worden verpakt.
  • Google Wallet LocalizedString-bronnen: Google Wallet API-structuren met terugvalteksten en taalspecifieke vertalingen (translatedValues[]).

Wanneer een klant een pas installeert, controleren iOS en Android automatisch de taal- en regio-instellingen van het besturingssysteem en worden veldlabels, waarden, meldingen op het toegangsscherm en merkafbeeldingen in de eigen taal weergegeven — zonder dat daar afzonderlijke sjablonen voor nodig zijn.

Systeemarchitectuur: meertalige PassKit- & Google-compilatie

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
PASLOKALISATIE & TEKSTCOMPILATIE
FASE 01 SJABLOONLOKALISATIE-REPOSITORY (templateLocalization.ts)
Basistaal (bijv. en): Canonieke veldlabels, waarden en wijzigingsberichten
Vertaalwoordenboeken: de, es, fr, it, nl, pt, ja, enz.
Gelokaliseerde assets: localizedImages[locale] (bijv. Duitse stripbanner)
FASE 02 LOKALISATIECOMPILER (template-localization.util.ts)
1
Escapet Apple UTF-16 / UTF-8 stringliterals ("Key" = "Translated Value";)
2
Behoudt opmaakplaatshouders (%@) in changeMessage in alle talen
3
Bouwt terugvalhiërarchie: ExactBasistaalHoofdsjabloon
FASE 03A APPLE WALLET (.pkpass-bundel)
de.lproj/pass.strings de.lproj/logo.png, strip.png fr.lproj/pass.strings fr.lproj/logo.png iOS rendert op basis van toesteltaal
FASE 03B GOOGLE WALLET (Class/Object)
"label": { "defaultValue": { "language": "en", "value": "POINTS" }, "translatedValues": [ { "language": "de", "value": "PUNKTE" } ]
}

De 4-laags terugvalhiërarchie voor locales

Wanneer een mobiel apparaat een gelokaliseerde pas weergeeft, past Passinstance een oplossingshiërarchie in vier lagen toe om te garanderen dat tekst nooit leeg of verminkt verschijnt:

  1. 1
    Exacte locale-overeenkomst: Als het apparaat de-AT (Duits - Oostenrijk) opvraagt en er bestaat een de-AT-woordenboek, wordt dit als eerste geladen.
  2. 2
    Overeenkomst op basistaal: Als de-AT ontbreekt, valt de engine terug op de (Duits).
  3. 3
    Primaire sjabloontaal: Als de ontbreekt, valt de engine terug op de canonieke basistaal van het sjabloon (standaard: en).
  4. 4
    Eerste beschikbare vertaling: Als basisteksten ontbreken, rendert de compiler de eerst beschikbare vertaalde tekenreeks.

Gelokaliseerde elementen & assets

U kunt de volgende onderdelen van elk passjabloon lokaliseren:

ElementApple Wallet-mechanismeGoogle Wallet-mechanismeVoorbeeld
VeldlabelsSleutel gekoppeld in pass.stringstranslatedValues op label-LocalizedString"POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ"
Statische veldwaardenSleutel gekoppeld in pass.stringstranslatedValues op waarde-LocalizedString"Gold Member" -> "Membre Or"
Push-wijzigingsberichtenSleutel in pass.strings met %@-placeholderGoogle Wallet-pushnotificatiepayload"Your balance is %@" -> "Ihr Guthaben beträgt %@"
Logotekst & organisatienaamSleutel logoText in pass.stringslocalizedString op de Class-koptekst"Artisan Cafe" -> "Café Artisan"
Gelokaliseerde afbeeldingenOpgeslagen in <lang>.lproj/-map in .pkpassProvider-afbeeldings-URI per gelokaliseerde ClassGelokaliseerde promostrip met vertaalde typografie
Achterzijdevelden & voorwaardenLange tekstsleutels in pass.stringsGelokaliseerde modules in textModulesDataAlgemene voorwaarden vertaald per regio

Belangrijk: Bij het lokaliseren van push-wijzigingsberichten (changeMessage) moet u de Apple-opmaakplaatshouder %@ in elke vertaling behouden (bijvoorbeeld "Votre solde est désormais de %@"). Als %@ ontbreekt in een gelokaliseerde vertaling, onderdrukt iOS de melding op het toegangsscherm wanneer die taal actief is.

Lokalisatie configureren in de Visuele editor

  1. 1
    Open uw sjabloon in de Visuele editor.
  2. 2
    Ga in de linker navigatiebalk naar Ontwerp & inhoud -> Talen & vertalingen.
  3. 3
    Klik op + Taal toevoegen en selecteer de gewenste taalcodes (bijv. Duits de, Frans fr, Spaans es).
  4. 4
    De editor toont een overzichtelijk vertaalraster naast elkaar met alle veldsleutels, labels, waarden en wijzigingsberichten.
  5. 5
    Vul voor elk veld de vertaalde teksten in.
  6. 6
    Om taalspecifieke afbeeldingen te uploaden (zoals een Duitse stripbanner met Duitse tekst), klikt u op Gelokaliseerde afbeeldingen op het geselecteerde taaltabblad en uploadt u de bijbehorende @2x- / @3x-PNG.
  7. 7
    Klik op Concept opslaan en bekijk uw wijzigingen in de simulator door de voorvertoningstaal om te schakelen.

Programmatische API: meertalige teksten configureren

U kunt vertalingen beheren via de Passinstance REST API door template.localization bij te werken (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é."
      }
    }
  }
}

Referentie voor het Apple pass.strings-bestandsformaat

Wanneer Passinstance een Apple Wallet .pkpass-bundel compileert, genereert het automatisch UTF-16- (of UTF-8 met BOM) gecodeerde pass.strings-bestanden in mappen <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";

Gelokaliseerde passen testen op mobiele apparaten

Zo controleert u of uw lokalisatieregels correct worden weergegeven:

  1. 1
    Testen op iOS:

- Ga op uw iPhone naar Instellingen -> Algemeen -> Taal en regio. - Voeg uw testtaal toe (bijv. Duits) en stel deze in als primaire systeemtaal. - Open Apple Wallet: alle veldlabels en pushmeldingen van de pas schakelen over naar het Duits.

  1. 2
    Testen op Android:

- Ga op uw Android-toestel naar Instellingen -> Systeem -> Talen en invoer. - Sleep Duits of Frans naar boven in uw lijst met taalvoorkeuren. - Open Google Wallet om de vertaalde textModulesData en koptekstwaarden te bekijken.

  1. 3
    Testen van de downloadpagina:

- PassFlow-downloadpagina's (/p/:token) detecteren automatisch de Accept-Language-header van de browser en bieden onderaan een taalkiezer.

Bekijk Sjabloonontwerp & configuratie om visuele kaartstructuren aan te passen, of Sjabloonversies & publiceren om uw gelokaliseerde sjabloon naar productie te promoveren.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.