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

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

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

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

पहला चरण: 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 टूल को पूरी तरह लागू करना (ज़रूरी नहीं).

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

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

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

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

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

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

अपने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

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

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

  1. App Distribution पर नई ऐप्लिकेशन रिलीज़ अपलोड करें.

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

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

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

  5. पक्का करें कि आपने उसी खाते से साइन इन किया है जिसमें आपने और सुझाव, शिकायत या राय सबमिट करें.

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

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

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

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

Firebase कंसोल में सुझाव देखें और मिटाएं

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

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

नए सुझाव के लिए ईमेल सूचनाएं पाएं

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

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

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

ईमेल सूचनाएं बंद करने के लिए, Firebase से जुड़ी सूचनाएं पाएं पर जाएं.

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

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

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

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

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

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

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

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

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

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