Descripción general
Las marcas globales, aerolíneas, eventos internacionales y cadenas minoristas suelen emitir pases de monedero digital a clientes en diversas regiones lingüísticas. Passinstance ofrece un motor nativo de localización multilingüe que compila cadenas y activos localizados en:
-
Paquetes
.lprojde Apple Wallet: Diccionarios estándar de cadenas de Apple PassKit (<language>.lproj/pass.strings) empaquetados directamente dentro del archivo.pkpassjunto con las imágenes localizadas. -
Recursos
LocalizedStringde Google Wallet: Estructuras de la API de Google Wallet con cadenas de respaldo y traducciones específicas por idioma (translatedValues[]).
Cuando un cliente instala un pase, iOS y Android inspeccionan automáticamente la configuración de idioma y región del sistema operativo del usuario, mostrando etiquetas de campo, valores, notificaciones de pantalla de bloqueo y gráficos de marca en su idioma nativo, sin necesidad de crear plantillas separadas.
Arquitectura del sistema: compilación multilingüe para PassKit y Google Wallet
Jerarquía de respaldo regional en 4 niveles
Cuando un dispositivo móvil renderiza un pase localizado, Passinstance aplica una jerarquía de resolución de 4 niveles para garantizar que el texto nunca aparezca en blanco ni incompleto:
-
1
Coincidencia regional exacta: Si el dispositivo solicita
de-AT(alemán - Austria) y existe un diccionariode-AT, se carga en primer lugar. -
2
Coincidencia de idioma base: Si
de-ATno existe, el motor recurre ade(alemán). -
3
Idioma principal de la plantilla: Si
deno existe, el motor recurre al idioma base canónico de la plantilla (por defecto:en). -
4
Primera traducción disponible: Si faltan las cadenas base, el compilador renderiza la primera cadena traducida disponible.
Elementos y activos localizables
Puede localizar los siguientes componentes en cualquier plantilla de pase:
| Elemento | Mecanismo en Apple Wallet | Mecanismo en Google Wallet | Ejemplo |
|---|---|---|---|
| Etiquetas de campo | Clave asignada en pass.strings | translatedValues en la etiqueta LocalizedString | "POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ" |
| Valores estáticos de campo | Clave asignada en pass.strings | translatedValues en el valor LocalizedString | "Gold Member" -> "Membre Or" |
| Mensajes push de cambio | Clave asignada en pass.strings con marcador %@ | Carga útil de notificación push de Google Wallet | "Your balance is %@" -> "Ihr Guthaben beträgt %@" |
| Texto del logotipo y organización | Clave logoText en pass.strings | localizedString en la cabecera de la clase | "Artisan Cafe" -> "Café Artisan" |
| Imágenes localizadas | Almacenadas dentro de la carpeta <lang>.lproj/ en .pkpass | URI de imagen del proveedor por clase localizada | Banner promocional localizado con tipografía traducida |
| Campos traseros y condiciones | Claves de texto largo en pass.strings | Módulos localizados textModulesData | Términos y condiciones traducidos por región |
Importante: Al localizar notificaciones push de actualización (
changeMessage), debe conservar el especificador de formato de Apple%@en todas las traducciones (por ejemplo,"Votre solde est désormais de %@"). Si se omite%@en una traducción localizada, iOS suprimirá la notificación en la pantalla de bloqueo cuando ese idioma esté activo.
Configurar la localización en el editor visual
-
1
Abra su plantilla en el editor visual.
-
2
En la barra lateral izquierda de navegación, vaya a Diseño y contenido -> Idiomas y traducciones.
-
3
Haga clic en + Añadir idioma y seleccione los códigos de idioma de destino (por ejemplo, alemán
de, francésfr, españoles). -
4
El editor muestra una cuadrícula de traducción en paralelo con todas las claves de campos, etiquetas, valores y mensajes de cambio.
-
5
Introduzca las cadenas traducidas para cada campo.
-
6
Para cargar imágenes específicas de un idioma (como un banner strip en alemán con texto en alemán), haga clic en Imágenes localizadas en la pestaña del idioma seleccionado y cargue el archivo PNG
@2x/@3xcorrespondiente. -
7
Haga clic en Guardar borrador y previsualice sus cambios en el simulador cambiando el selector de idioma de vista previa.
API programática: configurar cadenas multilingües
Puede gestionar traducciones a través de la API REST de Passinstance actualizando 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é."
}
}
}
}
Referencia del formato de archivo pass.strings de Apple
Cuando Passinstance compila un paquete .pkpass de Apple Wallet, genera automáticamente archivos pass.strings codificados en UTF-16 (o UTF-8 con BOM) dentro de las carpetas <locale>.lproj/:
/* de.lproj/pass.strings */
"MEMBER_LABEL" = "MITGLIED";
"POINTS_LABEL" = "PUNKTESTAND";
"CHANGE_POINTS_MSG" = "Ihr neuer Punktestand ist %@";
"TERMS_TITLE" = "ALLGEMEINE GESCHÄFTSBEDINGUNGEN";
Probar pases localizados en dispositivos móviles
Para verificar que sus reglas de localización se renderizan correctamente:
-
1
Pruebas en iOS:
- Vaya a Ajustes -> General -> Idioma y región en su iPhone. - Añada su idioma de prueba (por ejemplo, alemán) y establézcalo como idioma principal del sistema. - Abra Apple Wallet: todas las etiquetas de campo y notificaciones push del pase se actualizarán al alemán.
-
2
Pruebas en Android:
- Vaya a Ajustes -> Sistema -> Idiomas e introducción de texto en su dispositivo Android. - Mueva alemán o francés al primer lugar de su lista de idiomas preferidos. - Abra Google Wallet para comprobar los valores traducidos en textModulesData y la cabecera.
-
3
Pruebas en la página de descarga:
- Las páginas de descarga de PassFlow (/p/:token) detectan automáticamente la cabecera Accept-Language del navegador y ofrecen un selector de idioma en el pie de página.
Explore Diseño y configuración de plantillas para ajustar la estructura visual de las tarjetas, o Versiones y publicación de plantillas para llevar a producción su plantilla localizada.
