Ü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
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
Exakte Locale-Übereinstimmung: Fordert das Gerät
de-AT(Deutsch — Österreich) an und existiert einde-AT-Wörterbuch, wird dieses zuerst geladen. -
2
Übereinstimmung mit der Basissprache: Ist
de-ATnicht vorhanden, greift die Engine aufde(Deutsch) zurück. -
3
Primäre Vorlagensprache: Ist
denicht vorhanden, fällt die Engine auf die kanonische Basissprache der Vorlage zurück (Standard:en). -
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:
| Element | Apple-Wallet-Mechanismus | Google-Wallet-Mechanismus | Beispiel |
|---|---|---|---|
| Feldbezeichnungen (Labels) | Schlüssel in pass.strings zugeordnet | translatedValues im Label-LocalizedString | "POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ" |
| Statische Feldwerte | Schlüssel in pass.strings zugeordnet | translatedValues im Wert-LocalizedString | "Gold Member" -> "Membre Or" |
| Push-Änderungsmeldungen | Schlüssel in pass.strings mit Platzhalter %@ | Google-Wallet-Push-Benachrichtigungs-Payload | "Your balance is %@" -> "Ihr Guthaben beträgt %@" |
| Logo-Text & Organisationsname | Schlüssel logoText in pass.strings | localizedString im Class-Header | "Artisan Cafe" -> "Café Artisan" |
| Lokalisierte Bilder | Gespeichert im Ordner <lang>.lproj/ im .pkpass | Anbieter-Bild-URI je lokalisierter Class | Lokalisierter Aktions-Strip mit übersetzter Typografie |
| Rückseitenfelder & Bedingungen | Langtext-Schlüssel in pass.strings | Lokalisierte textModulesData-Module | Regional ü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
Öffnen Sie Ihre Vorlage im Visuellen Editor.
-
2
Navigieren Sie in der linken Seitenleiste zu Design & Inhalt -> Sprachen & Übersetzungen.
-
3
Klicken Sie auf + Sprache hinzufügen und wählen Sie die gewünschten Sprachcodes aus (z. B. Deutsch
de, Französischfr, Spanisches). -
4
Der Editor zeigt eine übersichtliche Übersetzungstabelle mit allen Feldschlüsseln, Bezeichnungen, Werten und Änderungsmeldungen.
-
5
Tragen Sie die übersetzten Texte für jedes Feld ein.
-
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
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):
{
"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:
/* 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
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.
-
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.
-
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.
