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

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

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

वेब कंटेनर इंस्टॉल करने से पहले

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

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

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

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

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

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

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

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

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

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

   Kotlin+KTX

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

   Java

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

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

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

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

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

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

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

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

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

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

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

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

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

Kotlin+KTX

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+KTX

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 से जुड़ी सूचनाएं पाएं पर जाएं.

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

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

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

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

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

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

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

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

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

उदाहरण के तौर पर दिए गए किसी फ़ंक्शन को देखने के लिए, यह सैंपल देखें.

कैप्चर किए जा सकने वाले सभी सूचना इवेंट के बारे में जानने के लिए, ऐप्लिकेशन डिस्ट्रिब्यूशन से जुड़ी चेतावनियों का रेफ़रंस दस्तावेज़ देखें.