Converti PNG in PKPASS

Un PNG deve diventare parte di un pass di Apple Wallet quando è necessario installare in Wallet un biglietto, una carta d’imbarco, una carta fedeltà o un coupon anziché condividerlo come immagine. Il PNG fornisce la grafica; il pacchetto PKPASS risultante fornisce campi strutturati, dati del codice a barre e una firma crittografica.

Che cos’è il formato PNG

PNG è un formato di immagini raster senza perdita che supporta la trasparenza, il colore indicizzato, la scala di grigi e le immagini RGB o RGBA a colori completi. Web designer, sviluppatori software, fotografi, editor grafici e utenti che creano screenshot, loghi, codici QR e materiali grafici scansionati lo utilizzano comunemente. Applicazioni tra cui Adobe Photoshop, Affinity Photo, GIMP e Preview possono creare o esportare file PNG.

Un PNG contiene pixel, non istruzioni per Wallet. Normalmente non contiene i campi del pass, il payload del codice a barre, l’URL di aggiornamento, il layout di Apple Wallet o i dati di firma richiesti da PKPASS. Un generatore di pass può utilizzarlo come icona, logo, fascia, miniatura, sfondo o altra risorsa immagine supportata.

Che cos’è il formato PKPASS

PKPASS è il formato dei pacchetti pass di Apple Wallet. Un file con estensione .pkpass è un archivio ZIP contenente file come pass.json, risorse immagine, manifest.json e una signature crittografica.

Il file pass.json identifica il tipo di pass, l’emittente, il team, il numero di serie, i colori, i campi, il codice a barre, le date e altri comportamenti di Wallet. manifest.json elenca i file del pacchetto e i relativi hash SHA-1; signature firma tale manifest con un certificato Apple Pass Type ID. Wallet verifica la firma prima di accettare il pass. Questa struttura supporta carte d’imbarco, biglietti per eventi, coupon, carte del negozio e carte socio con dati leggibili dalle macchine e aggiornabili.

Come creare un PKPASS da un PNG

Non esiste una conversione valida con un solo clic di un PNG autonomo. Crea un pass di Wallet e inserisci il PNG al suo interno.

1. Prepara la grafica in un editor di immagini. Esporta un PNG RGB o RGBA, rimuovi i metadati non necessari e segui le dimensioni richieste dal generatore di pass e le regole di denominazione delle risorse @2x o @3x. Mantieni i testi importanti e i codici a barre come campi del pass o dati del codice a barre invece di disegnarli nell’immagine; i contenuti incorporati non possono essere aggiornati o localizzati e non vengono scansionati in modo affidabile.
2. Raccogli i dati del pass: nome dell’emittente, tipo di pass, numero di serie, campi visualizzati, formato e payload del codice a barre, date rilevanti, colori ed eventuali informazioni di aggiornamento. Uno screenshot di un biglietto non fornisce automaticamente questi valori. Se il PNG contiene un codice a barre, decodificalo separatamente e verifica il risultato.
3. Per la generazione programmatica, crea un Apple Developer Pass Type ID e ottieni il relativo certificato e la chiave privata. L’identificatore in pass.json deve corrispondere al certificato. Il processo di firma richiede inoltre il certificato intermedio Apple Worldwide Developer Relations corrente.
4. Usa passkit-generator per un flusso di lavoro Node.js ripetibile su macOS, Windows o Linux. Installalo con npm install passkit-generator, fornisci pass.json, le risorse PNG, il certificato Pass Type ID, la chiave privata e il certificato intermedio Apple, quindi esporta il file .pkpass generato. La libreria crea il manifest e la firma, evitando i comuni errori manuali relativi a ZIP e firma.
5. Per un flusso di lavoro senza codice o ospitato, una piattaforma per pass come PassKit può accettare la grafica, raccogliere i campi del pass e i dati del codice a barre, firmare i pass con le credenziali Apple configurate e distribuirli tramite un link per il download o un’e-mail. È un servizio per la creazione di pass, non un convertitore PNG: l’emittente deve comunque fornire dati del pass e credenziali validi. Esamina le modalità di gestione dei dati prima di caricare biglietti, documenti d’identità o progetti non ancora pubblicati.
6. Apri il file completato su un iPhone o iPad con Apple Wallet e verifica l’installazione, la scansione del codice a barre, il contrasto del testo, il ridimensionamento dell’immagine, le date e la versione minima supportata di iOS. Non modificare, ricomprimere né aggiungere file dopo la firma; qualsiasi modifica al pacchetto invalida la firma del manifest.

Limiti di qualità e compatibilità

Apple Wallet non accetta un PNG rinominato in .pkpass, uno ZIP contenente solo un’immagine o un archivio non firmato. Un pacchetto utilizzabile richiede un pass.json valido, file con hash corretti in manifest.json, una signature crittografica corrispondente e una struttura del pass supportata.

La qualità dell’immagine dipende dalla risoluzione della sorgente e dallo spazio riservato alla risorsa. Ingrandire uno screenshot piccolo produce sfocatura, mentre il testo inserito nella grafica può diventare illeggibile su display diversi. Usa i ruoli e le dimensioni delle immagini documentati dallo strumento per pass scelto e, quando possibile, mantieni i dati scansionabili del codice a barre in un codice a barre nativo di Wallet.

PKPASS è progettato per Apple Wallet e non è il formato nativo dei pass per Google Wallet o altri wallet Android. Per la distribuzione su Android, usa il formato dei pass della piattaforma di destinazione o un servizio che generi versioni specifiche per piattaforma. Anche il supporto di Wallet, i requisiti dei certificati, i campi dei pass e il comportamento dei codici a barre possono cambiare in base alle specifiche PassKit attuali di Apple; verifica quindi il file generato rispetto alle versioni di iOS supportate prima della distribuzione.