इस गाइड में यह बताया गया है कि Firebase App Distribution Android SDK टूल, ताकि आपके टेस्टर सुझाव सबमिट कर सकें (स्क्रीनशॉट शामिल करें) सीधे ऐप्लिकेशन में.
शुरू करने से पहले
अगर आपने पहले से Firebase को नहीं जोड़ा है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.
पहला चरण: App Distribution टेस्टर एपीआई को चालू करना
Google Cloud कंसोल खोलें और अपना Firebase प्रोजेक्ट चुनें.
Firebase App Testers API में, चालू करें पर क्लिक करें.
दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना
App Distribution के Android SDK टूल में दो लाइब्रेरी होती हैं:
firebase-appdistribution-api
: सिर्फ़ एपीआई वाली लाइब्रेरी, जिसे आप शामिल कर सकते हैं सभी बिल्ड वैरिएंट में.firebase-appdistribution
: SDK टूल को पूरी तरह लागू करना (ज़रूरी नहीं).
सिर्फ़ एपीआई लाइब्रेरी की मदद से, आपका कोड SDK टूल को कॉल कर सकता है. कॉल में SDK टूल को पूरी तरह से लागू न करने पर, कोई असर नहीं पड़ता.
अपने डिवाइस में App Distribution Android SDK के लिए डिपेंडेंसी का एलान करें मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर
<project>/<app-module>/build.gradle.kts
या<project>/<app-module>/build.gradle
) के साथ काम करता है.SDK टूल लागू करने की प्रोसेस में, अपने-आप अपडेट होने की सुविधा को शामिल करने से बचने के लिए अपने Google Play बिल्ड में, बिल्ड के वैरिएंट की पहचान करें, जिनमें ये शामिल हैं बिल्ड टाइप या प्रॉडक्ट के फ़्लेवर जिसे 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-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 टूल ये कार्रवाइयां करता है:
ऐप्लिकेशन की मौजूदा गतिविधि का स्क्रीनशॉट कैप्चर करता है.
यह जांच करता है कि क्या टेस्टर ने SDK टूल की टेस्टिंग सुविधाएं चालू की हैं. अगर टेस्टिंग से जुड़ी सुविधाएं चालू नहीं हैं. Android SDK, टेस्टर से साइन करने का अनुरोध करता है App Distribution में उनके Google खाते का इस्तेमाल करके साइन इन किया है.
एक फ़ुल-स्क्रीन गतिविधि शुरू करती है. इससे टेस्टर अपने डिवाइस की जानकारी में बदलाव कर सकता है और उसे सबमिट कर सकता है सुझाव/राय दें या शिकायत करें.
पहला विकल्प: सूचना ट्रिगर
स्थायी या स्थायी कॉलम को दिखाने के लिए 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);
चौथा चरण: लागू करने की प्रोसेस बनाना और उसकी जांच करना
लोकल टेस्टिंग
ऐप्लिकेशन को डिस्ट्रिब्यूट किए बिना, लागू करने की जांच करने के लिए, यह तरीका अपनाएं:
अपने लोकल डिवाइस पर डेव मोड चालू करना:
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 से जुड़ी सूचनाएं पाएं पर जाएं.
तीसरे पक्ष के टूल को नए सुझाव/राय भेजें या शिकायत करें
अपनी टीम की पसंद की सूचना पर App Distribution की सूचनाएं भी भेजी जा सकती हैं Cloud Functions for Firebase का इस्तेमाल करने वाला चैनल. उदाहरण के लिए, आप फ़ंक्शन जो नए इन-ऐप्लिकेशन फ़ीडबैक के लिए अलर्ट इवेंट कैप्चर करता है और 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 चेतावनियों के लिए दस्तावेज़.