Převod souboru PNG do PKPASS

PNG se musí stát součástí průkazu Apple Wallet, když je třeba do Wallet nainstalovat vstupenku, palubní vstupenku, věrnostní kartu nebo kupón namísto jejich sdílení jako obrázku. PNG poskytuje grafiku; výsledný balíček PKPASS poskytuje strukturovaná pole, data čárového kódu a kryptografický podpis.

Co je formát PNG

PNG je rastrový formát obrázků bez ztráty kvality, který podporuje průhlednost, indexované barvy, odstíny šedi a plnobarevné obrázky RGB nebo RGBA. Běžně jej používají webdesignéři, vývojáři softwaru, fotografové, grafičtí editoři a uživatelé vytvářející snímky obrazovky, loga, QR kódy a naskenované grafické materiály. Aplikace včetně Adobe Photoshop, Affinity Photo, GIMP a Preview mohou vytvářet nebo exportovat soubory PNG.

PNG obsahuje pixely, nikoli instrukce pro Wallet. Obvykle neobsahuje pole průkazu, datovou část čárového kódu, URL pro aktualizace, rozvržení Apple Wallet ani podpisová data vyžadovaná formátem PKPASS. Generátor průkazu jej může použít jako ikonu, logo, pruh, miniaturu, pozadí nebo jiný podporovaný obrazový prvek.

Co je formát PKPASS

PKPASS je formát balíčku průkazu pro Apple Wallet. Soubor s příponou .pkpass je archiv ZIP obsahující soubory, jako jsou pass.json, obrazové prvky, manifest.json a kryptografický signature.

Soubor pass.json identifikuje typ průkazu, vydavatele, tým, sériové číslo, barvy, pole, čárový kód, data a další chování Wallet. Soubor manifest.json uvádí soubory balíčku a jejich hashe SHA-1; signature podepisuje tento manifest certifikátem Apple Pass Type ID. Wallet před přijetím průkazu kontroluje podpis. Tato struktura podporuje palubní vstupenky, vstupenky na události, kupóny, zákaznické karty a členské karty se strojově čitelnými a aktualizovatelnými daty.

Jak vytvořit PKPASS z PNG

Samostatný PNG nelze platně převést jedním kliknutím. Vytvořte průkaz Wallet a vložte do něj PNG.

1. Připravte grafiku v editoru obrázků. Exportujte PNG RGB nebo RGBA, odstraňte nepotřebná metadata a dodržujte požadované rozměry generátoru průkazu a pravidla pro pojmenování prvků @2x nebo @3x. Důležitý text a čárové kódy ponechte jako pole průkazu nebo data čárového kódu namísto jejich vykreslení do obrázku; vložený obsah nelze aktualizovat, lokalizovat ani spolehlivě skenovat.
2. Shromážděte data průkazu: název vydavatele, typ průkazu, sériové číslo, zobrazovaná pole, formát a datovou část čárového kódu, relevantní data, barvy a případné informace o aktualizacích. Snímek obrazovky vstupenky tyto hodnoty automaticky neposkytuje. Pokud PNG obsahuje čárový kód, dekódujte jej samostatně a ověřte výsledek.
3. Pro programové generování vytvořte Apple Developer Pass Type ID a získejte jeho certifikát a soukromý klíč. Identifikátor v souboru pass.json se musí shodovat s certifikátem. Proces podepisování také vyžaduje aktuální zprostředkující certifikát Apple Worldwide Developer Relations.
4. Pro opakovatelný pracovní postup Node.js v systémech macOS, Windows nebo Linux použijte passkit-generator. Nainstalujte jej pomocí příkazu npm install passkit-generator, poskytněte soubor pass.json, prvky PNG, certifikát Pass Type ID, soukromý klíč a zprostředkující certifikát Apple a poté exportujte vygenerovaný soubor .pkpass. Knihovna vytvoří manifest a podpis, čímž předchází běžným chybám při ručním vytváření ZIP a podepisování.
5. Pro pracovní postup bez programování nebo s hostovanou službou může platforma pro průkazy, například PassKit, přijmout grafiku, shromáždit pole průkazu a data čárového kódu, podepsat průkazy nakonfigurovanými přihlašovacími údaji Apple a distribuovat je prostřednictvím odkazu ke stažení nebo e-mailu. Jde o službu pro vytváření průkazů, nikoli o převodník PNG: vydavatel stále musí dodat platná data průkazu a přihlašovací údaje. Před nahráním vstupenek, dokladů totožnosti nebo nezveřejněných návrhů si ověřte způsob zpracování dat.
6. Otevřete dokončený soubor na iPhonu nebo iPadu s Apple Wallet a otestujte instalaci, skenování čárového kódu, kontrast textu, škálování obrázku, data a nejstarší podporovanou verzi iOS. Po podepsání soubor neupravujte, znovu nekomprimujte ani do něj nepřidávejte soubory; jakákoli změna balíčku zneplatní podpis manifestu.

Limity kvality a kompatibility

Apple Wallet nepřijímá PNG přejmenovaný na .pkpass, ZIP obsahující pouze obrázek ani nepodepsaný archiv. Použitelný balíček potřebuje platný pass.json, správně hashované soubory v manifest.json, odpovídající kryptografický signature a podporovanou strukturu průkazu.

Kvalita obrázku závisí na rozlišení zdroje a pozici prvku. Zvětšení malého snímku obrazovky způsobí rozmazání, zatímco text vykreslený uvnitř grafiky může být na různých displejích nečitelný. Používejte role a rozměry obrázků zdokumentované vybraným nástrojem pro průkazy a pokud možno uchovávejte skenovatelná data čárového kódu v nativním čárovém kódu Wallet.

PKPASS je navržen pro Apple Wallet a není nativním formátem průkazů pro Google Wallet ani jiné peněženky v systému Android. Pro distribuci v systému Android použijte formát průkazu cílové platformy nebo službu, která generuje verze specifické pro jednotlivé platformy. Podpora Wallet, požadavky na certifikáty, pole průkazu a chování čárových kódů se mohou měnit podle aktuálních specifikací Apple PassKit, proto před distribucí ověřte vygenerovaný soubor oproti podporovaným verzím iOS.