टेस्टर से सुझाव पाना

Firebase App Distribution Android SDK टूल, बीटा रिलीज़ है. इसका मतलब है कि इस सुविधा में ऐसे बदलाव हो सकते हैं जो पुराने वर्शन के साथ काम न करें. बीटा रिलीज़ पर, किसी भी एसएलए या बंद होने की नीति लागू नहीं होती. साथ ही, हो सकता है कि इस पर सीमित या कोई सहायता न मिले.

इस गाइड में, Firebase App Distribution Android SDK टूल का इस्तेमाल करके, ऐप्लिकेशन में सुझाव/राय/शिकायत सबमिट करने की सुविधा चालू करने का तरीका बताया गया है. यह सुविधा ज़रूरी नहीं है. इससे आपके टेस्टर, ऐप्लिकेशन में सीधे सुझाव/राय/शिकायत सबमिट कर सकते हैं. इसमें स्क्रीनशॉट भी शामिल हैं.

शुरू करने से पहले

अगर आपने पहले से ही ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.

ध्यान दें: अगर आपके Firebase प्रोजेक्ट में एक से ज़्यादा ऐप्लिकेशन हैं, तो पक्का करें कि आपको App Distribution के साथ जिस ऐप्लिकेशन को डिस्ट्रिब्यूट करना है उसके पास अपनी google-services.json कॉन्फ़िगरेशन फ़ाइल हो. ज़्यादा जानकारी के लिए, एक से ज़्यादा एनवायरमेंट के साथ काम करना लेख पढ़ें.

पहला चरण: App Distribution Tester API को चालू करना

1. Google Cloud कंसोल खोलें और अपना Firebase प्रोजेक्ट चुनें.

2. Firebase App Testers API में जाकर, चालू करें पर क्लिक करें.

दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना

App Distribution Android SDK में दो लाइब्रेरी होती हैं:

• firebase-appdistribution-api: सिर्फ़ एपीआई वाली लाइब्रेरी, जिसे सभी बिल्ड वैरिएंट में शामिल किया जा सकता है.
• firebase-appdistribution: SDK टूल को पूरी तरह से लागू करना (ज़रूरी नहीं).

चेतावनी: नए बिल्ड के बारे में टेस्टर को सूचना देने जैसी सुविधाओं के साथ काम करने के लिए, App Distribution Android SDK टूल के पूरे वर्शन में अपने-आप अपडेट होने की सुविधा होती है. इसे Google Play की नीति का उल्लंघन माना जा सकता है. भले ही, वह कोड रनटाइम के दौरान लागू न किया गया हो. SDK टूल को पूरी तरह से हटाए बिना, अपने ऐप्लिकेशन को Google Play पर सबमिट करने पर, आपके ऐप्लिकेशन को Google Play से हटाया जा सकता है.

सिर्फ़ एपीआई लाइब्रेरी की मदद से, आपके कोड में एसडीके टूल को कॉल किया जा सकता है. अगर SDK टूल पूरी तरह से लागू नहीं है, तो कॉल का कोई असर नहीं पड़ता.

1. अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, App Distribution Android SDK टूल के लिए डिपेंडेंसी का एलान करें.

2. Google Play के बिल्ड में, SDK टूल को लागू करने की पूरी सुविधा को अपने-आप अपडेट होने से रोकने के लिए, बिल्ड के वैरिएंट की पहचान करें. इनमें बिल्ड टाइप या प्रॉडक्ट फ़्लेवर शामिल हैं. इन वैरिएंट को App Distribution के ज़रिए डिस्ट्रिब्यूट किया जाएगा.

3. App Distribution Android SDK टूल के लिए, अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर app/build.gradle) में डिपेंडेंसी का एलान करें. SDK टूल को सिर्फ़ उन वैरिएंट में जोड़ें जो रिलीज़ से पहले की टेस्टिंग के लिए खास तौर पर बनाए गए हैं:

   Kotlin

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta14")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14")
   }

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta14")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14")
   }

तीसरा चरण: इन-ऐप्लिकेशन सुझाव/राय/शिकायत करने की सुविधा कॉन्फ़िगर करना

टेस्टर से सुझाव, राय या शिकायत इकट्ठा करने के लिए, इनमें से किसी एक ट्रिगर का इस्तेमाल करें, ताकि टेस्टर सुझाव, राय या शिकायत दे सकें:

• बिल्ट-इन सूचना ट्रिगर: App Distribution Android SDK टूल, एक ऐसी सूचना दिखा सकता है जिस पर टेस्टर ऐप्लिकेशन में कहीं से भी टैप कर सकता है. अगर आपको तुरंत शुरू करना है और आपको यह तय नहीं करना है कि टेस्टर आपके ऐप्लिकेशन के बारे में क्या फ़ीडबैक दें, तो इस ट्रिगर का इस्तेमाल करें.

• कस्टम ट्रिगर: आपके पास ट्रिगर करने का अपना तरीका तय करने का विकल्प होता है. जैसे, अपने ऐप्लिकेशन में किसी बटन या मेन्यू आइटम पर टैप करना या डिवाइस को हिलाना.

इनमें से किसी भी ट्रिगर का इस्तेमाल करने और टेस्टर के सुझाव, शिकायत या राय सबमिट करने पर, Android SDK टूल ये कार्रवाइयां करता है:

1. ऐप्लिकेशन की मौजूदा गतिविधि का स्क्रीनशॉट लेता है.

2. यह जांच करता है कि टेस्टर ने SDK की टेस्टिंग सुविधाएं चालू की हैं या नहीं. अगर जांच करने की सुविधाएं चालू नहीं हैं, तो Android SDK टूल, टेस्टर को अपने Google खाते से App Distribution में साइन इन करने के लिए कहता है.

   ध्यान दें: टेस्टिंग की सुविधाओं को चालू करने की प्रोसेस, टेस्ट डिवाइस पर सिर्फ़ एक बार की जाती है. यह प्रोसेस, आपके ऐप्लिकेशन के सभी अपडेट में बनी रहती है. टेस्टिंग की सुविधाएं, टेस्ट डिवाइस पर तब तक चालू रहती हैं, जब तक टेस्टर ऐप्लिकेशन को अनइंस्टॉल नहीं कर देता या ऐप्लिकेशन signOutTester तरीके को कॉल नहीं करता.

3. यह एक फ़ुल-स्क्रीन गतिविधि शुरू करता है, जिसकी मदद से टेस्टर अपना सुझाव, राय या शिकायत लिखकर सबमिट कर सकता है.

पहला विकल्प: सूचना ट्रिगर करना

टेस्टर के डिवाइस पर, लगातार या चल रही सूचना दिखाने के लिए showFeedbackNotification() का इस्तेमाल करें. इस सूचना पर टैप करके, टेस्टर सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं. सूचना कॉन्फ़िगर करते समय, आपको कुछ टेक्स्ट देना होगा. यह टेक्स्ट, सुझाव/राय सबमिट करने से पहले, टेस्टर को दिखेगा. साथ ही, आपको सूचना के लिए रुकावट का लेवल भी तय करना होगा. यह लेवल, सूचना चैनल की ज़रूरत के हिसाब से तय किया जाता है. अगर आपको अपने टेस्टर को सुझाव/राय/शिकायत वाले डेटा को इकट्ठा और प्रोसेस करने के बारे में सूचना देनी है, तो इस टेक्स्ट का इस्तेमाल करके सूचना दी जा सकती है.

showFeedbackNotification() का इस्तेमाल करने पर और ऐप्लिकेशन के बैकग्राउंड में जाने पर, सूचना छिप जाती है. अगर आपको सूचना को साफ़ तौर पर छिपाना है, तो cancelFeedbackNotification() का इस्तेमाल करें. हमारा सुझाव है कि आप अपनी मुख्य गतिविधि के onCreate() में showFeedbackNotification() डालें.

Kotlin

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

ध्यान दें: Android 13 और उसके बाद के वर्शन पर, इस तरीके के लिए सूचनाएं भेजने की रनटाइम अनुमति की ज़रूरत होती है: POST_NOTIFICATIONS. अगर आपका ऐप्लिकेशन, Android 13 (एपीआई लेवल 33) या उसके बाद के वर्शन को टारगेट करता है, तो आपको अनुमति का एलान करना होगा. इसके बाद, रनटाइम पर इसका अनुरोध करना होगा.

दूसरा विकल्प: कस्टम ट्रिगर

अपनी पसंद के तरीके का इस्तेमाल करके सुझाव/राय देने या शिकायत करने के लिए, startFeedback() वाला तरीका अपनाएं. उदाहरण के लिए, सुझाव/राय/शिकायत ट्रिगर करने के लिए, अपने ऐप्लिकेशन के ऐक्शन मेन्यू में "सुझाव/राय/शिकायत भेजें" मेन्यू आइटम जोड़ा जा सकता है. इसके अलावा, टेस्टर को अपने डिवाइस को हिलाने या स्क्रीनशॉट लेने की अनुमति दी जा सकती है. सुझाव/राय या शिकायत ट्रिगर करते समय, कुछ टेक्स्ट दें. यह टेक्स्ट, सुझाव/राय या शिकायत सबमिट करने से पहले, टेस्टर को दिखेगा. अगर आपको अपने टेस्टर को उनके सुझाव/राय/शिकायत/राय देने वाले डेटा को इकट्ठा और प्रोसेस करने के बारे में सूचना देनी है, तो इस टेक्स्ट का इस्तेमाल करके ऐसी सूचना दी जा सकती है.

Kotlin

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

चौथा चरण: लागू करने की प्रोसेस को बनाना और उसकी जांच करना

स्थानीय टेस्टिंग

ऐप्लिकेशन को डिस्ट्रिब्यूट किए बिना, लागू की गई ट्रैकिंग की जांच करने के लिए, यह तरीका अपनाएं:

1. अपने लोकल डिवाइस पर डेवलपर मोड चालू करें:

   adb shell setprop debug.firebase.appdistro.devmode true

2. अपने ऐप्लिकेशन को रिलीज़ से पहले उपलब्ध कराने के लिए, एक ऐसा वैरिएंट बनाएं जिसमें सभी App Distribution लाइब्रेरी शामिल हों. साथ ही, यह जांच लें कि तीसरा चरण: ऐप्लिकेशन में सुझाव/राय/शिकायत करने की सुविधा कॉन्फ़िगर करना में लागू किए गए तरीके का इस्तेमाल करके, सुझाव/राय/शिकायत करने की सुविधा को ट्रिगर किया जा सकता है या नहीं. डेवलपर मोड में, सुझाव, शिकायत या राय सबमिट नहीं की जा सकती.

3. जांच करने के बाद, अपने डिवाइस पर डेवलपर मोड बंद किया जा सकता है:

   adb shell setprop debug.firebase.appdistro.devmode false

शुरू से आखिर तक की जांच

ध्यान दें: डिफ़ॉल्ट रूप से, नया सुझाव या राय सबमिट करने पर, सभी Firebase प्रोजेक्ट के मालिकों और एडिटर को ईमेल और कंसोल में चेतावनियां भेजी जाती हैं.

यह जांचने के लिए कि आपका ऐप्लिकेशन सुझाव, राय या शिकायत भेज सकता है या नहीं, अपने ऐप्लिकेशन को रिलीज़ से पहले के वर्शन के तौर पर बनाएं. इसमें पूरी App Distribution लाइब्रेरी शामिल होनी चाहिए. साथ ही, इस तरीके का इस्तेमाल करके, लागू करने की प्रक्रिया की जांच करें:

1. App Distribution पर ऐप्लिकेशन का नया वर्शन अपलोड करें.

2. ऐप्लिकेशन रिलीज़ को उस खाते पर डिस्ट्रिब्यूट करें जिसका ऐक्सेस आपके पास है.

3. App Distribution की वेबसाइट या Android टेस्टर ऐप्लिकेशन से ऐप्लिकेशन डाउनलोड करें.

4. तीसरा चरण: ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा कॉन्फ़िगर करना में बताए गए तरीके का इस्तेमाल करके, सुझाव/राय दें या शिकायत करें.

5. पक्का करें कि आपने उसी खाते से साइन इन किया हो जिससे आपने ऐप्लिकेशन रिलीज़ को डिस्ट्रिब्यूट किया था. इसके बाद, सुझाव/राय सबमिट करें.

6. Firebase कंसोल में, नई रिलीज़ के कार्ड में अपना सुझाव या राय देखें.

चेतावनी: अपने ऐप्लिकेशन को Google Play Store पर रिलीज़ करने से पहले, ज़रूर जांच लें कि आपने सिर्फ़ एपीआई-लाइवरी डिपेंडेंसी शामिल की है. साथ ही, यह भी देख लें कि आपके रिलीज़ वैरिएंट में सुझाव/राय देने की सुविधा शामिल न हो. ज़्यादा जानकारी के लिए, दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना देखें.

सामान्य समस्याओं को हल करने का तरीका जानने के लिए, SDK टूल की मदद से टेस्टिंग की सुविधाएं चालू करना लेख पढ़ें. जैसे, टेस्टर ऐप्लिकेशन में सुझाव/राय/शिकायत सबमिट नहीं कर पा रहे हैं.

पांचवां चरण: टेस्टर के सुझाव, राय या शिकायत मैनेज करना

टेस्टर को सुझाव/राय/शिकायत भेजने की सुविधा देने के बाद, सुझाव/राय/शिकायत की समीक्षा करने और उस पर कार्रवाई करने के लिए, इन टूल का इस्तेमाल किया जा सकता है:

• Firebase कंसोल

• नए सुझाव, शिकायत या राय मिलने पर ईमेल से सूचनाएं पाना

• तीसरे पक्ष के टूल

Firebase कंसोल में सुझाव/राय/शिकायत देखना और मिटाना

Firebase कंसोल में किसी रिलीज़ के नीचे मौजूद टेस्टर का सुझाव, शिकायत या राय टैब खोलकर, उपयोगकर्ता के सुझाव, शिकायत या राय की समीक्षा की जा सकती है. साथ ही, उन्हें मिटाया भी जा सकता है. इसमें स्क्रीनशॉट भी शामिल हैं. उपयोगकर्ता के सुझाव, शिकायत या राय को रिलीज़ के हिसाब से व्यवस्थित किया जाता है, ताकि आप यह पुष्टि कर सकें कि सुझाव, शिकायत या राय किस वर्शन पर लागू होती है.

उपयोगकर्ता के सुझाव/राय/शिकायत की समीक्षा करने के बाद, उसे मिटाया जा सकता है. इसके लिए, सुझाव/राय/शिकायत मिटाएं बटन पर क्लिक करें. मिटाए गए फ़ीडबैक को आपकी रिलीज़ से हटा दिया जाता है.

नए सुझाव, शिकायत या राय मिलने पर ईमेल से सूचनाएं पाना

टेस्टर के नए सुझाव या राय के बारे में तुरंत जानने के लिए, टेस्टर के सुझाव या राय सबमिट करने पर आपको ईमेल सूचनाएं मिल सकती हैं. ईमेल सूचना में, आपके टेस्टर का लिखित सुझाव या राय शामिल होती है. साथ ही, उसमें सबमिट किए गए स्क्रीनशॉट का लिंक भी होता है.

इस डिफ़ॉल्ट तरीके से App Distribution ईमेल सूचनाएं पाने के लिए, आपके पास firebase.projects.update अनुमति होनी चाहिए. यहां दी गई भूमिकाओं में, यह ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है: Firebase एडमिन या प्रोजेक्ट का मालिक या एडिटर.

डिफ़ॉल्ट रूप से, प्रोजेक्ट के जिस सदस्य के पास ईमेल सूचनाएं पाने की ज़रूरी अनुमतियां हैं उसे नई फ़ीडबैक रिपोर्ट सबमिट करने पर एक ईमेल मिलेगा. प्रोजेक्ट के सदस्य, इन सूचनाओं से अलग-अलग ऑप्ट आउट कर सकते हैं.

ईमेल सूचनाएं बंद करने के लिए, Firebase से सूचनाएं पाना लेख पढ़ें.

तीसरे पक्ष के टूल के लिए नया सुझाव, शिकायत या राय भेजना

Cloud Functions for Firebase का इस्तेमाल करके, अपनी टीम के पसंदीदा सूचना चैनल पर भी App Distribution सूचनाएं भेजी जा सकती हैं. उदाहरण के लिए, ऐसा फ़ंक्शन लिखा जा सकता है जो ऐप्लिकेशन में दिए गए नए सुझाव, शिकायत या राय के लिए सूचना वाले इवेंट को कैप्चर करता है. साथ ही, सूचना की जानकारी को Discord, Slack या Jira जैसी तीसरे पक्ष की सेवा पर पोस्ट करता है.

ध्यान दें: सूचना से जुड़ी बेहतर सुविधाओं का इस्तेमाल करने के लिए, आपके Firebase प्रोजेक्ट में Blaze की कीमत वाला प्लान होना चाहिए.

Cloud Functions for Firebase का इस्तेमाल करके, सूचना देने की बेहतर सुविधाएं सेट अप करने के लिए, यह तरीका अपनाएं:

1. Cloud Functions for Firebase सेट अप करना. इसमें ये काम शामिल हैं:

   1. Node.js और npm डाउनलोड करें.

   2. Firebase सीएलआई इंस्टॉल करें और उसमें साइन इन करें.

   3. Firebase सीएलआई का इस्तेमाल करके, Cloud Functions for Firebase को शुरू करें.

2. App Distribution से, ऐप्लिकेशन में शिकायत या सुझाव से जुड़ी सूचना वाले इवेंट को कैप्चर करने और इवेंट के पेलोड को मैनेज करने वाला फ़ंक्शन लिखें और डिप्लॉय करें. उदाहरण के लिए, Discord पर मैसेज में सूचना की जानकारी पोस्ट करना.

Jira में नया सुझाव, शिकायत या राय भेजने का तरीका बताने वाला फ़ंक्शन देखने के लिए, यह सैंपल देखें.

कैप्चर किए जा सकने वाले सभी अलर्ट इवेंट के बारे में जानने के लिए, App Distribution अलर्ट के लिए रेफ़रंस दस्तावेज़ देखें.