iOS SDK 7.0+ क्विक स्टार्ट

इस त्वरित और सरल उदाहरण का उपयोग करके Pushwoosh iOS SDK के साथ शुरुआत करें।

iOS SDK 7.0+ में नया क्या है

संस्करण 7.0 से शुरू होकर, Pushwoosh iOS SDK को पूरी तरह से मॉड्यूलर आर्किटेक्चर के साथ फिर से डिज़ाइन किया गया है। SDK अब अलग-अलग मॉड्यूल में विभाजित है: PushwooshFramework, PushwooshCore, PushwooshBridge, और PushwooshLiveActivities बुनियादी इंटीग्रेशन के लिए आवश्यक हैं, जबकि PushwooshForegroundPush, PushwooshVoIP, और PushwooshTVOS को आपकी आवश्यकताओं के आधार पर वैकल्पिक रूप से जोड़ा जा सकता है।

यह मॉड्यूलर दृष्टिकोण आपको केवल उन सुविधाओं को शामिल करने की अनुमति देता है जिनका आपका ऐप वास्तव में उपयोग करता है, जिससे अंतिम बाइनरी आकार कम होता है और बिल्ड समय में सुधार होता है। प्रत्येक मॉड्यूल को स्वतंत्र रूप से अपडेट किया जा सकता है, जिससे आपके बाकी इंटीग्रेशन को प्रभावित किए बिना नई सुविधाओं को अपनाना आसान हो जाता है।

यह रिलीज़ आसान निर्भरता प्रबंधन के लिए नेटिव Swift Package Manager समर्थन प्रस्तुत करता है, साथ ही सभी मॉड्यूल में बेहतर Swift इंटरऑपरेबिलिटी भी प्रदान करता है। दस्तावेज़ीकरण अब सीधे बाइनरी फ्रेमवर्क में एम्बेडेड है, इसलिए आप Quick Help और Developer Documentation विंडो के माध्यम से सीधे Xcode में API संदर्भ और कोड उदाहरणों तक पहुँच सकते हैं। नई सुविधाओं में Dynamic Island इंटीग्रेशन के साथ iOS 16+ Live Activities के लिए पूर्ण समर्थन, एनिमेटेड बैनर और हैप्टिक फीडबैक के साथ अनुकूलन योग्य फोरग्राउंड पुश नोटिफिकेशन, उन्नत VoIP क्षमताएं, और Apple TV एप्लिकेशन के लिए एक समर्पित tvOS मॉड्यूल शामिल हैं।

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

Pushwoosh iOS SDK को अपने ऐप में इंटीग्रेट करने के लिए, आपको निम्नलिखित की आवश्यकता होगी:

आवश्यकताएँ

• एक Pushwoosh खाता
• आपके खाते में सेटअप किया गया एक Pushwoosh प्रोजेक्ट।
• पुश नोटिफिकेशन भेजने के लिए कॉन्फ़िगर किया गया एक iOS प्लेटफ़ॉर्म। हम सबसे सरल दृष्टिकोण के रूप में टोकन-आधारित प्रमाणीकरण कॉन्फ़िगरेशन का उपयोग करने की सलाह देते हैं।
• सेटअप के दौरान, सिम्युलेटर पर पुश भेजने के लिए गेटवे को Sandbox पर सेट करें।
• आपके एप्लिकेशन के लिए Pushwoosh कंट्रोल पैनल से आपका Pushwoosh Application Code और Pushwoosh Device API Token।

उदाहरण प्रोजेक्ट डाउनलोड करें

GitHub से उदाहरण प्रोजेक्ट क्लोन करें:

git clone https://github.com/Pushwoosh/pushwoosh-ios-sample.git

प्रोजेक्ट को कॉन्फ़िगर करें

1. Xcode में प्रोजेक्ट खोलें।

2. https://github.com/Pushwoosh/Pushwoosh-XCFramework को Swift पैकेज डिपेंडेंसी के रूप में जोड़ें।

3. मुख्य टारगेट (PushwooshSampleApp) के लिए बंडल आइडेंटिफ़ायर को अपने Pushwoosh प्रोजेक्ट से मेल खाने के लिए सेट करें (जैसे, com.pushwoosh.PushwooshSampleApp)।

4. NotificationService टारगेट के लिए उसी बंडल आइडेंटिफ़ायर का उपयोग करें, जिसमें .NotificationService जोड़ा गया हो (जैसे, com.pushwoosh.PushwooshSampleApp.NotificationService)।

5. Info.plist में, सेट करें:

   • Pushwoosh_APPID की को Pushwoosh एप्लिकेशन कोड पर सेट करें
   • Pushwoosh_API_TOKEN की को Pushwoosh डिवाइस API टोकन पर सेट करें

महत्वपूर्ण: सुनिश्चित करें कि आप अपने Pushwoosh कंट्रोल पैनल में सही ऐप को टोकन एक्सेस दें। और जानें

प्रोजेक्ट चलाएँ

1. प्रोजेक्ट को बिल्ड और रन करें।
2. ऐप में दो टैब होंगे: “Actions” और “Settings”। Settings टैब पर जाएँ।
3. Register for Pushes बटन पर टैप करें।
4. पुश नोटिफिकेशन के लिए अनुमति दें। डिवाइस Pushwoosh के साथ पंजीकृत हो जाएगा।

आपको इस तरह की एक लॉग एंट्री देखनी चाहिए:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: 7.0.0
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [I] -[PWNotificationManagerCompatiOS10] NotificationCenter authorization granted: 1
[PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: __YOUR_PUSH_TOKEN__

आपका डिवाइस अब Pushwoosh के साथ पंजीकृत है।

एक पुश नोटिफिकेशन भेजें

Pushwoosh कंट्रोल पैनल पर वापस जाएँ और अपने पंजीकृत डिवाइस पर एक पुश नोटिफिकेशन भेजें।

SDK 6.x से माइग्रेट करना

यदि आप SDK संस्करण 6.x से अपग्रेड कर रहे हैं, तो मुख्य बदलाव यह है कि आप Pushwoosh इंस्टेंस तक कैसे पहुँचते हैं। संस्करण 7.0+ में, Pushwoosh.sharedInstance() के बजाय Pushwoosh.configure का उपयोग करें:

पहले (6.x):

Pushwoosh.sharedInstance().registerForPushNotifications()
Pushwoosh.sharedInstance().delegate = self

बाद में (7.0+):

Pushwoosh.configure.registerForPushNotifications()
Pushwoosh.configure.delegate = self

अन्य सभी API समान रहते हैं, इसलिए अपने कोड को अपडेट करने के लिए केवल अपने पूरे प्रोजेक्ट में sharedInstance() को configure से बदलना होगा।

आगे क्या है

अधिक जानने के लिए, कृपया बुनियादी इंटीग्रेशन गाइड देखें।