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

इस गाइड में, 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-ktx:16.0.0-beta15")

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

    Java 

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

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

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

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

  • सूचना ट्रिगर: 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 कंसोल में, नए वर्शन के कार्ड में अपना सुझाव देखें.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 CLI इंस्टॉल करना और उसमें साइन इन करना.

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

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

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

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