Convertir PNG a PKPASS

Un PNG debe formar parte de un pase de Apple Wallet cuando es necesario instalar en Wallet un ticket, una tarjeta de embarque, una tarjeta de fidelización o un cupón, en lugar de compartirlo como imagen. El PNG proporciona los elementos gráficos; el paquete PKPASS resultante proporciona campos estructurados, datos de código de barras y una firma criptográfica.

Qué es el formato PNG

PNG es un formato de imagen rasterizada sin pérdida que admite transparencia, color indexado, escala de grises e imágenes RGB o RGBA a todo color. Los diseñadores web, desarrolladores de software, fotógrafos, editores gráficos y usuarios que crean capturas de pantalla, logotipos, códigos QR y material gráfico escaneado lo utilizan habitualmente. Aplicaciones como Adobe Photoshop, Affinity Photo, GIMP y Preview pueden crear o exportar archivos PNG.

Un PNG contiene píxeles, no instrucciones para Wallet. Normalmente no contiene los campos del pase, la carga útil del código de barras, la URL de actualización, el diseño de Apple Wallet ni los datos de firma requeridos por PKPASS. Un generador de pases puede utilizarlo como icono, logotipo, franja, miniatura, fondo u otro recurso de imagen compatible.

Qué es el formato PKPASS

PKPASS es el formato de paquete de pases de Apple Wallet. Un archivo con la extensión .pkpass es un archivo ZIP que contiene archivos como pass.json, recursos de imagen, manifest.json y una signature criptográfica.

El archivo pass.json identifica el tipo de pase, el emisor, el equipo, el número de serie, los colores, los campos, el código de barras, las fechas y otros comportamientos de Wallet. manifest.json enumera los archivos del paquete y sus hashes SHA-1; signature firma ese manifiesto con un certificado de Apple Pass Type ID. Wallet comprueba la firma antes de aceptar el pase. Esta estructura permite admitir tarjetas de embarque, tickets de eventos, cupones, tarjetas de tiendas y tarjetas de membresía con datos legibles por máquinas y actualizables.

Cómo crear un PKPASS a partir de un PNG

No existe una conversión válida con un solo clic de un PNG independiente. Crea un pase de Wallet e incluye el PNG en él.

1. Prepara los elementos gráficos en un editor de imágenes. Exporta un PNG RGB o RGBA, elimina los metadatos innecesarios y sigue las dimensiones requeridas por el generador de pases y sus reglas de nomenclatura de recursos @2x o @3x. Mantén el texto importante y los códigos de barras como campos del pase o datos del código de barras, en lugar de dibujarlos en la imagen; el contenido incrustado no se puede actualizar ni localizar, y tampoco se puede escanear de forma fiable.
2. Recopila los datos del pase: nombre del emisor, tipo de pase, número de serie, campos mostrados, formato y carga útil del código de barras, fechas relevantes, colores y cualquier información de actualización. Una captura de pantalla de un ticket no proporciona automáticamente estos valores. Si el PNG contiene un código de barras, decodifícalo por separado y verifica el resultado.
3. Para la generación mediante programación, crea un Pass Type ID de Apple Developer y obtén su certificado y clave privada. El identificador de pass.json debe coincidir con el certificado. El proceso de firma también requiere el certificado intermedio actual de Apple Worldwide Developer Relations.
4. Usa passkit-generator para disfrutar de un flujo de trabajo repetible con Node.js en macOS, Windows o Linux. Instálalo con npm install passkit-generator, proporciona pass.json, los recursos PNG, el certificado Pass Type ID, la clave privada y el certificado intermedio de Apple; después, exporta el archivo .pkpass generado. La biblioteca crea el manifiesto y la firma, evitando errores habituales al crear archivos ZIP y firmarlos manualmente.
5. Para un flujo de trabajo sin código o alojado, una plataforma de pases como PassKit puede aceptar elementos gráficos, recopilar campos del pase y datos del código de barras, firmar pases con las credenciales de Apple configuradas y distribuirlos mediante un enlace de descarga o correo electrónico. Es un servicio de creación de pases, no un conversor de PNG: el emisor aún debe proporcionar datos de pase y credenciales válidos. Revisa el tratamiento de datos antes de cargar tickets, documentos de identidad o diseños no publicados.
6. Abre el archivo terminado en un iPhone o iPad con Apple Wallet y prueba la instalación, el escaneo del código de barras, el contraste del texto, la escala de la imagen, las fechas y la versión más antigua de iOS compatible. No edites, vuelvas a comprimir ni añadas archivos después de firmarlo; cualquier cambio en el paquete invalida la firma del manifiesto.

Límites de calidad y compatibilidad

Apple Wallet no acepta un PNG renombrado con la extensión .pkpass, un ZIP que contenga únicamente una imagen ni un archivo sin firmar. Un paquete utilizable necesita un pass.json válido, archivos correctamente procesados mediante hash en manifest.json, una signature criptográfica coincidente y una estructura de pase compatible.

La calidad de la imagen depende de la resolución de origen y del espacio de recursos. Ampliar una captura de pantalla pequeña produce desenfoque, mientras que el texto incluido en los elementos gráficos puede resultar ilegible en diferentes pantallas. Utiliza los roles y las dimensiones de imagen documentados por la herramienta de pases elegida, y mantén los datos escaneables del código de barras en un código de barras nativo de Wallet siempre que sea posible.

PKPASS está diseñado para Apple Wallet y no es el formato de pase nativo de Google Wallet ni de otras wallets de Android. Para la distribución en Android, utiliza el formato de pases de la plataforma de destino o un servicio que genere versiones específicas para cada plataforma. La compatibilidad de Wallet, los requisitos de los certificados, los campos de los pases y el comportamiento de los códigos de barras también pueden cambiar según las especificaciones actuales de PassKit de Apple, por lo que debes verificar el archivo generado con las versiones de iOS compatibles antes de distribuirlo.