इस गाइड में, Firebase App Distribution Android SDK टूल का इस्तेमाल करके, ऐप्लिकेशन में फ़ीडबैक देने की सुविधा चालू करने का तरीका बताया गया है. इससे, टेस्टर सीधे ऐप्लिकेशन में फ़ीडबैक (स्क्रीनशॉट के साथ) सबमिट कर सकते हैं. यह SDK टूल इस्तेमाल करना ज़रूरी नहीं है.
शुरू करने से पहले
अगर आपने पहले से ही A/B टेस्टिंग नहीं बनाई है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.
पहला चरण: App Distribution टेस्टर एपीआई चालू करना
Google Cloud कंसोल खोलें और अपना Firebase प्रोजेक्ट चुनें.
Firebase App Testers API में जाकर, चालू करें पर क्लिक करें.
दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना
App Distribution Android SDK में दो लाइब्रेरी शामिल हैं:
firebase-appdistribution-api: सिर्फ़ एपीआई वाली लाइब्रेरी, जिसे सभी बिल्ड वैरिएंट में शामिल किया जा सकता है.firebase-appdistribution: एसडीके टूल को पूरी तरह से लागू करना (ज़रूरी नहीं).
सिर्फ़ एपीआई वाली लाइब्रेरी, आपके कोड को एसडीके को कॉल करने की अनुमति देती है. अगर SDK टूल को पूरी तरह से लागू नहीं किया गया है, तो कॉल का कोई असर नहीं होगा.
App Distribution Android SDK टूल के लिए डिपेंडेंसी का एलान, अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर
<project>/<app-module>/build.gradle.ktsया<project>/<app-module>/build.gradle) में करें.अपने Google Play बिल्ड में, SDK टूल को लागू करने की पूरी प्रोसेस के लिए, खुद अपडेट होने की सुविधा को शामिल करने से बचने के लिए, बिल्ड के वैरिएंट की पहचान करें. इनमें बिल्ड टाइप या ऐप्लिकेशन टाइप शामिल हैं. इन्हें App Distribution के ज़रिए डिस्ट्रिब्यूट किया जाएगा.
मॉड्यूल (ऐप्लिकेशन-लेवल) की 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-beta21") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21") }
Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta21") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21") }
क्या आपको Kotlin के लिए खास लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 की रिलीज़ से, Kotlin और Java डेवलपर, दोनों ही मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.
तीसरा चरण: इन-ऐप्लिकेशन फ़ीडबैक को कॉन्फ़िगर करना
टेस्टर से सुझाव, राय या शिकायत पाने के लिए, इनमें से किसी एक ट्रिगर का इस्तेमाल करें. इससे टेस्टर, सुझाव, राय या शिकायत दे पाएंगे:
पहले से मौजूद सूचना ट्रिगर: App Distribution Android SDK, लगातार सूचना दिखा सकता है. टेस्टर, ऐप्लिकेशन में कहीं से भी इस सूचना पर टैप कर सकता है. अगर आपको जल्दी से शुरुआत करनी है और आपको टेस्टर के सुझाव देने के तरीके को पसंद के मुताबिक बनाने की ज़रूरत नहीं है, तो इस ट्रिगर का इस्तेमाल करें.
कस्टम ट्रिगर: आपके पास ट्रिगर करने का अपना तरीका उपलब्ध कराने का विकल्प होता है. जैसे, अपने ऐप्लिकेशन में किसी बटन या मेन्यू आइटम पर टैप करना या डिवाइस को शेक करना.
इनमें से किसी भी ट्रिगर का इस्तेमाल करने और टेस्टर के सुझाव/राय देने या शिकायत करने पर, Android SDK ये कार्रवाइयां करता है:
यह ऐप्लिकेशन की मौजूदा गतिविधि का स्क्रीनशॉट लेता है.
यह जांच करता है कि टेस्टर ने एसडीके की टेस्टिंग सुविधाएं चालू की हैं या नहीं. अगर टेस्टिंग की सुविधाएं चालू नहीं हैं, तो Android SDK, टेस्टर को अपने Google खाते से App Distribution में साइन इन करने के लिए कहता है.
यह फ़ुल-स्क्रीन पर एक गतिविधि शुरू करता है. इससे टेस्टर अपना फ़ीडबैक लिख सकता है और उसे सबमिट कर सकता है.
पहला विकल्प: सूचना ट्रिगर करने वाला इवेंट
showFeedbackNotification() का इस्तेमाल करके, टेस्टर के डिवाइस पर लगातार या चल रही सूचना दिखाएं. इस सूचना पर टैप करके, टेस्टर सुझाव/राय दे सकते हैं या शिकायत कर सकते हैं. सूचना को कॉन्फ़िगर करते समय, आपको कुछ टेक्स्ट देना होगा. यह टेक्स्ट, टेस्टर को सुझाव/राय देने या शिकायत करने से पहले दिखेगा. साथ ही, आपको सूचना के लिए रुकावट का लेवल भी तय करना होगा. यह लेवल, सूचना चैनल की अहमियत के हिसाब से तय होता है. अगर आपको टेस्टर को उनके फ़ीडबैक डेटा को इकट्ठा करने और प्रोसेस करने के बारे में सूचना देनी है, तो टेक्स्ट का इस्तेमाल करके ऐसी सूचना दी जा सकती है.
showFeedbackNotification का इस्तेमाल करने और ऐप्लिकेशन के बैकग्राउंड में जाने पर, सूचना छिप जाती है. अगर आपको सूचना को साफ़ तौर पर छिपाना है, तो cancelFeedbackNotification का इस्तेमाल करें. Firebase का सुझाव है कि आप 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);
चौथा चरण: लागू किए गए बदलावों को बनाना और उनकी जांच करना
लोकल टेस्टिंग
ऐप्लिकेशन को डिस्ट्रिब्यूट किए बिना, लागू किए गए SDK टूल की जांच करने के लिए, यह तरीका अपनाएं:
अपने लोकल डिवाइस पर डेवलपर मोड चालू करें:
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 console में नई रिलीज़ के कार्ड में अपना सुझाव/राय देखें.
सामान्य समस्याओं को हल करने का तरीका जानने के लिए, एसडीके की मदद से टेस्टिंग की सुविधाएं चालू करना लेख पढ़ें. जैसे, टेस्टर को ऐप्लिकेशन में सुझाव/राय देने या शिकायत करने में समस्या आना.
पांचवां चरण: टेस्टर से मिले सुझाव, शिकायत या राय को मैनेज करना
टेस्टर को सुझाव/राय देने या शिकायत करने की सुविधा देने के बाद, इन टूल का इस्तेमाल करके सुझाव/राय या शिकायत की समीक्षा की जा सकती है और उस पर कार्रवाई की जा सकती है:
Firebase कंसोल में सुझाव, शिकायत या राय देखना और मिटाना
उपयोगकर्ता के सुझाव, शिकायत या राय की समीक्षा की जा सकती है और उसे मिटाया जा सकता है. इसमें स्क्रीनशॉट भी शामिल हैं. इसके लिए, Firebase Console में किसी रिलीज़ के तहत, टेस्टर के सुझाव, शिकायत या राय टैब को खोलें. उपयोगकर्ता के सुझाव, शिकायत या राय को रिलीज़ के हिसाब से व्यवस्थित किया जाता है. इससे आपको यह पुष्टि करने में मदद मिलती है कि सुझाव, शिकायत या राय किस वर्शन के लिए है.
उपयोगकर्ता के सुझाव, शिकायत या राय की समीक्षा करने के बाद, उसे मिटाया जा सकता है. इसके लिए, सुझाव, शिकायत या राय मिटाएं बटन पर क्लिक करें. मिटाया गया सुझाव, राय या शिकायत आपकी रिलीज़ से हटा दी जाती है.
नए सुझाव, शिकायत या राय के लिए ईमेल से सूचनाएं पाएं
टेस्टर से मिले नए सुझाव या राय के बारे में तुरंत जानने के लिए, ईमेल से सूचनाएं पाने की सुविधा चालू की जा सकती है. इससे टेस्टर के सुझाव या राय सबमिट करने पर, आपको ईमेल से सूचनाएं मिलेंगी. ईमेल से मिलने वाली सूचना में, टेस्टर से मिला लिखित सुझाव/राय या शिकायत शामिल होती है. साथ ही, इसमें उनके सबमिट किए गए स्क्रीनशॉट का लिंक भी शामिल होता है.
इस डिफ़ॉल्ट तरीके का इस्तेमाल करके, 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 चेतावनियों के लिए रेफ़रंस दस्तावेज़ देखें.