यह आम तौर पर स्वीकार किया जाता है कि वॉलेट CIS में सबसे लोकप्रिय सेवा नहीं है। लेकिन पहले से ही एक पंक्ति में दूसरी परियोजना में, ग्राहक "वॉलेट के साथ एकीकरण करें" कार्य सेट करता है। इसलिए, मैंने इस लेख को समग्र रूप से सेवा के बारे में बात करने और यह दिखाने के लिए तय किया कि मैं अपने उत्पाद को इसमें कैसे एकीकृत करूं।

बटुआ क्या है? यह आपको अपने फोन (टिकट, डिस्काउंट कार्ड, आदि) में विभिन्न प्रकार के कार्ड रखने की अनुमति देता है, जिससे उत्पाद के उपयोगकर्ताओं के लिए जीवन आसान हो जाता है। इसके अलावा, पुश सूचनाओं के माध्यम से मानचित्र के बारे में जानकारी अपडेट करना संभव है, लेकिन यह एक अलग लेख के लिए एक विषय है। लेकिन अगर आपके पास एक कार्ड / टिकट / सदस्यता है जिसे फोन में एकीकृत किया जा सकता है, तो एक समाधान है! यह कैसे करें - नीचे पढ़ें।

एक नियम के रूप में, आपका सर्वर मानचित्र बनाने के लिए जिम्मेदार है। एप्लिकेशन को एक .pkpass फ़ाइल के रूप में कार्ड प्राप्त होता है और एप्लिकेशन के माध्यम से उपयोगकर्ता कार्ड को वॉलेट में जोड़ सकता है।

नक्शा संरचना

डेवलपर के दृष्टिकोण से नक्शा क्या है? नक्शा .pkpass के साथ एक संग्रह है। इसमें कार्ड के प्रदर्शन और संचालन के लिए आवश्यक सभी डेटा शामिल हैं। संग्रह की सामग्री नीचे दी गई तालिका में है।

निम्नलिखित प्रकार के कार्ड उपलब्ध हैं:

• बोर्डिंग टिकट: विमान या ट्रेन से। आमतौर पर कूपन एक यात्रा के लिए काम करता है;
• कूपन: कूपन और विशेष प्रस्तावों के लिए;
• इवेंट टिकट: एक इवेंट और पूरे सीजन के लिए दोनों काम कर सकते हैं;
• डिस्काउंट कार्ड: वफादारी कार्ड, छूट या उपहार कार्ड;
• सामान्य दृश्य कार्ड: यदि उपरोक्त में से कोई भी आपके मामले पर लागू नहीं होता है: उदाहरण के लिए, मेट्रो से यात्रा करने के लिए एक कार्ड या जिम के लिए एक पास।

योजनाबद्ध रूप से विभिन्न कार्डों की उपस्थिति पर विचार करें। चित्रों को सबसे ऊपर नामित तालिका में दर्शाया गया है।

बोर्डिंग पास

कूपन

इवेंट टिकट

सामुदायिक कार्ड

डिस्काउंट कार्ड

Pass.json संरचना

आवश्यक क्षेत्र। कंटेनर पास टाइप आईडी, टीम आईडी, संगठन का नाम, आदि।
संबंधित अनुप्रयोगों के लिए कुंजी। उन अनुप्रयोगों को प्रदर्शित करने की आवश्यकता है जो मानचित्र के साथ "संबद्ध" होने की आवश्यकता है।
कुंजी "समाप्ति तिथि" कार्ड।
प्रासंगिकता की कुंजी। उदाहरण के लिए, उस क्षेत्र के निर्देशांक जहां मानचित्र का उपयोग किया जा सकता है, या उस घटना की शुरुआत जिसके लिए यह इरादा है।
कुंजी शैली है। लेख की शुरुआत में, वॉलेट के लिए 5 प्रकार के कार्ड सूचीबद्ध किए गए थे। उनमें से प्रत्येक की अपनी शैली है। ऐसी कुंजी को कड़ाई से एक होना चाहिए।
कार्ड के दृश्य डिजाइन के लिए कुंजी। स्पष्ट के अलावा, वे मानचित्र पर प्रदर्शित बारकोड के बारे में जानकारी रखते हैं।
वेब सेवा कुंजी। आप मानचित्र के साथ बातचीत करने के लिए वेब सेवाओं का उपयोग कर सकते हैं, उदाहरण के लिए, इसे स्वचालित रूप से अपडेट करें।
एनएफसी कुंजी। Apple पे लेनदेन के लिए अतिरिक्त जानकारी दें।

अब सब कुछ और अधिक विस्तार से।

आवश्यक क्षेत्र

संबंधित अनुप्रयोगों के लिए कुंजी

स्टाइल कीज

इस मामले में JSON का निम्न रूप है:

"key" : "value1", "label" : "value2", "value" : "value3" 

मान कुंजी द्वारा मान या तो संख्यात्मक या स्ट्रिंग हो सकता है। हालाँकि, स्ट्रिंग मान के साथ मुद्राकोड का उपयोग नहीं किया जा सकता है। असिस्टेंटफिल्ड और सेकेंडरीफिल्ड के लिए, उनमें से कई हो सकते हैं, और आपको उन पंक्तियों की लंबाई की निगरानी करनी चाहिए जो उनमें उपयोग की जाती हैं।

विज़ुअल डिज़ाइन की कुंजी

बारकोड

नक्शे का सबसे महत्वपूर्ण हिस्सा। एक कार्ड पहचान संख्या को इसमें सीवन किया जाता है (उदाहरण के लिए, एक भौतिक कार्ड नंबर या टिकट संख्या)। यह महत्वपूर्ण है कि स्कैनर या कोई अन्य उपकरण सही एन्कोडिंग में कोड पढ़ने में सक्षम हो।

स्थान

ये कुंजियाँ उस स्थान के लिए ज़िम्मेदार होती हैं जिसके भीतर कार्ड का उपयोग किया जा सकता है।

पीछे की तरफ

अतिरिक्त जानकारी को रिवर्स सूचना भाग पर रखा जा सकता है: उपयोग की शर्तें, ऑटो-अपडेट नीति, संपर्क विवरण और कार्ड से संबंधित एप्लिकेशन का लिंक। आंकड़ा पास.जेसन में फ़ील्ड के पत्राचार और नक्शे के रिवर्स साइड की उपस्थिति को दर्शाता है। यदि मूल्य क्षेत्र में लिंक, फोन नंबर आदि हैं, तो वे स्वचालित रूप से हाइलाइट किए जाएंगे।

एक नक्शा बनाएँ। भाग २

तो, चित्र तैयार हैं, पास.जसन का गठन किया गया है, यह सभी को एक साथ रखने के लिए बना हुआ है। ऐसा करने के लिए, घोषणापत्र भरें। (देखें तालिका 1), जहां आपको सभी चित्रों को शामिल करने और पास करने की आवश्यकता है। यह कुछ इस तरह से निकलता है:

 . . . . . . "pass.json" = 303c753abc39aa732ec74643d6db28348fe8a823; "strip.png" = 736d01f84cb73d06e8a9932e43076d68f19461ff; "strip@2x.png" = 468fa7bc93e6b55342b56fda09bdce7c829d7d46; . . . . . . 

इस बिंदु से, कुछ भी बदलने की आवश्यकता नहीं है, क्योंकि SHA गलत होगा; परिवर्तनों के मामले में, SHA को पुन: उत्पन्न करना आवश्यक है।

अगला, आपको डेवलपर के कार्यालय में एक पास टाइप आईडी बनाने और इसके लिए एक प्रमाण पत्र बनाने की आवश्यकता है। यदि आप पहले बनाए गए हैं, तो प्रक्रिया कम या ज्यादा परिचित होनी चाहिए, उदाहरण के लिए, प्रोविजनिंग प्रोफाइल।

इसके बाद, किचेन में जाएं और वहां से Apple वर्ल्डवाइड डेवलपर रिलेशन सर्टिफिकेट (WWDR) को .pem के रूप में निर्यात करें।

वहाँ से, हम निर्मित पास टाइप आईडी को .p12 के रूप में निर्यात करते हैं। इस बिंदु पर, हाउसकीपर आपको प्रमाण पत्र के लिए पासवर्ड दर्ज करने के लिए कहेगा। इस स्थिति में, एक पासवर्ड वैकल्पिक है।
कृपया ध्यान दें कि सभी आगे की कार्रवाइयों को एक फ़ोल्डर में किया जाना चाहिए, जहां मैनिफ़ेस्ट ।json, pass.json और चित्र पहले से ही झूठ होना चाहिए।

अब आपको एक हस्ताक्षर बनाने की आवश्यकता है, जिसे हम संग्रह पर हस्ताक्षर करेंगे। सबसे पहले, पास टाइप आईडी और कुंजी को .pem के रूप में निर्यात करें।

 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out passcertificate.pem -passin pass: your_password 

और

 openssl pkcs12 -in certificates.p12 -nocerts -out passkey.pem -passin pass: -passout pass:new_password 

अब हम एक हस्ताक्षर तैयार करने के लिए तैयार हैं। चलो इसे एक कमांड बनाते हैं:

 openssl smime -binary -sign -certfile WWDR.pem -signer passcertificate.pem -inkey passkey.pem -in manifest.json -out signature -outform DER -passin pass:___ 

तो, हमारे लिए सब कुछ तैयार है, यह केवल संग्रह एकत्र करने के लिए बना हुआ है, हम इसे कमांड के साथ करते हैं:

 zip -r nameOfPass.pkpass manifest.json pass.json signature logo.png logo@2x.png logo@3x.png icon.png icon@2x.png icon@3x.png 

मैं इस तथ्य पर आपका ध्यान आकर्षित करता हूं कि सभी फाइलें जिसमें आप कार्ड (.pkpass) के लिए डेटा संग्रह शामिल करना चाहते हैं, उन्हें यहां सूचीबद्ध किया जाना चाहिए।
परिणामस्वरूप, हमें एक .pkpass फ़ाइल मिलती है जिसे कंप्यूटर पर खोला जा सकता है। हम कार्ड का एक पूर्वावलोकन देखेंगे, जिसकी उपस्थिति फ़ोन पर दिखने वाले से भिन्न हो सकती है।
यह सब थोड़ा आसान किया जा सकता है। Apple signpass यूटिलिटी ( Apple वॉलेट सैंपल signpass प्रदान करता है, जो सभी SHA गणना ( manifest.json फ़ाइल को अकेला छोड़ा जा सकता है) और हस्ताक्षर बनाने का काम करता है। इसका उपयोग करने के लिए, आपको एक प्रोजेक्ट बनाने और सभी आवश्यक संसाधनों के साथ फ़ोल्डर में signpass फ़ाइल डालने की आवश्यकता है।

सामान्य तौर पर, संरचना कुछ इस तरह दिखनी चाहिए:

अगला, कमांड निष्पादित करें:

 ./signpass -p wallet 

वॉलेट उस फ़ोल्डर का नाम है जिसमें सभी संसाधन स्थित हैं। आउटपुट वॉलेट.पक्का है। इसकी सामग्री को unletipping wallet.pkpass द्वारा देखा जा सकता है।

 unzip wallet.pkpass 

यह संभव है कि pkpass का निर्माण बैकएंड को सबमिट किया जाएगा, जिस स्थिति में यह डब्ल्यूपीडीआर डेवलपर्स को .p12 के रूप में पास टाइप आईडी के लिए प्रमाण पत्र और इसके लिए पासवर्ड को स्थानांतरित करना आवश्यक होगा।

अनुप्रयोग एकीकरण

एप्लिकेशन को वॉलेट में कार्ड जोड़ने में सक्षम होने के लिए, आपको इस सुविधा को ऐप आईडी में सक्षम करना होगा और इस सुविधा को प्रोजेक्ट में सक्षमताओं में भी सक्षम करना होगा।

वॉलेट के साथ पूर्ण सही काम के लिए यह आवश्यक है। अन्यथा, वॉलेट से कार्ड पढ़ना संभव नहीं होगा और, उदाहरण के लिए, यह समझना संभव नहीं होगा कि हमारा कार्ड जोड़ा गया है या नहीं। यह भी ध्यान रखना महत्वपूर्ण है कि पास आईडी में टीम आईडी। टीम आईडी से मेल खाना चाहिए, या आपको उन्हें मैन्युअल रूप से एंटाइटेलमेंट में जोड़ना होगा और यह स्थिति को ठीक कर सकता है, लेकिन मैंने इसकी जांच नहीं की।

एक कार्ड जोड़ना

नक्शे जोड़ना बहुत सरल है:

 guard let passPath = Bundle.main.path(forResource: "wallet", ofType: "pkpass") else { return } let error: ErrorPointer = ErrorPointer(nilLiteral: ()) guard let passData = NSData(contentsOfFile: passPath) else { return } let pass = PKPass(data: passData as Data, error: error) let passLibrary = PKPassLibrary() passLibrary.addPasses([pass]) { (status) in print(passLibrary.containsPass(pass)) } 

हालाँकि, फिर से, अधिक बार .pkpass फ़ाइल को आपके सर्वर से डाउनलोड करना होगा।
यह ध्यान देने योग्य है कि PassKit काफी पठनीय त्रुटियां पैदा करता है, जिससे आप आसानी से समझ सकते हैं कि वास्तव में क्या गलत किया गया था।

जोड़े गए कार्डों के बारे में जानकारी प्राप्त करना

वॉलेट में उपलब्ध कार्ड और आपके आवेदन से संबंधित जानकारी प्राप्त करने के लिए, आपको PKPassLibrary ऑब्जेक्ट को चालू करना होगा।

 let passLibrary = PKPassLibrary() let passes = passLibrary.passes() 

इस प्रकार, आप समझ सकते हैं कि क्या नक्शा जोड़ा गया है या नहीं, साथ ही साथ इंटरफ़ेस को अपडेट करें। इसके अलावा, PKPassLibrary के माध्यम से मैप्स को अपडेट और डिलीट किया जा सकता है। मैप्स को वेब सेवाओं के माध्यम से भी अपडेट किया जा सकता है, लेकिन इस लेख में हम इस तरह के विकल्प पर विचार नहीं करेंगे।

विशिष्टता की जांच

चूंकि आपकी सेवा में, एक नियम के रूप में, कार्ड एक खाते से जुड़ा हुआ है, आवेदन में सबसे अधिक संभावना है कि आपको किसी तरह यह निर्धारित करना होगा कि कार्ड वर्तमान उपयोगकर्ता का है या नहीं। मेरा सुझाव है कि यह serialNumber से serialNumber । उदाहरण के लिए, उपयोगकर्ता या कार्ड नंबर की serialNumber आईडी सेट करें।

परीक्षण

Apple विभिन्न प्रकारों के लिए pkpass उदाहरण प्रदान करता है, आप उन पर ध्यान केंद्रित कर सकते हैं।
सेब के बटुए के नमूने
यह देखने के लिए कि मानचित्र कैसा दिखता है, आप प्रोजेक्ट में pkpass जोड़ सकते हैं (देखें "मानचित्र जोड़ना")। जोड़ने / हटाने की प्रक्रिया पहले से ही ऊपर चर्चा की गई है, यह केवल इस बात को याद रखने के लिए बनी हुई है कि यदि पहले से वॉलेट के लिए कार्ड एक डेवलपर के खाते में बनाया गया था, तो एप्लिकेशन पहले से जोड़े गए कार्ड नहीं देखेगा, और विकास खुद दूसरे खाते (आउटसोर्सिंग कंपनियों के लिए प्रासंगिक) से किया गया था। इस मामले में, आप समस्याओं के बिना कार्ड जोड़ सकते हैं।
आप जाँच सकते हैं कि बारकोड में जानकारी किसी भी क्यूआर कोड स्कैनर का उपयोग करके सही तरीके से एनकोडेड है या नहीं। और इस स्कैनर के साथ काम की शुद्धता की जांच करना निश्चित रूप से आवश्यक है।

निष्कर्ष

लेख ने एक मानचित्र बनाने और डिजाइन करने की प्रक्रिया की जांच की, साथ ही साथ आवेदन और समस्याओं के साथ एकीकरण की प्रक्रिया उत्पन्न हो सकती है। मैंने जानबूझकर वेब सेवाओं और मानचित्र अपडेट के साथ एकीकरण के मुद्दों को संबोधित नहीं किया था, और मुझे अगले लेख में ऐसा करने की उम्मीद है।

प्रयुक्त सामग्री:

https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html
https://developer.apple.com/library/archive/documentation/UserExperience/Reference/PassKit_Bundle/Chapters/TopLevel.html#//apple_ref/doc/uid/TP40012026-CH2-SW3
https://itechroof.wordpress.com/2015/11/30/apple-wallet-part-13/
https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Updating.html

परीक्षणों के लिए डेवलपर खाते के लिए mehdzor के लिए विशेष धन्यवाद।