Co to jest format pliku PKPASS?
Pliki z rozszerzeniem .pkpass zawierają różne rodzaje danych spakowanych kompresją ZIP, w tym bilety, karty pokładowe, kupony, karty członkowskie, legitymacje studenckie, karty lojalnościowe oraz karty kredytowe lub debetowe współpracujące z Apple Pay.
Na urządzeniach mobilnych karty są wyświetlane jako kody kreskowe w formatach takich jak Aztec, PDF417, QR lub Code 128 (1D).
Dodatkowe informacje
Format ten został wprowadzony w 2012 roku przez Apple dla aplikacji Passbook - przemianowanej na Apple Wallet w iOS 9 (2015). Może być otwierany również przez inne programy na różnych platformach.
Wewnętrznie pakiet .pkpass to archiwum ZIP zawierające kilka wymaganych plików:
pass.json- główne dane karty: typ, pola wyświetlania, kolory i adresy URLmanifest.json- słownik JSON z sumami kontrolnymi SHA-1 dla każdego dołączonego plikusignature- oddzielny podpis PKCS#7 wygenerowany przy użyciu certyfikatu Pass Type ID wydanego przez Apple- zasoby graficzne, takie jak
icon.png,logo.pngistrip.png
Pliki .pkpass mogą być dystrybuowane na różne sposoby - wewnątrz aplikacji, stron internetowych, platform społecznościowych, przez SMS, MMS, e-mail oraz kody QR lub kody kreskowe.
Bezpieczeństwo
RYZYKO: LOWPliki PKPASS są podpisane kryptograficznie certyfikatem wydanym przez Apple i zawierają wyłącznie dane oraz obrazy - bez kodu wykonywalnego - więc nie mogą zainfekować urządzenia. Wallet odrzuca karty, których podpis nie jest poprawny. Prawdziwym ryzykiem jest prywatność: kod kreskowy karty koduje dane Twojej rezerwacji/biletu, więc nie udostępniaj plików kart ani zrzutów ekranu publicznie i zachowaj ostrożność przy przesyłaniu kart pokładowych do internetowych konwerterów.
Szczegóły formatu
w pigułcePEŁNA NAZWAApple Wallet Pass (formerly Passbook)
DEWELOPERApple Inc.od 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015)
KATEGORIAPliki danych
TYP MIMEapplication/vnd.apple.pkpass
TYPCyfrowo podpisany pakiet karty oparty na ZIP (JSON + obrazy + podpis PKCS#7)
STANDARDOtwarty · bezpłatny
MAGICZNE BAJTY · SYGNATURA PLIKU
OFFSET
00010203
HEX
504B0304
ASCII
PK··
Identyczne z dowolnym ZIP; rozróżnialne po wewnętrznych plikach pass.json + manifest.json + signature
Programy otwierające pliki PKPASS
Windows1 app
7-Zip
Open-source Kliknij prawym przyciskiem myszy → Otwórz archiwum (to plik ZIP): przejrzyj pass.json w poszukiwaniu szczegółów i otwórz obrazy kodów kreskowych - wystarczy, by pokazać bilet w nagłej sytuacji. 
macOS1 app
Pass Viewer (built-in)
Wbudowany Kliknij dwukrotnie .pkpass - systemowy Pass Viewer w macOS wyświetli podgląd i zaoferuje opcję „Dodaj do Wallet” przez iPhone/iCloud. 
Android3 apps
PassWallet
Freemium Zainstaluj, a następnie otwórz załącznik .pkpass i wybierz PassWallet; aplikacja przechowuje i wyświetla kod kreskowy do skanowania.
WalletPasses
Darmowy Zainstaluj, otwórz plik .pkpass za pomocą WalletPasses; aplikacja automatycznie importuje karty znalezione na urządzeniu.
Pass2U Wallet
Freemium Otwórz .pkpass za pomocą Pass2U; pozwala również na odbudowywanie kart z kodów kreskowych/PDF i synchronizację z chmurą.
iOS1 app
Apple Wallet
Wbudowany Dotknij załącznika .pkpass (Mail, Safari, Wiadomości) → otworzy się podgląd → dotknij „Dodaj”. Wbudowane w iOS od wersji iOS 6. Szczegóły techniczne
specyfikacja| Format kontenera | Archiwum ZIP; magiczne bajty 50 4B 03 04 („PK” nagłówek pliku lokalnego) |
| Wymagane pliki wewnętrzne | pass.json, manifest.json, signature oraz co najmniej jeden obraz ikony |
| Deskryptor karty | pass.json - definiuje typ karty, pola wyświetlania, kolory, typ kodu kreskowego i adresy URL usług internetowych |
| Manifest integralności plików | manifest.json - słownik JSON z sumami kontrolnymi SHA-1 dla każdego pliku w pakiecie |
| Podpis cyfrowy | Oddzielny podpis PKCS#7 (plik o nazwie signature), podpisany certyfikatem Pass Type ID wydanym przez Apple |
| Urząd certyfikacji | Apple Developer Program; certyfikat Pass Type ID jest wymagany do generowania ważnych podpisów |
| Typ MIME | application/vnd.apple.pkpass |
| Obsługiwane formaty kodów kreskowych | Aztec, PDF417, QR Code, Code 128 (1D) |
| Typy kart | boardingPass, coupon, eventTicket, generic, storeCard (zdefiniowane w pass.json) |
| Zasoby graficzne | Pliki PNG: icon.png, logo.png, strip.png, thumbnail.png, background.png; warianty Retina jako @2x i @3x |
| Obsługa NFC | Opcjonalne dane NFC dla zbliżeniowego odczytu; wymaga uprawnień Apple przyznanych wystawcy |
| Kanały dystrybucji | Załącznik e-mail, pobieranie ze strony, dostarczanie w aplikacji, AirDrop, SMS/MMS, skanowanie kodu QR |
| Pakiet wielu kart | Wiele kart może być spakowanych razem jako plik .pkpasses (również oparty na ZIP) |
| Obsługa platform | Natywna na iOS i macOS (Apple Wallet); obsługa Androida przez aplikacje firm trzecich, takie jak PassWallet i Pass2U Wallet |
| Wydano | 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015) |
| Otwarty standard | Tak · bezpłatny (royalty-free) |
| Specyfikacja | developer.apple.com |
Konwersje PKPASS
Możliwa
.PKPASS .ZIPPRZEWODNIK
Tak - plik .pkpass jest wewnętrznie archiwum ZIP; skopiuj plik, zmień rozszerzenie na .zip, a dowolne…
Jak konwertować
.PKPASS .PDFPRZEWODNIK
Tak - plik .pkpass można przekonwertować na PDF, otwierając go w przeglądarce kart i drukując do sterownika…
Jak konwertować
.PKPASS .JPGPRZEWODNIK
Tak - obrazy znajdujące się wewnątrz pliku .pkpass można wyodrębnić i zapisać jako JPG, lub można wykonać…
Jak konwertować
.PKPASS .PNGPRZEWODNIK
Tak - obrazy PNG są już spakowane wewnątrz każdego pliku .pkpass; zmień nazwę kopii na .zip, otwórz ją…
Jak konwertować
Pytania i odpowiedzi społeczności
pytania użytkownikówBrak pytań - bądź pierwszą osobą, która zapyta o pliki PKPASS.
Najczęściej zadawane pytania
Jak otworzyć plik PKPASS na Androidzie?
Android nie posiada wbudowanej obsługi. Zainstaluj PassWallet, WalletPasses lub Pass2U Wallet ze sklepu Google Play, a następnie otwórz załącznik .pkpass za pomocą tej aplikacji - przechowuje ona bilet i wyświetla skanowalny kod kreskowy.
Czy mogę dodać PKPASS do Portfela Google?
Nie bezpośrednio - Portfel Google używa własnego formatu kart i nie importuje plików .pkpass. Użyj aplikacji innej firmy lub sprawdź, czy wystawca oferuje zamiast tego przycisk „Dodaj do Portfela Google”.
Jak przekonwertować PKPASS na PDF, aby wydrukować bilet?
Otwórz kartę w Wallet lub aplikacji do kart i wydrukuj/zapisz jako PDF, albo zmień rozszerzenie pliku na .zip i wydrukuj wyodrębniony kod kreskowy wraz ze szczegółami z pass.json. Sprawdź, czy organizator/linia lotnicza akceptuje wydrukowane kody.
Dlaczego mój PKPASS nie otwiera się na iPhone?
Zazwyczaj karta wygasła, jest uszkodzona lub jej podpis jest nieważny - Wallet po cichu odrzuca takie karty. Pobierz ją ponownie z linku wystawcy lub e-maila; upewnij się również, że otwierasz ją w Mail/Safari, a nie w przeglądarce innej firmy.
Co znajduje się wewnątrz pliku PKPASS?
Jest to archiwum ZIP zawierające pass.json (dane biletu i treść kodu kreskowego), obrazy ikon/logo, manifest.json z hashami plików oraz podpis cyfrowy wystawcy karty.
Czy mogę edytować plik PKPASS?
Możesz edytować pass.json po rozpakowaniu, ale karta nie zainstaluje się już w Wallet - podpis nie będzie się zgadzać. Tylko wystawca (posiadający certyfikat Apple pass) może generować ważne karty.
Źródła
1Apple Developer - Wallet Passes documentationdeveloper.apple.com
2Apple Developer - Building a Pass (bundle layout, manifest, signature)developer.apple.com
