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

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

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

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

    Kotlin 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta19")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta19")
}

    Java 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta19")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta19")
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अपनी पसंद के किसी मैकेनिज़्म का इस्तेमाल करके, सुझाव देने की सुविधा शुरू करने के लिए, 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

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

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

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

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

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

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

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

  6. Firebase console में, नए वर्शन के कार्ड में अपना सुझाव देखें.

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

पांचवा चरण: टेस्टर के सुझाव मैनेज करना

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

Firebase console में सुझाव देखना और मिटाना

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

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

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

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

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

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

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

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

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

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

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

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

    2. Firebase CLI इंस्टॉल करें और इसमें साइन इन करें.

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

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

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

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