Konversi PNG menjadi PKPASS

PNG harus menjadi bagian dari pass Apple Wallet ketika tiket, boarding pass, loyalty card, atau kupon perlu diinstal di Wallet, bukan dibagikan sebagai gambar. PNG menyediakan artwork; package PKPASS yang dihasilkan menyediakan field terstruktur, data barcode, dan cryptographic signature.

Apa itu format PNG

PNG adalah format raster-image lossless yang mendukung transparency, indexed color, grayscale, serta gambar full-color RGB atau RGBA. Web designer, software developer, fotografer, graphic editor, dan pengguna yang membuat screenshot, logo, QR code, serta artwork hasil pemindaian umumnya menggunakannya. Aplikasi termasuk Adobe Photoshop, Affinity Photo, GIMP, dan Preview dapat membuat atau mengekspor file PNG.

PNG berisi pixel, bukan instruksi Wallet. PNG biasanya tidak berisi pass field, barcode payload, update URL, layout Apple Wallet, atau signing data yang diperlukan oleh PKPASS. Pass generator dapat menggunakannya sebagai icon, logo, strip, thumbnail, background, atau image asset lain yang didukung.

Apa itu format PKPASS

PKPASS adalah format pass-package milik Apple Wallet. File dengan ekstensi .pkpass adalah arsip ZIP yang berisi file seperti pass.json, image asset, manifest.json, dan cryptographic signature.

File pass.json mengidentifikasi pass type, issuer, team, serial number, colors, fields, barcode, dates, dan perilaku Wallet lainnya. manifest.json mencantumkan file package dan hash SHA-1-nya; signature menandatangani manifest tersebut dengan sertifikat Apple Pass Type ID. Wallet memeriksa signature sebelum menerima pass. Struktur ini mendukung boarding pass, tiket acara, kupon, store card, dan membership card dengan data yang dapat dibaca mesin dan diperbarui.

Cara membuat PKPASS dari PNG

Tidak ada konversi one-click yang valid untuk PNG standalone. Buat Wallet pass dan masukkan PNG ke dalamnya.

1. Siapkan artwork dalam image editor. Ekspor PNG RGB atau RGBA, hapus metadata yang tidak diperlukan, dan ikuti dimensi yang diwajibkan pass generator serta aturan penamaan asset @2x atau @3x. Simpan teks penting dan barcode sebagai pass field atau barcode data, bukan dengan menggambarnya ke dalam image; konten yang disematkan tidak dapat diperbarui, dilokalkan, atau dipindai secara andal.
2. Kumpulkan pass data: nama issuer, pass type, serial number, display field, barcode format dan payload, tanggal yang relevan, colors, serta informasi update apa pun. Screenshot tiket tidak otomatis menyediakan nilai-nilai ini. Jika PNG berisi barcode, decode secara terpisah dan verifikasi hasilnya.
3. Untuk pembuatan secara programmatic, buat Apple Developer Pass Type ID dan dapatkan certificate serta private key-nya. Identifier dalam pass.json harus cocok dengan certificate. Proses signing juga memerlukan current Apple Worldwide Developer Relations intermediate certificate.
4. Gunakan passkit-generator untuk workflow Node.js yang dapat diulang di macOS, Windows, atau Linux. Instal dengan npm install passkit-generator, sediakan pass.json, PNG asset, Pass Type ID certificate, private key, dan Apple intermediate certificate, lalu ekspor file .pkpass yang dihasilkan. Library ini membuat manifest dan signature, sehingga menghindari kesalahan umum pada ZIP dan signing manual.
5. Untuk workflow no-code atau hosted, pass platform seperti PassKit dapat menerima artwork, mengumpulkan pass field dan barcode data, menandatangani pass dengan Apple credentials yang dikonfigurasi, serta mendistribusikannya melalui download link atau email. Ini adalah pass-authoring service, bukan PNG converter: issuer tetap harus menyediakan pass data dan credentials yang valid. Tinjau data handling-nya sebelum mengunggah tiket, identity document, atau desain yang belum dirilis.
6. Buka file yang sudah selesai di iPhone atau iPad dengan Apple Wallet dan uji instalasi, pemindaian barcode, text contrast, image scaling, tanggal, serta versi iOS tertua yang didukung. Jangan mengedit, mengompres ulang, atau menambahkan file setelah signing; perubahan apa pun pada package akan membatalkan manifest signature.

Batasan kualitas dan kompatibilitas

Apple Wallet tidak menerima PNG yang diubah namanya menjadi .pkpass, ZIP yang hanya berisi image, atau arsip unsigned. Package yang dapat digunakan memerlukan pass.json yang valid, file dengan hash yang benar dalam manifest.json, cryptographic signature yang cocok, dan pass structure yang didukung.

Kualitas image bergantung pada source resolution dan asset slot. Memperbesar screenshot kecil akan menghasilkan blur, sedangkan teks yang dirender di dalam artwork dapat menjadi sulit dibaca pada display yang berbeda. Gunakan image role dan dimensi yang didokumentasikan oleh pass tool yang dipilih, serta simpan barcode data yang dapat dipindai dalam native Wallet barcode jika memungkinkan.

PKPASS dirancang untuk Apple Wallet dan bukan native pass format untuk Google Wallet atau wallet Android lainnya. Untuk distribusi Android, gunakan pass format platform target atau service yang menghasilkan versi khusus platform. Dukungan Wallet, persyaratan certificate, pass field, dan perilaku barcode juga dapat berubah berdasarkan PassKit specification Apple saat ini, jadi verifikasi file yang dihasilkan terhadap versi iOS yang didukung sebelum distribusi.