Inspektor i emulator Apple Wallet (.pkpass)
Analizuj, debuguj i naprawiaj pakiety kart Apple Wallet (.pkpass). Wierny emulator kart pokładowych, biletów na wydarzenia, kart lojalnościowych i kuponów z automatyczną naprawą manifestu SHA-1 oraz eksportem do Google Wallet.
| File | Manifest Hash | Actual Hash | Integrity Status |
|---|
Dlaczego iOS odrzuca pliki .pkpass bez komunikatu o błędzie
System iOS nie wyświetla szczegółowych błędów w interfejsie — po prostu nie otwiera uszkodzonego pliku. Oto najczęstsze przyczyny problemów wykrywane przez ten inspektor:
⚠️ Rozsynchronizowanie sum SHA-1 w manifest.json
Zmiana daty, treści lub kodu kreskowego w pass.json bez przeliczenia jego sumy SHA-1 w manifest.json sprawia, że iOS natychmiast odrzuca bilet jako uszkodzony.
🕒 Daty bez strefy czasowej w formacie ISO 8601
iOS bezwzględnie wymaga, aby pola expirationDate oraz relevantDate zawierały pełną strefę czasową (np. 2026-08-23T14:30:00+02:00 lub Z). Daty 'pływające' bez strefy powodują błąd.
🖼️ Brakujące ikony Retina i wymagane grafiki
Apple Wallet wymaga obecności plików icon.png oraz icon@2x.png (58x58 px) do powiadomień na ekranie blokady. Brak ikony uniemożliwia dodanie karty do Portfela.
📱 Nieprawidłowe kodowanie i format kodów kreskowych
Użycie nieobsługiwanej strony kodowej lub błędnego formatu uniemożliwia wyrenderowanie kodu QR lub PDF417. Standardem powinno być zawsze utf-8 lub iso-8859-1.
Często zadawane pytania
Co znajduje się wewnątrz pliku .pkpass?
Plik .pkpass to standardowe archiwum ZIP zawierające plik pass.json (układ pól, kolory, daty, kody kreskowe), manifest.json (słownik sum kontrolnych SHA-1 wszystkich plików), plik signature (podpis cyfrowy PKCS#7 od Apple Developer) oraz grafiki PNG (ikony, logo, baner, miniatura).
Czy mogę otworzyć plik .pkpass na systemie Android, Windows lub Linux?
Tak! To narzędzie działa w 100% w przeglądarce i renderuje wierną wizualizację karty pokładowej, biletu, karty stałego klienta lub kuponu wraz z czytelnym kodem kreskowym i QR.
Jak działa funkcja 'Napraw i pobierz .pkpass'?
Jeśli zmodyfikujesz pass.json lub poprawisz uszkodzone pliki, kliknięcie 'Napraw i pobierz .pkpass' przelicza sumy SHA-1 wszystkich plików w archiwum, tworzy poprawny manifest.json i pobiera spakowany plik .pkpass.
Czy mój bilet lub karta pokładowa jest przesyłana na Wasz serwer?
Nie. Cała dekompresja archiwum ZIP, obliczanie sum kontrolnych SHA-1, parsowanie certyfikatów PKCS#7 i generowanie kodów kreskowych odbywa się 100% lokalnie w Twojej przeglądarce. Żadne dane nie są przesyłane ani przechowywane.