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

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

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

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

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

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

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

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

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

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

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

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

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

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

   Kotlin

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

   Java

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

क्या आपको Kotlin के लिए खास तौर पर बनी लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 में रिलीज़ होने वाले वर्शन से, Kotlin और Java के डेवलपर, दोनों ही मुख्य लाइब्रेरी मॉड्यूल पर निर्भर रह सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.

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

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

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

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

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

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

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

3. फ़ुल-स्क्रीन गतिविधि शुरू करता है. इससे टेस्टर, सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं.

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

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

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

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)
    }
}

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);
    }
}

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

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

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

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

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

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

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

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

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

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

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

6. Firebase Firebase कंसोल में, नए वर्शन के कार्ड में अपना सुझाव/राय या शिकायत देखें.

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

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

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

• Firebase कंसोल

• नए सुझाव/राय या शिकायत के लिए ईमेल अलर्ट

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

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

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

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

नए सुझाव/राय या शिकायत के लिए ईमेल अलर्ट पाना

टेस्टर के नए सुझाव/राय या शिकायत के बारे में पहले से जानने के लिए, जब कोई टेस्टर सुझाव/राय देता है या शिकायत करता है, तब ईमेल अलर्ट पाए जा सकते हैं. ईमेल अलर्ट में, टेस्टर का लिखा हुआ सुझाव/राय या शिकायत और सबमिट किए गए स्क्रीनशॉट का लिंक शामिल होता है.

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

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

ईमेल अलर्ट बंद करने के लिए, Firebase के अलर्ट पाना लेख पढ़ें.

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

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

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

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

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

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

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

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

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

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