Convertir PNG en PKPASS

Un PNG doit faire partie d’un pass Apple Wallet lorsqu’un billet, une carte d’embarquement, une carte de fidélité ou un coupon doit être installé dans Wallet au lieu d’être partagé sous forme d’image. Le PNG fournit les éléments graphiques ; le package PKPASS résultant fournit les champs structurés, les données de code-barres et une signature cryptographique.

Ce qu’est le format PNG

PNG est un format d’image matricielle sans perte qui prend en charge la transparence, les couleurs indexées, les niveaux de gris et les images RVB ou RVBA en couleurs réelles. Les concepteurs Web, les développeurs logiciels, les photographes, les graphistes et les utilisateurs qui créent des captures d’écran, des logos, des codes QR et des illustrations numérisées l’utilisent couramment. Des applications telles qu’Adobe Photoshop, Affinity Photo, GIMP et Preview peuvent créer ou exporter des fichiers PNG.

Un PNG contient des pixels, et non des instructions pour Wallet. Il ne contient normalement pas les champs du pass, la charge utile du code-barres, l’URL de mise à jour, la mise en page Apple Wallet ou les données de signature requises par PKPASS. Un générateur de pass peut l’utiliser comme icône, logo, bandeau, miniature, arrière-plan ou autre ressource d’image prise en charge.

Ce qu’est le format PKPASS

PKPASS est le format de package de pass d’Apple Wallet. Un fichier portant l’extension .pkpass est une archive ZIP contenant des fichiers tels que pass.json, des ressources d’image, manifest.json et une signature cryptographique.

Le fichier pass.json identifie le type de pass, l’émetteur, l’équipe, le numéro de série, les couleurs, les champs, le code-barres, les dates et d’autres comportements de Wallet. manifest.json répertorie les fichiers du package et leurs hachages SHA-1 ; signature signe ce manifeste avec un certificat Apple Pass Type ID. Wallet vérifie la signature avant d’accepter le pass. Cette structure prend en charge les cartes d’embarquement, les billets d’événement, les coupons, les cartes de magasin et les cartes de membre contenant des données lisibles par machine et actualisables.

Comment créer un PKPASS à partir d’un PNG

Il n’existe pas de conversion valide en un clic d’un PNG autonome. Créez un pass Wallet et placez le PNG à l’intérieur.

1. Préparez les éléments graphiques dans un éditeur d’image. Exportez un PNG RVB ou RVBA, supprimez les métadonnées inutiles et respectez les dimensions requises par le générateur de pass ainsi que les règles de nommage des ressources @2x ou @3x. Conservez les textes importants et les codes-barres sous forme de champs du pass ou de données de code-barres au lieu de les dessiner dans l’image ; le contenu intégré ne peut pas être actualisé, localisé ou numérisé de manière fiable.
2. Rassemblez les données du pass : nom de l’émetteur, type de pass, numéro de série, champs affichés, format et charge utile du code-barres, dates pertinentes, couleurs et éventuelles informations de mise à jour. Une capture d’écran d’un billet ne fournit pas automatiquement ces valeurs. Si le PNG contient un code-barres, décodez-le séparément et vérifiez le résultat.
3. Pour une génération programmatique, créez un Apple Developer Pass Type ID et obtenez son certificat ainsi que sa clé privée. L’identifiant dans pass.json doit correspondre au certificat. Le processus de signature nécessite également le certificat intermédiaire actuel Apple Worldwide Developer Relations.
4. Utilisez passkit-generator pour un workflow Node.js reproductible sur macOS, Windows ou Linux. Installez-le avec npm install passkit-generator, fournissez pass.json, les ressources PNG, le certificat Pass Type ID, la clé privée et le certificat intermédiaire Apple, puis exportez le fichier .pkpass généré. La bibliothèque crée le manifeste et la signature, ce qui évite les erreurs courantes liées à la création manuelle de ZIP et à la signature.
5. Pour un workflow sans code ou hébergé, une plateforme de pass telle que PassKit peut accepter les éléments graphiques, recueillir les champs du pass et les données de code-barres, signer les pass avec les identifiants Apple configurés et les distribuer au moyen d’un lien de téléchargement ou par e-mail. Il s’agit d’un service de création de pass, et non d’un convertisseur PNG : l’émetteur doit toujours fournir des données de pass et des identifiants valides. Vérifiez la gestion des données avant de téléverser des billets, des documents d’identité ou des designs non publiés.
6. Ouvrez le fichier terminé sur un iPhone ou un iPad avec Apple Wallet et testez l’installation, la numérisation du code-barres, le contraste du texte, la mise à l’échelle de l’image, les dates et la version iOS la plus ancienne prise en charge. Ne modifiez pas, ne recompressez pas et n’ajoutez aucun fichier après la signature ; toute modification du package invalide la signature du manifeste.

Limites de qualité et de compatibilité

Apple Wallet n’accepte pas un PNG renommé en .pkpass, un ZIP contenant uniquement une image ou une archive non signée. Un package utilisable nécessite un pass.json valide, des fichiers correctement hachés dans manifest.json, une signature cryptographique correspondante et une structure de pass prise en charge.

La qualité de l’image dépend de la résolution source et de l’emplacement de la ressource. Agrandir une petite capture d’écran produit un flou, tandis que le texte rendu dans les éléments graphiques peut devenir illisible sur différents écrans. Utilisez les rôles et les dimensions d’image documentés par l’outil de pass choisi, et conservez si possible les données de code-barres numérisables dans un code-barres Wallet natif.

PKPASS est conçu pour Apple Wallet et ne constitue pas le format de pass natif de Google Wallet ou d’autres portefeuilles Android. Pour une distribution sur Android, utilisez le format de pass de la plateforme cible ou un service qui génère des versions spécifiques à chaque plateforme. La prise en charge de Wallet, les exigences relatives aux certificats, les champs des pass et le comportement des codes-barres peuvent également changer avec les spécifications PassKit actuelles d’Apple ; vérifiez donc le fichier généré par rapport aux versions iOS prises en charge avant sa distribution.