इस गाइड में, Firebase App Distribution Android SDK टूल का इस्तेमाल करके, ऐप्लिकेशन में सुझाव/राय/शिकायत सबमिट करने की सुविधा चालू करने का तरीका बताया गया है. यह सुविधा ज़रूरी नहीं है. इससे आपके टेस्टर, ऐप्लिकेशन में सीधे सुझाव/राय/शिकायत सबमिट कर सकते हैं. इसमें स्क्रीनशॉट भी शामिल हैं.
शुरू करने से पहले
अगर आपने पहले से ही ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.
पहला चरण: App Distribution Tester API को चालू करना
Google Cloud कंसोल खोलें और अपना Firebase प्रोजेक्ट चुनें.
Firebase App Testers API में जाकर, चालू करें पर क्लिक करें.
दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना
App Distribution Android SDK में दो लाइब्रेरी होती हैं:
firebase-appdistribution-api
: सिर्फ़ एपीआई वाली लाइब्रेरी, जिसे सभी बिल्ड वैरिएंट में शामिल किया जा सकता है.firebase-appdistribution
: SDK टूल को पूरी तरह से लागू करना (ज़रूरी नहीं).
सिर्फ़ एपीआई लाइब्रेरी की मदद से, आपके कोड में एसडीके टूल को कॉल किया जा सकता है. अगर SDK टूल पूरी तरह से लागू नहीं है, तो कॉल का कोई असर नहीं पड़ता.
अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर
<project>/<app-module>/build.gradle.kts
या<project>/<app-module>/build.gradle
) में, App Distribution Android SDK टूल के लिए डिपेंडेंसी का एलान करें.Google Play के बिल्ड में, SDK टूल को लागू करने की पूरी सुविधा को अपने-आप अपडेट होने से रोकने के लिए, बिल्ड के वैरिएंट की पहचान करें. इनमें बिल्ड टाइप या प्रॉडक्ट फ़्लेवर शामिल हैं. इन वैरिएंट को App Distribution के ज़रिए डिस्ट्रिब्यूट किया जाएगा.
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-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }
Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }
तीसरा चरण: इन-ऐप्लिकेशन सुझाव/राय/शिकायत करने की सुविधा कॉन्फ़िगर करना
टेस्टर से सुझाव, राय या शिकायत इकट्ठा करने के लिए, इनमें से किसी एक ट्रिगर का इस्तेमाल करें, ताकि टेस्टर सुझाव, राय या शिकायत दे सकें:
बिल्ट-इन सूचना ट्रिगर: App Distribution Android SDK टूल, एक ऐसी सूचना दिखा सकता है जिस पर टेस्टर ऐप्लिकेशन में कहीं से भी टैप कर सकता है. अगर आपको तुरंत शुरू करना है और आपको यह तय नहीं करना है कि टेस्टर आपके ऐप्लिकेशन के बारे में क्या फ़ीडबैक दें, तो इस ट्रिगर का इस्तेमाल करें.
कस्टम ट्रिगर: आपके पास ट्रिगर करने का अपना तरीका तय करने का विकल्प होता है. जैसे, अपने ऐप्लिकेशन में किसी बटन या मेन्यू आइटम पर टैप करना या डिवाइस को हिलाना.
इनमें से किसी भी ट्रिगर का इस्तेमाल करने और टेस्टर के सुझाव, शिकायत या राय सबमिट करने पर, Android SDK टूल ये कार्रवाइयां करता है:
ऐप्लिकेशन की मौजूदा गतिविधि का स्क्रीनशॉट लेता है.
यह जांच करता है कि टेस्टर ने SDK की टेस्टिंग सुविधाएं चालू की हैं या नहीं. अगर जांच करने की सुविधाएं चालू नहीं हैं, तो Android SDK टूल, टेस्टर को अपने Google खाते से App Distribution में साइन इन करने के लिए कहता है.
यह एक फ़ुल-स्क्रीन गतिविधि शुरू करता है, जिसकी मदद से टेस्टर अपना सुझाव, राय या शिकायत लिखकर सबमिट कर सकता है.
पहला विकल्प: सूचना ट्रिगर करना
टेस्टर के डिवाइस पर, लगातार या चल रही सूचना दिखाने के लिए showFeedbackNotification()
का इस्तेमाल करें. इस सूचना पर टैप करके, टेस्टर सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं.
सूचना कॉन्फ़िगर करते समय, आपको कुछ टेक्स्ट देना होगा. यह टेक्स्ट, सुझाव/राय सबमिट करने से पहले, टेस्टर को दिखेगा. साथ ही, आपको सूचना के लिए रुकावट का लेवल भी तय करना होगा. यह लेवल, सूचना चैनल की ज़रूरत के हिसाब से तय किया जाता है. अगर आपको अपने टेस्टर को सुझाव/राय/शिकायत वाले डेटा को इकट्ठा और प्रोसेस करने के बारे में सूचना देनी है, तो इस टेक्स्ट का इस्तेमाल करके सूचना दी जा सकती है.
showFeedbackNotification()
का इस्तेमाल करने पर और ऐप्लिकेशन के बैकग्राउंड में जाने पर, सूचना छिप जाती है. अगर आपको सूचना को साफ़ तौर पर छिपाना है, तो cancelFeedbackNotification()
का इस्तेमाल करें. हमारा सुझाव है कि आप अपनी मुख्य गतिविधि के onCreate()
में showFeedbackNotification()
डालें.
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);
चौथा चरण: लागू करने की प्रोसेस को बनाना और उसकी जांच करना
स्थानीय टेस्टिंग
ऐप्लिकेशन को डिस्ट्रिब्यूट किए बिना, लागू की गई ट्रैकिंग की जांच करने के लिए, यह तरीका अपनाएं:
अपने लोकल डिवाइस पर डेवलपर मोड चालू करें:
adb shell setprop debug.firebase.appdistro.devmode true
अपने ऐप्लिकेशन को रिलीज़ से पहले उपलब्ध कराने के लिए, एक ऐसा वैरिएंट बनाएं जिसमें सभी App Distribution लाइब्रेरी शामिल हों. साथ ही, यह जांच लें कि तीसरा चरण: ऐप्लिकेशन में सुझाव/राय/शिकायत करने की सुविधा कॉन्फ़िगर करना में लागू किए गए तरीके का इस्तेमाल करके, सुझाव/राय/शिकायत करने की सुविधा को ट्रिगर किया जा सकता है या नहीं. डेवलपर मोड में, सुझाव, शिकायत या राय सबमिट नहीं की जा सकती.
जांच करने के बाद, अपने डिवाइस पर डेवलपर मोड बंद किया जा सकता है:
adb shell setprop debug.firebase.appdistro.devmode false
शुरू से आखिर तक की जांच
यह जांचने के लिए कि आपका ऐप्लिकेशन सुझाव, राय या शिकायत भेज सकता है या नहीं, अपने ऐप्लिकेशन को रिलीज़ से पहले के वर्शन के तौर पर बनाएं. इसमें पूरी App Distribution लाइब्रेरी शामिल होनी चाहिए. साथ ही, इस तरीके का इस्तेमाल करके, लागू करने की प्रक्रिया की जांच करें:
App Distribution पर ऐप्लिकेशन का नया वर्शन अपलोड करें.
ऐप्लिकेशन रिलीज़ को उस खाते पर डिस्ट्रिब्यूट करें जिसका ऐक्सेस आपके पास है.
App Distribution की वेबसाइट या Android टेस्टर ऐप्लिकेशन से ऐप्लिकेशन डाउनलोड करें.
तीसरा चरण: ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने की सुविधा कॉन्फ़िगर करना में बताए गए तरीके का इस्तेमाल करके, सुझाव/राय दें या शिकायत करें.
पक्का करें कि आपने उसी खाते से साइन इन किया हो जिससे आपने ऐप्लिकेशन रिलीज़ को डिस्ट्रिब्यूट किया था. इसके बाद, सुझाव/राय सबमिट करें.
Firebase कंसोल में, नई रिलीज़ के कार्ड में अपना सुझाव या राय देखें.
सामान्य समस्याओं को हल करने का तरीका जानने के लिए, SDK टूल की मदद से टेस्टिंग की सुविधाएं चालू करना लेख पढ़ें. जैसे, टेस्टर ऐप्लिकेशन में सुझाव/राय/शिकायत सबमिट नहीं कर पा रहे हैं.
पांचवां चरण: टेस्टर के सुझाव, राय या शिकायत मैनेज करना
टेस्टर को सुझाव/राय/शिकायत भेजने की अनुमति देने के बाद, सुझाव/राय/शिकायत की समीक्षा करने और उस पर कार्रवाई करने के लिए, इन टूल का इस्तेमाल किया जा सकता है:
Firebase कंसोल में सुझाव/राय/शिकायत देखना और मिटाना
Firebase कंसोल में किसी रिलीज़ के नीचे मौजूद टेस्टर का सुझाव, शिकायत या राय टैब खोलकर, उपयोगकर्ता के सुझाव, शिकायत या राय की समीक्षा की जा सकती है. साथ ही, उन्हें मिटाया भी जा सकता है. इसमें स्क्रीनशॉट भी शामिल हैं. उपयोगकर्ता के सुझाव, शिकायत या राय को रिलीज़ के हिसाब से व्यवस्थित किया जाता है, ताकि आप यह पुष्टि कर सकें कि सुझाव, शिकायत या राय किस वर्शन पर लागू होती है.
उपयोगकर्ता के सुझाव/राय/शिकायत की समीक्षा करने के बाद, उसे मिटाया जा सकता है. इसके लिए, सुझाव/राय/शिकायत मिटाएं बटन पर क्लिक करें. मिटाए गए फ़ीडबैक को आपकी रिलीज़ से हटा दिया जाता है.
नए सुझाव, शिकायत या राय मिलने पर ईमेल से सूचनाएं पाना
टेस्टर के नए सुझाव या राय के बारे में तुरंत जानने के लिए, टेस्टर के सुझाव या राय सबमिट करने पर आपको ईमेल सूचनाएं मिल सकती हैं. ईमेल सूचना में, आपके टेस्टर का लिखित सुझाव या राय शामिल होती है. साथ ही, उसमें सबमिट किए गए स्क्रीनशॉट का लिंक भी होता है.
इस डिफ़ॉल्ट तरीके से App Distribution ईमेल सूचनाएं पाने के लिए, आपके पास firebase.projects.update
अनुमति होनी चाहिए. यहां दी गई भूमिकाओं में, यह ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है: Firebase एडमिन या प्रोजेक्ट का मालिक या एडिटर.
डिफ़ॉल्ट रूप से, प्रोजेक्ट के हर उस सदस्य को ईमेल से सूचनाएं पाने की अनुमति होती है जिसे सुझाव/राय/शिकायत सबमिट करने की अनुमति होती है. जब कोई नई सुझाव/राय/शिकायत सबमिट की जाती है, तो उसे ईमेल से सूचना दी जाती है. प्रोजेक्ट के सदस्य, इन सूचनाओं से अलग-अलग ऑप्ट आउट कर सकते हैं.
ईमेल सूचनाएं बंद करने के लिए, Firebase से सूचनाएं पाना लेख पढ़ें.
तीसरे पक्ष के टूल के लिए नया सुझाव, शिकायत या राय भेजना
Cloud Functions for Firebase का इस्तेमाल करके, अपनी टीम के पसंदीदा सूचना चैनल पर भी App Distribution सूचनाएं भेजी जा सकती हैं. उदाहरण के लिए, ऐसा फ़ंक्शन लिखा जा सकता है जो ऐप्लिकेशन में दिए गए नए सुझाव, शिकायत या राय के लिए सूचना वाले इवेंट को कैप्चर करता है. साथ ही, सूचना की जानकारी को Discord, Slack या Jira जैसी तीसरे पक्ष की सेवा पर पोस्ट करता है.
Cloud Functions for Firebase का इस्तेमाल करके, सूचना देने की बेहतर सुविधाएं सेट अप करने के लिए, यह तरीका अपनाएं:
Cloud Functions for Firebase सेट अप करना. इसमें ये काम शामिल हैं:
Node.js और npm डाउनलोड करें.
Firebase सीएलआई इंस्टॉल करें और उसमें साइन इन करें.
Firebase सीएलआई का इस्तेमाल करके, Cloud Functions for Firebase को शुरू करें.
App Distribution से, ऐप्लिकेशन में शिकायत या सुझाव से जुड़ी सूचना वाले इवेंट को कैप्चर करने और इवेंट के पेलोड को मैनेज करने वाला फ़ंक्शन लिखें और डिप्लॉय करें. उदाहरण के लिए, Discord पर मैसेज में सूचना की जानकारी पोस्ट करना.
Jira में नया सुझाव, शिकायत या राय भेजने का तरीका बताने वाले फ़ंक्शन का उदाहरण देखने के लिए, यह सैंपल देखें.
कैप्चर किए जा सकने वाले सभी अलर्ट इवेंट के बारे में जानने के लिए, App Distribution अलर्ट के लिए रेफ़रंस दस्तावेज़ देखें.