Inspektor i debugger kart Apple Wallet PKPass
Upuść plik .pkpass lub pass.json, aby automatycznie sprawdzić go w przeglądarce. Zweryfikuj schemat, sumy, grafiki, strukturę podpisu, kolory i kody, a następnie odbuduj niepodpisany pakiet do zaufanego podpisania.
Podgląd do diagnostyki, nie wierna kopia Apple Wallet. Układ może się różnić zależnie od wersji i urządzenia; sprawdź podpisaną kartę w Apple 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. Zawiera pass.json z układem pól, kolorami, datami i kodami kreskowymi. Ma też manifest.json z sumami SHA-1, podpis PKCS#7 oraz grafiki PNG: ikony, logo, baner i miniaturę.
Czy mogę otworzyć plik .pkpass na systemie Android, Windows lub Linux?
Tak. Podgląd pól, kolorów, kodów i obsługiwanych grafik działa lokalnie w przeglądarce. Nie jest kopią Apple Wallet piksel po pikselu; ostatecznie sprawdź podpisaną kartę na iPhonie.
Jak działa funkcja odbudowy niepodpisanego .pkpass?
Odbudowanie przelicza sumy SHA-1, tworzy nowy manifest.json, usuwa stary podpis, który przestał być ważny, i pobiera niepodpisany pakiet. Przed instalacją musisz podpisać go certyfikatem Apple Pass Type ID.
Czy mój bilet lub karta pokładowa jest przesyłana na Wasz serwer?
Pliki upuszczone w interfejsie są przetwarzane lokalnie w przeglądarce i nie są wysyłane. Oddzielne przykłady cURL i REST API jawnie przesyłają dane do StackHal w celu przetworzenia po stronie serwera.