टेस्ट पुश डिवाइस जोड़ें

आप ऐप उपयोगकर्ताओं को पुश नोटिफिकेशन भेजने से पहले यह देखने के लिए टेस्ट डिवाइस का उपयोग कर सकते हैं कि वे डिवाइस पर कैसे दिखते हैं। ऐसा करने के लिए, आपको अपने डिवाइस (जिसमें आपका ऐप इंस्टॉल है) को एक टेस्ट डिवाइस के रूप में रजिस्टर करना होगा।

नोट

यह गाइड पुश टेस्ट डिवाइस को कवर करती है। ईमेल और SMS टेस्ट डिवाइस के लिए किसी भी ऐप-साइड इंटीग्रेशन की आवश्यकता नहीं है — उत्पाद डॉक्स में टेस्ट ईमेल डिवाइस और टेस्ट SMS डिवाइस देखें।

एक टेस्ट डिवाइस जोड़ने के लिए:

1. अपने Pushwoosh अकाउंट में टेस्ट डिवाइस सेक्शन पर नेविगेट करें।

2. ऊपरी-दाएँ कोने में टेस्ट डिवाइस बनाएँ ड्रॉपडाउन बटन पर क्लिक करें और पुश चुनें।

आप तीन तरीकों में से किसी एक का उपयोग करके एक पुश टेस्ट डिवाइस जोड़ सकते हैं: QR कोड के साथ ऑटो-कॉन्फ़िगरेशन, ऐप से पंजीकरण, या मैन्युअल कॉन्फ़िगरेशन।

टेस्ट डिवाइस को स्वचालित रूप से जोड़ना

यह विधि केवल iOS और Android डिवाइस के लिए उपयुक्त है।

अपने पहले पंजीकरण से पहले, ऐप में टेस्ट डिवाइस के लिए डीप लिंक हैंडलिंग जोड़ें — यह एक बार का सेटअप है, जो आमतौर पर Pushwoosh SDK इंटीग्रेशन के साथ किया जाता है:

• Android के लिए: AndroidManifest.xml फ़ाइल में DeepLinkActivity जोड़ें।
• iOS के लिए: Info.plist फ़ाइल में pushwoosh-YOUR_PUSHWOOSH_APP_ID URL स्कीम जोड़ें।

कार्यान्वयन सेक्शन में Android और iOS के लिए दिए गए निर्देशों का पालन करें।

एक बार यह हो जाने के बाद, एक डिवाइस को रजिस्टर करने के लिए:

1. टेस्ट डिवाइस सेक्शन में, टेस्ट डिवाइस बनाएँ पर क्लिक करें और पुश चुनें।
2. पॉपअप में दिखाई देने वाले QR कोड को किसी भी QR स्कैनर ऐप से स्कैन करें। यह डीप लिंक खोलता है जिसे Pushwoosh SDK आपके डिवाइस को एक टेस्ट डिवाइस के रूप में रजिस्टर करने के लिए पार्स करता है।

QR रीडर्स के लिए टिप

सुनिश्चित करें कि स्कैन किया गया लिंक नेटिव ब्राउज़र में खुलता है, न कि QR रीडर के वेबव्यू में। कई QR रीडर्स में इस उद्देश्य के लिए “ब्राउज़र में खोलें” बटन होता है।

ऐप से एक टेस्ट डिवाइस रजिस्टर करना

ऊपर दिए गए QR कोड विधि से स्वतंत्र, Pushwoosh SDK वर्तमान डिवाइस को अपने आप एक टेस्ट डिवाइस के रूप में रजिस्टर कर सकता है: ऐप को बैकग्राउंड में भेजकर और 30 सेकंड के भीतर 6 बार फोरग्राउंड में वापस लाकर। किसी स्कैनिंग या मैन्युअल एंट्री की आवश्यकता नहीं है।

अनजाने पंजीकरण को रोकने के लिए, यह केवल तब काम करता है जब 1 घंटे की पंजीकरण विंडो खुली हो।

1. टेस्ट डिवाइस सेक्शन में, ऐप से टेस्ट डिवाइस जोड़ें टॉगल को चालू करें। यह 1 घंटे के लिए विंडो खोलता है।

सावधानी

टॉगल को चालू करने के लिए एप्लिकेशन को संशोधित करने की अनुमति की आवश्यकता होती है; इसके बिना, अनुरोध “उपयोगकर्ता एप्लिकेशन को संशोधित नहीं कर सकता” त्रुटि के साथ विफल हो जाता है। विंडो 1 घंटे के लिए खुली रहती है और फिर स्वचालित रूप से बंद हो जाती है; जब यह बंद होती है, तो ऐप का पंजीकरण कॉल अभी भी सफलता लौटाता है, लेकिन कोई डिवाइस पंजीकृत नहीं होता है।

2. जब विंडो खुली हो, तो ऐप को 30 सेकंड के भीतर 6 बार बैकग्राउंड और फोरग्राउंड करें। डिवाइस टेस्ट डिवाइस सूची में जुड़ जाता है।

टेस्ट डिवाइस को मैन्युअल रूप से जोड़ना

यदि आप एक टेस्ट डिवाइस को मैन्युअल रूप से रजिस्टर करना पसंद करते हैं, तो इन चरणों का पालन करें:

1. एक सफल /registerDevice API कॉल से डिवाइस का हार्डवेयर आईडी (HWID) प्राप्त करें।
2. आवश्यक फ़ील्ड भरें:
   • डिवाइस का नाम: टेस्ट डिवाइस के लिए एक वर्णनात्मक नाम (जैसे, “जॉन का एंड्रॉइड”)।
   • डिवाइस HWID: डिवाइस का अद्वितीय हार्डवेयर आईडी।
   • डिवाइस का प्रकार: प्लेटफ़ॉर्म चुनें (जैसे, iOS, Android, Web)।
   • विवरण (वैकल्पिक): संदर्भ के लिए डिवाइस के बारे में कोई भी नोट्स या विवरण जोड़ें।
3. टेस्ट डिवाइस को रजिस्टर करने के लिए सहेजें पर क्लिक करें।

एक बार पंजीकृत होने के बाद, टेस्ट डिवाइस टेस्ट डिवाइस सेक्शन में उपलब्ध होगा।

API के माध्यम से टेस्ट डिवाइस रजिस्टर करना

मैन्युअल फ़ॉर्म के बजाय एक स्क्रिप्ट या CI पाइपलाइन से टेस्ट डिवाइस को प्रोविज़न करने के लिए, डिवाइस के पुश टोकन के साथ createTestDevice को कॉल करें — न कि मैन्युअल फ़ॉर्म में उपयोग किए गए HWID, एक अलग पहचानकर्ता जो उसी तरह प्राप्त किया गया हो, जैसे एक सफल /registerDevice कॉल से। listTestDevices यह लौटाता है कि एक एप्लिकेशन के लिए पहले से क्या पंजीकृत है।

कार्यान्वयन

Android

1. अपनी एप्लिकेशन के साथ Pushwoosh SDK को इंटीग्रेट करें।

2. अपने AndroidManifest.xml में DeepLinkActivity जोड़ें:

<activity
          android:name="com.pushwoosh.DeepLinkActivity"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" >
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="pushwoosh-YOUR_PUSHWOOSH_APP_ID" />
  </intent-filter>
</activity>

ऊपर दिए गए xml में YOUR_PUSHWOOSH_APP_ID को अपने Pushwoosh ऐप आईडी से बदलना न भूलें।
उदाहरण: <data android:scheme=“pushwoosh-ABCDE-EDCBA” />

3. पुश नोटिफिकेशन के लिए सब्सक्राइब करने के लिए एप्लिकेशन लॉन्च करें।

4. टेस्ट डिवाइस फ़ॉर्म में QR कोड को किसी भी उपयुक्त QR कोड स्कैनर ऐप* का उपयोग करके स्कैन करें। एक टोस्ट संदेश दिखाई देगा जो टेस्ट डिवाइस पंजीकरण की स्थिति को इंगित करेगा।

* अधिकांश QR कोड स्कैनिंग ऐप्स ऐसे डीप लिंक को ठीक से संभालते हैं, यहाँ उनमें से कुछ हैं:

• QR & Barcode Scanner, Gamma Play
• QR & Barcode Scanner, Maker, AppSourceHub

iOS

1. अपनी एप्लिकेशन के साथ Pushwoosh SDK को इंटीग्रेट करें।

2. Info.plist फ़ाइल में pushwoosh-YOUR_PUSHWOOSH_APP_ID URL स्कीम जोड़ें:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>com.pushwoosh.scheme</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>pushwoosh-YOUR_PUSHWOOSH_APP_ID</string>
    </array>
  </dict>
</array>

ऊपर दिए गए XML में YOUR_PUSHWOOSH_APP_ID को अपने Pushwoosh ऐप आईडी से बदलना न भूलें।
उदाहरण: pushwoosh-ABCDE-EDCBA

सावधानी

यदि आपका प्रोजेक्ट SwiftUI (केवल) के साथ बनाया गया है, तो आपको एक SceneDelegate जोड़ना होगा

SwiftUI ऐप जीवनचक्र को UIKit से अलग तरीके से प्रबंधित करता है। यह सुनिश्चित करने के लिए कि कुछ सिस्टम इवेंट सही ढंग से काम करते हैं — जैसे पुश नोटिफिकेशन के लिए एक टेस्ट डिवाइस को पंजीकृत करना या डीप लिंक को संभालना — आपको स्पष्ट रूप से एक SceneDelegate जोड़ना और पंजीकृत करना होगा।

इसके बिना, ये इवेंट ठीक से ट्रिगर नहीं हो सकते हैं, और पुश पंजीकरण विफल हो सकता है।

यदि आप SwiftUI का उपयोग नहीं कर रहे हैं, तो आप इस चरण को छोड़ सकते हैं और सीधे चरण 3 पर जा सकते हैं।

Info.plist

अपने Info.plist में UIApplicationSceneManifest जोड़ें।

  <key>UIApplicationSceneManifest</key>
  <dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
      <key>UIWindowSceneSessionRoleApplication</key>
      <array>
        <dict>
          <key>UISceneConfigurationName</key>
          <string></string>
          <key>UISceneDelegateClassName</key>
          <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
        </dict>
      </array>
    </dict>
  </dict>

SceneDelegate

नीचे दिए गए उदाहरण में दिखाए अनुसार SceneDelegate कोड जोड़ें।

import SwiftUI

@main
struct DemoApp: App {
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
      WindowGroup {
          ContentView()
      }
  }
}

class SceneDelegate: NSObject, UIWindowSceneDelegate {

  var window: UIWindow?

  func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
      guard let _ = (scene as? UIWindowScene) else { return }
  }
}

class AppDelegate: NSObject, UIApplicationDelegate, PWMessagingDelegate {

  func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
      let sceneConfig: UISceneConfiguration = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role)
      sceneConfig.delegateClass = SceneDelegate.self
      return sceneConfig
  }

}

3. पुश नोटिफिकेशन के लिए सब्सक्राइब करने के लिए एप्लिकेशन लॉन्च करें।

4. टेस्ट डिवाइस फ़ॉर्म में QR कोड को किसी भी उपयुक्त QR कोड स्कैनर का उपयोग करके स्कैन करें।