Skip to content
Hilfecenter-Anleitung · Pass-Vorlagen
4 Min. LesezeitGeprüft 2026-11-16

Pass-Sprachen & Lokalisierung

Bereitstellung mehrsprachiger Apple- und Google-Wallet-Pässe mit .lproj/pass.strings-Wörterbüchern, lokalisierten Bildern und Fallback-Hierarchien.

In dieser Anleitung

Überblick

Globale Marken, Fluggesellschaften, internationale Veranstaltungen und Handelsketten geben Wallet-Pässe häufig an Kundinnen und Kunden in unterschiedlichen Sprachregionen aus. Passinstance bietet eine native Mehrsprachigkeits-Engine, die lokalisierte Texte und Assets automatisch kompiliert in:

  • Apple-Wallet-.lproj-Bundles: Standardmäßige Apple-PassKit-Textwörterbücher (<language>.lproj/pass.strings), die zusammen mit lokalisierten Bildern direkt in das .pkpass-Archiv gepackt werden.
  • Google-Wallet-LocalizedString-Ressourcen: Google-Wallet-API-Strukturen mit Fallback-Texten und sprachspezifischen Übersetzungen (translatedValues[]).

Installiert eine Kundin oder ein Kunde einen Pass, werten iOS und Android automatisch die Sprach- und Regionseinstellungen des Betriebssystems aus und zeigen Feldbezeichnungen, Werte, Sperrbildschirm-Mitteilungen und Markengrafiken in der jeweiligen Landessprache an — ganz ohne separate Vorlagen.

Systemarchitektur: Mehrsprachige PassKit- & Google-Kompilierung

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
PASS-LOKALISIERUNG & STRING-KOMPILIERUNG
STUFE 01 VORLAGEN-LOKALISIERUNGS-REPOSITORY (templateLocalization.ts)
Basissprache (z. B. en): Kanonische Feldlabels, Werte & Änderungsmeldungen
Übersetzungswörterbücher: de, es, fr, it, nl, pt, ja usw.
Lokalisierte Asset-Varianten: localizedImages[locale] (z. B. dt. Banner)
STUFE 02 LOKALISIERUNGS-COMPILER (template-localization.util.ts)
1
Maskiert Apple UTF-16-/UTF-8-Zeichenketten ("Key" = "Translated Value";)
2
Erhält Format-Platzhalter (%@) in changeMessage über alle Sprachen hinweg
3
Erzeugt Fallback-Hierarchie: ExaktBasissprachePrimäre Vorlagensprache
STUFE 03A APPLE WALLET (.pkpass-Bundle)
de.lproj/pass.strings de.lproj/logo.png, strip.png fr.lproj/pass.strings fr.lproj/logo.png iOS rendert passend zur Gerätesprache
STUFE 03B GOOGLE WALLET (Class/Object)
"label": { "defaultValue": { "language": "en", "value": "POINTS" }, "translatedValues": [ { "language": "de", "value": "PUNKTE" } ]
}

Die 4-stufige Sprach-Fallback-Hierarchie

Beim Rendern eines lokalisierten Passes auf einem Mobilgerät wendet Passinstance eine 4-stufige Auflösungs-Hierarchie an, damit Texte niemals leer oder fehlerhaft erscheinen:

  1. 1
    Exakte Locale-Übereinstimmung: Fordert das Gerät de-AT (Deutsch — Österreich) an und existiert ein de-AT-Wörterbuch, wird dieses zuerst geladen.
  2. 2
    Übereinstimmung mit der Basissprache: Ist de-AT nicht vorhanden, greift die Engine auf de (Deutsch) zurück.
  3. 3
    Primäre Vorlagensprache: Ist de nicht vorhanden, fällt die Engine auf die kanonische Basissprache der Vorlage zurück (Standard: en).
  4. 4
    Erste verfügbare Übersetzung: Fehlen Basistexte, rendert der Compiler die erste verfügbare übersetzte Zeichenkette.

Lokalisierbare Elemente & Assets

Sie können folgende Bestandteile jeder Pass-Vorlage lokalisieren:

ElementApple-Wallet-MechanismusGoogle-Wallet-MechanismusBeispiel
Feldbezeichnungen (Labels)Schlüssel in pass.strings zugeordnettranslatedValues im Label-LocalizedString"POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ"
Statische FeldwerteSchlüssel in pass.strings zugeordnettranslatedValues im Wert-LocalizedString"Gold Member" -> "Membre Or"
Push-ÄnderungsmeldungenSchlüssel in pass.strings mit Platzhalter %@Google-Wallet-Push-Benachrichtigungs-Payload"Your balance is %@" -> "Ihr Guthaben beträgt %@"
Logo-Text & OrganisationsnameSchlüssel logoText in pass.stringslocalizedString im Class-Header"Artisan Cafe" -> "Café Artisan"
Lokalisierte BilderGespeichert im Ordner <lang>.lproj/ im .pkpassAnbieter-Bild-URI je lokalisierter ClassLokalisierter Aktions-Strip mit übersetzter Typografie
Rückseitenfelder & BedingungenLangtext-Schlüssel in pass.stringsLokalisierte textModulesData-ModuleRegional übersetzte Geschäftsbedingungen

Wichtig: Wenn Sie Push-Änderungsmeldungen (changeMessage) lokalisieren, müssen Sie in jeder Übersetzung den Apple-Formatplatzhalter %@ beibehalten (zum Beispiel "Votre solde est désormais de %@"). Fehlt %@ in einer lokalisierten Übersetzung, unterdrückt iOS die Sperrbildschirm-Mitteilung, sobald diese Sprache aktiv ist.

Lokalisierung im Visuellen Editor konfigurieren

  1. 1
    Öffnen Sie Ihre Vorlage im Visuellen Editor.
  2. 2
    Navigieren Sie in der linken Seitenleiste zu Design & Inhalt -> Sprachen & Übersetzungen.
  3. 3
    Klicken Sie auf + Sprache hinzufügen und wählen Sie die gewünschten Sprachcodes aus (z. B. Deutsch de, Französisch fr, Spanisch es).
  4. 4
    Der Editor zeigt eine übersichtliche Übersetzungstabelle mit allen Feldschlüsseln, Bezeichnungen, Werten und Änderungsmeldungen.
  5. 5
    Tragen Sie die übersetzten Texte für jedes Feld ein.
  6. 6
    Um sprachspezifische Grafiken hochzuladen (z. B. ein deutsches Strip-Banner mit deutschem Text), klicken Sie im gewählten Sprachtab auf Lokalisierte Bilder und laden Sie das entsprechende @2x- / @3x-PNG hoch.
  7. 7
    Klicken Sie auf Entwurf speichern und prüfen Sie Ihre Änderungen im Simulator, indem Sie den Sprachumschalter der Vorschau wechseln.

Programmgesteuerte API: Mehrsprachige Texte konfigurieren

Sie können Übersetzungen über die Passinstance-REST-API verwalten, indem Sie template.localization aktualisieren (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é."
      }
    }
  }
}

Referenz für das Apple-pass.strings-Dateiformat

Beim Kompilieren eines Apple-Wallet-.pkpass-Bundles erzeugt Passinstance automatisch UTF-16- (oder UTF-8 mit BOM) kodierte pass.strings-Dateien innerhalb der <locale>.lproj/-Ordner:

TEXT
/* de.lproj/pass.strings */
"MEMBER_LABEL" = "MITGLIED";
"POINTS_LABEL" = "PUNKTESTAND";
"CHANGE_POINTS_MSG" = "Ihr neuer Punktestand ist %@";
"TERMS_TITLE" = "ALLGEMEINE GESCHÄFTSBEDINGUNGEN";

Lokalisierte Pässe auf Mobilgeräten testen

So überprüfen Sie, dass Ihre Lokalisierungsregeln korrekt dargestellt werden:

  1. 1
    Testen unter iOS:

- Öffnen Sie auf Ihrem iPhone Einstellungen -> Allgemein -> Sprache & Region. - Fügen Sie Ihre Testsprache (z. B. Deutsch) hinzu und legen Sie sie als primäre Systemsprache fest. - Öffnen Sie Apple Wallet: Alle Feldbezeichnungen und Push-Mitteilungen des Passes erscheinen nun auf Deutsch.

  1. 2
    Testen unter Android:

- Öffnen Sie auf Ihrem Android-Gerät Einstellungen -> System -> Sprachen & Eingabe. - Verschieben Sie Deutsch oder Französisch an die oberste Stelle Ihrer Sprachpräferenzliste. - Öffnen Sie Google Wallet, um die übersetzten textModulesData-Einträge und Header-Werte zu prüfen.

  1. 3
    Downloadseite testen:

- PassFlow-Downloadseiten (/p/:token) erkennen automatisch den Accept-Language-Header des Browsers und stellen zudem einen Sprachumschalter in der Fußzeile bereit.

Erfahren Sie unter Vorlagendesign & Konfiguration, wie Sie visuelle Kartenstrukturen anpassen, oder lesen Sie Vorlagenversionen & Veröffentlichung, um Ihre lokalisierte Vorlage produktiv zu schalten.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.