קובץ pkpass הוא הפורמט שבו Apple Wallet משתמש לכרטיסים: כרטיסי עלייה למטוס, כרטיסי נאמנות, קופונים, כרטיסים לאירועים. זו לא אפליקציה וזו לא תמונה. זהו ארכיון ZIP חתום עם מבנה מסוים, וברגע שמבינים מה יש בפנים, רוב השאלות שאנשים שואלים על כרטיסי Wallet עונות על עצמן.
מה יש בתוך קובץ pkpass, בפועל
שנו שם קובץ .pkpass ל-.zip, פתחו אותו, ותמצאו קבוצה קטנה של קבצים. ארבעה דברים חשובים:
- pass.json — הכרטיס עצמו. שדות, צבעים, ברקוד, הטקסט שמופיע בחזית ובגב. כאן כרטיס עלייה למטוס הופך לכרטיס עלייה למטוס וכרטיס קפה הופך לכרטיס קפה.
- manifest.json — רשימה של כל קובץ בארכיון עם hash מסוג SHA-1 לכל אחד. זהו דף הביקורת שמוכיח ששום דבר לא שונה.
- signature — חתימה קריפטוגרפית של המניפסט, שנוצרת עם תעודה שהונפקה על ידי Apple. זה החלק שגורם ל-Wallet לסמוך על הכרטיס. אין חתימה תקפה, אין כרטיס.
- תמונות — icon.png, logo.png וכל אייקון strip או thumbnail, בדרך כלל ברזולוציות 1x, 2x ו-3x למסכים שונים.
זו כל החבילה. העיצוב יושב ב-pass.json, התמונות לצידו, והמניפסט והחתימה שם כדי להוכיח שהחבילה אותנטית ולא שונתה. זהו קונטיינר משעמם בכוונה, וניתן לאימות.
האם צריך חשבון Apple Developer כדי ליצור אחד
תשובה קצרה: כן כדי ליצור, לא כדי לקבל.
קובץ החתימה הוא מה שמחייב את החשבון. הוא חייב להיווצר עם תעודת Pass Type ID, ומקבלים אחת כזו רק דרך חשבון Apple Developer, שעולה 99 דולר בשנה. בלי התעודה הזו אפשר להרכיב כל קובץ אחר נכון, ו-Wallet עדיין יסרב לכרטיס, כי הוא לא יכול לאמת מי הנפיק אותו.
הלקוחות שלכם לא צריכים כלום מזה. חשבון המפתחים הוא דרישה למנפיק — העסק שיוצר וחותם על הכרטיסים — לא למי שמוסיף כרטיס לטלפון. הם רק לוחצים הוספה. עבודת התעודה קורית פעם אחת, אצלכם, הרבה לפני שכרטיס מגיע למישהו. לעסקים ישראליים רבים, זו בדיוק הסיבה לוותר על הכאב הזה מראש ולעבוד עם פלטפורמה שכבר מחזיקה את התעודה במקומכם.
קובץ pkpass מול wallet pass כללי
אנשים אומרים “wallet pass” בצורה רופפת, אז שווה להבהיר. קובץ pkpass הוא ספציפית הפורמט של Apple. Google Wallet משתמש במנגנון שונה לגמרי — מבוסס על pass objects שמוגדרים דרך ה-API שלו, ולא על קובץ חתום שמורידים.
אז pkpass הוא סוג אחד של wallet pass, הסוג של Apple. אם בונים לשתי הפלטפורמות, מייצרים כרטיס pkpass של Apple ו-object של Google Wallet מאותו מידע בסיסי, לא קובץ אחד שעובד בכל מקום. אותו רעיון ללקוח, שני נתיבים טכניים שונים מאחורי הקלעים — ובישראל, שבה חדירת ה-iOS גבוהה יחסית לעולם אבל Android עדיין נפוץ מאוד, לא כדאי לוותר על אף אחת מהפלטפורמות.
איך פותחים או בודקים קובץ pkpass
כמה דרכים מעשיות לבדוק כרטיס לפני שמשגרים אותו:
- באייפון או ב-Mac, לחצו פעמיים או פתחו את הקובץ ו-Wallet יציג תצוגה מקדימה ישירה, בדיוק כמו שלקוח יראה.
- כדי לראות את התוכן הפנימי, שנו את שם הקובץ ל-.zip, פתחו אותו, ופתחו את pass.json בכל עורך טקסט. זו הדרך הכי מהירה לבדוק שדות, צבעים וערכי ברקוד.
- כדי לאמת את החתימה, כלי signpass של Apple ומאמתי כרטיסים מקוונים שונים יגידו לכם אם המניפסט והתעודה תקינים. כרטיס שמוצג יפה במכשיר שלכם עדיין יכול להיכשל אצל אחרים אם החתימה לא תקינה.
לדלג על פורמט הקובץ לגמרי
רוב האנשים שצריכים כרטיסי Wallet אף פעם לא רוצים לגעת ב-pass.json, לנהל תעודת חתימה, או לנפות באג במניפסט hash. הם רוצים כרטיס שהלקוחות שלהם יכולים להוסיף, כזה שמתעדכן כשהמידע משתנה. הפורמט הוא אמצעי, לא המטרה.
לא חייבים לגעת בפורמט pkpass בכלל. Pushwoosh מטפל בחתימה ובאריזה; אתם מעצבים את הכרטיס והוא יוצא לדרך. ראו Wallet Passes.
