Konwertuj PNG na PKPASS

PNG musi stać się częścią passa Apple Wallet, gdy bilet, karta pokładowa, karta lojalnościowa lub kupon ma zostać zainstalowany w Wallet zamiast udostępniony jako obraz. PNG dostarcza grafikę, a wynikowy pakiet PKPASS dostarcza ustrukturyzowane pola, dane kodu kreskowego oraz podpis kryptograficzny.

Czym jest format PNG

PNG to bezstratny format obrazu rastrowego, który obsługuje przezroczystość, kolory indeksowane, skalę szarości oraz pełnokolorowe obrazy RGB lub RGBA. Jest powszechnie używany przez projektantów stron internetowych, programistów, fotografów, grafików oraz użytkowników tworzących zrzuty ekranu, logotypy, kody QR i skany. Aplikacje takie jak Adobe Photoshop, Affinity Photo, GIMP i Preview mogą tworzyć lub eksportować pliki PNG.

PNG zawiera piksele, a nie instrukcje dla Wallet. Zwykle nie zawiera pól passa, danych ładunku kodu kreskowego, adresu URL aktualizacji, układu Apple Wallet ani danych podpisu wymaganych przez PKPASS. Generator passów może użyć go jako ikony, logotypu, paska, miniatury, tła lub innego obsługiwanego zasobu obrazu.

Czym jest format PKPASS

PKPASS to format pakietu passów Apple Wallet. Plik z rozszerzeniem .pkpass jest archiwum ZIP zawierającym pliki takie jak pass.json, zasoby obrazów, manifest.json oraz kryptograficzny signature.

Plik pass.json identyfikuje typ passa, wystawcę, zespół, numer seryjny, kolory, pola, kod kreskowy, daty i inne zachowania Wallet. manifest.json zawiera listę plików pakietu i ich skróty SHA-1; signature podpisuje ten manifest za pomocą certyfikatu Apple Pass Type ID. Wallet sprawdza podpis przed zaakceptowaniem passa. Ta struktura obsługuje karty pokładowe, bilety na wydarzenia, kupony, karty sklepowe i karty członkowskie z danymi czytelnymi maszynowo oraz możliwymi do aktualizacji.

Jak utworzyć PKPASS z PNG

Nie istnieje prawidłowa konwersja samodzielnego pliku PNG za pomocą jednego kliknięcia. Należy utworzyć passa Wallet i umieścić w nim plik PNG.

1. Przygotuj grafikę w edytorze obrazów. Wyeksportuj PNG RGB lub RGBA, usuń niepotrzebne metadane i zastosuj się do wymaganych przez generator passa wymiarów oraz zasad nazewnictwa zasobów @2x lub @3x. Ważny tekst i kody kreskowe przechowuj jako pola passa lub dane kodu kreskowego, zamiast rysować je na obrazie; osadzonych treści nie można aktualizować ani lokalizować, a ich skanowanie może być zawodne.
2. Zbierz dane passa: nazwę wystawcy, typ passa, numer seryjny, pola wyświetlane, format i ładunek kodu kreskowego, odpowiednie daty, kolory oraz wszelkie informacje o aktualizacjach. Zrzut ekranu biletu nie dostarcza automatycznie tych wartości. Jeśli PNG zawiera kod kreskowy, odczytaj go osobno i zweryfikuj wynik.
3. W przypadku generowania programistycznego utwórz Apple Developer Pass Type ID i uzyskaj jego certyfikat oraz klucz prywatny. Identyfikator w pliku pass.json musi odpowiadać certyfikatowi. Proces podpisywania wymaga również aktualnego certyfikatu pośredniego Apple Worldwide Developer Relations.
4. Użyj passkit-generator do powtarzalnego przepływu pracy Node.js w systemach macOS, Windows lub Linux. Zainstaluj go za pomocą npm install passkit-generator, podaj pass.json, zasoby PNG, certyfikat Pass Type ID, klucz prywatny i certyfikat pośredni Apple, a następnie wyeksportuj wygenerowany plik .pkpass. Biblioteka tworzy manifest i podpis, eliminując typowe błędy ręcznego tworzenia pliku ZIP i podpisywania.
5. W przypadku przepływu pracy bez kodowania lub hostowanego rozwiązania platforma do tworzenia passów, taka jak PassKit, może przyjąć grafikę, zebrać pola passa i dane kodu kreskowego, podpisać passy za pomocą skonfigurowanych danych uwierzytelniających Apple oraz dystrybuować je za pośrednictwem linku do pobrania lub wiadomości e-mail. Jest to usługa do tworzenia passów, a nie konwerter PNG: wystawca nadal musi dostarczyć prawidłowe dane passa i dane uwierzytelniające. Przed przesłaniem biletów, dokumentów tożsamości lub nieopublikowanych projektów sprawdź sposób przetwarzania danych.
6. Otwórz ukończony plik na iPhonie lub iPadzie z Apple Wallet i przetestuj instalację, skanowanie kodu kreskowego, kontrast tekstu, skalowanie obrazu, daty oraz najstarszą obsługiwaną wersję iOS. Po podpisaniu nie edytuj, nie kompresuj ponownie ani nie dodawaj plików; każda zmiana pakietu unieważnia podpis manifestu.

Ograniczenia jakości i zgodności

Apple Wallet nie akceptuje pliku PNG z przemianowaną nazwą na .pkpass, pliku ZIP zawierającego wyłącznie obraz ani niepodpisanego archiwum. Użyteczny pakiet wymaga prawidłowego pliku pass.json, poprawnie zahaszowanych plików w manifest.json, zgodnego kryptograficznego signature oraz obsługiwanej struktury passa.

Jakość obrazu zależy od rozdzielczości źródłowej i miejsca przeznaczonego na zasób. Powiększenie małego zrzutu ekranu powoduje rozmycie, a tekst wyrenderowany w grafice może stać się nieczytelny na różnych ekranach. Korzystaj z ról obrazów i wymiarów udokumentowanych przez wybrane narzędzie do tworzenia passów, a dane kodu kreskowego możliwe do zeskanowania umieszczaj, gdy to możliwe, w natywnym kodzie kreskowym Wallet.

PKPASS został zaprojektowany dla Apple Wallet i nie jest natywnym formatem passa dla Google Wallet ani innych portfeli Android. W przypadku dystrybucji na Androidzie użyj formatu passa docelowej platformy lub usługi generującej wersje specyficzne dla poszczególnych platform. Obsługa Wallet, wymagania dotyczące certyfikatów, pola passów i działanie kodów kreskowych mogą również zmieniać się wraz z aktualnymi specyfikacjami Apple PassKit, dlatego przed dystrybucją zweryfikuj wygenerowany plik pod kątem obsługiwanych wersji iOS.