Skip to content
Guía del Centro de ayuda · Plantillas de pases
5 min de lecturaVerificado 2026-11-16

Idiomas del pase y localización

Entregue pases multilingües de Apple y Google Wallet mediante diccionarios .lproj/pass.strings, imágenes localizadas y árboles de contingencia.

En esta guía

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 .lproj de Apple Wallet: Diccionarios estándar de cadenas de Apple PassKit (<language>.lproj/pass.strings) empaquetados directamente dentro del archivo .pkpass junto con las imágenes localizadas.
  • Recursos LocalizedString de 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

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
LOCALIZACIÓN DE PASES Y COMPILACIÓN DE CADENAS
ETAPA 01 REPOSITORIO DE LOCALIZACIÓN DE PLANTILLAS (templateLocalization.ts)
Idioma base (p. ej., en): etiquetas, valores y mensajes de cambio canónicos
Diccionarios de traducción: de, es, fr, it, nl, pt, ja, etc.
Imágenes localizadas: localizedImages[locale] (p. ej., banner strip alemán)
ETAPA 02 COMPILADOR DE LOCALIZACIÓN (template-localization.util.ts)
1
Escapa literales UTF-16 / UTF-8 de Apple ("Key" = "Translated Value";)
2
Conserva especificadores de formato (%@) en changeMessage en cada idioma
3
Construye jerarquía de respaldo: ExactoIdioma basePlantilla principal
ETAPA 03A APPLE WALLET (Paquete .pkpass)
de.lproj/pass.strings de.lproj/logo.png, strip.png fr.lproj/pass.strings fr.lproj/logo.png iOS renderiza según el idioma local
ETAPA 03B GOOGLE WALLET (Class/Object)
"label": { "defaultValue": { "language": "en", "value": "POINTS" }, "translatedValues": [ { "language": "de", "value": "PUNKTE" } ]
}

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. 1
    Coincidencia regional exacta: Si el dispositivo solicita de-AT (alemán - Austria) y existe un diccionario de-AT, se carga en primer lugar.
  2. 2
    Coincidencia de idioma base: Si de-AT no existe, el motor recurre a de (alemán).
  3. 3
    Idioma principal de la plantilla: Si de no existe, el motor recurre al idioma base canónico de la plantilla (por defecto: en).
  4. 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:

ElementoMecanismo en Apple WalletMecanismo en Google WalletEjemplo
Etiquetas de campoClave asignada en pass.stringstranslatedValues en la etiqueta LocalizedString"POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ"
Valores estáticos de campoClave asignada en pass.stringstranslatedValues en el valor LocalizedString"Gold Member" -> "Membre Or"
Mensajes push de cambioClave 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ónClave logoText en pass.stringslocalizedString en la cabecera de la clase"Artisan Cafe" -> "Café Artisan"
Imágenes localizadasAlmacenadas dentro de la carpeta <lang>.lproj/ en .pkpassURI de imagen del proveedor por clase localizadaBanner promocional localizado con tipografía traducida
Campos traseros y condicionesClaves de texto largo en pass.stringsMódulos localizados textModulesDataTé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. 1
    Abra su plantilla en el editor visual.
  2. 2
    En la barra lateral izquierda de navegación, vaya a Diseño y contenido -> Idiomas y traducciones.
  3. 3
    Haga clic en + Añadir idioma y seleccione los códigos de idioma de destino (por ejemplo, alemán de, francés fr, español es).
  4. 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. 5
    Introduzca las cadenas traducidas para cada campo.
  6. 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 / @3x correspondiente.
  7. 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):

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é."
      }
    }
  }
}

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/:

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

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

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

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.