Firebase सीएलआई का इस्तेमाल करके, जांच करने वाले लोगों को Android ऐप्लिकेशन उपलब्ध कराएं

इस गाइड में, टेस्टर के लिए Android ऐप्लिकेशन बंडल (एएबी) डिस्ट्रिब्यूट करने का तरीका बताया गया है Firebase सीएलआई का इस्तेमाल करके ऐसा किया जा सकता है. सीएलआई टूल से, आपको टेस्टर और बिल्ड के लिए रिलीज़ नोट का इस्तेमाल करता है. इसके बाद, बिल्ड को उसके हिसाब से डिस्ट्रिब्यूट किया जाता है.

App Distribution, Google Play की संगठन में काम करने वालों के साथ ऐप्लिकेशन शेयर करने की सुविधा के साथ इंटिग्रेट हो जाता है. आपके अपलोड किए गए एएबी को प्रोसेस करता है और उन APKs को उपलब्ध कराता है जो आपके टेस्टर के लिए ऑप्टिमाइज़ होते हैं डिवाइस कॉन्फ़िगरेशन. एएबी डिस्ट्रिब्यूट करके ये काम किए जा सकते हैं:

• आपके डिवाइस के लिए ऑप्टिमाइज़ किए गए, ऑप्टिमाइज़ किए गए ऐसे APK चलाएं जो Google Play उपलब्ध कराता है टेस्टर की डिवाइस.

• डिवाइस से जुड़ी समस्याओं का पता लगाना और उन्हें डीबग करना.

• ऐप्लिकेशन बंडल की सुविधाओं की जांच करें, जैसे कि Play की सुविधाओं की डिलीवरी और Play ऐसेट डिलीवरी शामिल है.

• अपने ऐप्लिकेशन के टेस्टर के लिए, डाउनलोड का साइज़ कम करें.

ज़रूरी अनुमतियां

एएबी को App Distribution पर अपलोड करने के लिए, आपको अपने Firebase ऐप्लिकेशन को किसी ऐप्लिकेशन से लिंक करना होगा Google Play में जाकर देखें. आपके पास ज़रूरी ऐक्सेस होना चाहिए इन कार्रवाइयों को करने के लिए.

अगर आपके पास Firebase का ज़रूरी ऐक्सेस नहीं है, तो आप Firebase प्रोजेक्ट से ऐसा करने का अनुरोध कर सकते हैं इसके ज़रिए, आपको लागू होने वाली भूमिका असाइन करेगा: Firebase कंसोल की आईएएम सेटिंग. अगर Firebase प्रोजेक्ट को ऐक्सेस करने के बारे में आपका कोई सवाल है, तो असाइन करने या ढूंढने के लिए, "Firebase प्रोजेक्ट की अनुमतियां और ऐक्सेस" अक्सर पूछे जाने वाले सवाल.

नीचे दी गई टेबल, Firebase ऐप्लिकेशन को किसी ऐप्लिकेशन से लिंक करने पर लागू होती है साथ ही, एएबी अपलोड भी किए जा सकते हैं.

Firebase कंसोल में कार्रवाई	आईएएम की ज़रूरी अनुमति	आईएएम की ऐसी भूमिकाएं जिनमें इनके लिए ज़रूरी अनुमतियां शामिल होती हैं डिफ़ॉल्ट	अन्य ज़रूरी भूमिका
Firebase ऐप्लिकेशन को Google Play पर किसी ऐप्लिकेशन से लिंक करना	firebase.playLinks.update	इनमें से कोई एक भूमिका: मालिक Firebase एडमिन	Google Play डेवलपर खाते को इस तौर पर ऐक्सेस करना एडमिन
App Distribution पर एएबी अपलोड करना	firebaseappdistro.releases.update	इनमें से कोई एक भूमिका: मालिक एडिटर Firebase एडमिन Firebase क्वालिटी एडमिन Firebase App Distribution एडमिन	––

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

1. अगर आपने पहले से Firebase को नहीं जोड़ा है, तो अपने Android में Firebase जोड़ें प्रोजेक्ट. इस वर्कफ़्लो के आखिर में, आपको आपके Firebase प्रोजेक्ट में एक Firebase Android ऐप्लिकेशन होना चाहिए.

   अगर किसी अन्य Firebase प्रॉडक्ट का इस्तेमाल नहीं किया जा रहा है, तो आपको सिर्फ़ प्रोजेक्ट करें और अपना ऐप्लिकेशन रजिस्टर करें. अगर आपको प्रॉडक्ट के लिए, कृपया इन सभी चरणों को पूरा करें अपने Android प्रोजेक्ट में Firebase जोड़ें.

2. Google Play से Firebase लिंक बनाने और एएबी अपलोड करने के लिए, पक्का करें कि आपका ऐप्लिकेशन इन ज़रूरी शर्तों को पूरा करता है:

   • Google Play और Firebase का Android ऐप्लिकेशन, दोनों रजिस्टर किए गए हों पैकेज नाम का ही इस्तेमाल करें.

   • Google Play में मौजूद ऐप्लिकेशन को ऐप्लिकेशन पर सेट अप किया गया हो डैशबोर्ड और उसे Google Play के किसी एक ट्रैक (इंटरनल टेस्टिंग, क्लोज़्ड टेस्टिंग, ओपन टेस्टिंग या प्रोडक्शन).

   • Google Play पर ऐप्लिकेशन की समीक्षा पूरी हो गई है और ऐप्लिकेशन को पब्लिश कर दिया गया है. अगर ऐप्लिकेशन की स्थिति कॉलम में, स्टेटस: इंटरनल टेस्टिंग (ड्राफ़्ट की इंटरनल टेस्टिंग नहीं), क्लोज़्ड टेस्टिंग, ओपन टेस्टिंग या प्रोडक्शन.

3. अपने Firebase के Android ऐप्लिकेशन को Google Play डेवलपर खाते से जोड़ें:

   1. Firebase कंसोल में, अपने settings प्रोजेक्ट सेटिंग, इसके बाद, इंटिग्रेशन टैब चुनें.

   2. Google Play कार्ड पर जाकर, जोड़ें पर क्लिक करें.
      अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है अगर आपके पास पहले से ही Google Play के लिंक हैं, तो मैनेज करें पर क्लिक करें आज़माएं.

   3. App Distribution को चालू करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें और चुनें कि Google से कौनसे Firebase Android ऐप्लिकेशन लिंक करने हैं ऐप्लिकेशन चलाएं.

   इसके बारे में ज़्यादा जानें Google Play से लिंक करना.

पहला चरण. अपना ऐप्लिकेशन बनाएं

जब आप टेस्टर के लिए, अपने ऐप्लिकेशन का रिलीज़ से पहले का वर्शन उपलब्ध कराने के लिए तैयार हों, अपना एएबी बनाएं (इस पर जाएं Android Studio के दस्तावेज़ देखें).

दूसरा चरण. टेस्टर को अपना ऐप्लिकेशन उपलब्ध कराना

टेस्टर को अपना ऐप्लिकेशन उपलब्ध कराने के लिए, इसकी मदद से अपने ऐप्लिकेशन की फ़ाइल अपलोड करें Firebase सीएलआई:

1. Firebase सीएलआई का सबसे नया वर्शन इंस्टॉल या अपडेट करें (हम आपके ओएस के लिए खास सीएलआई के लिए स्टैंडअलोन बाइनरी डाउनलोड करने का सुझाव देते हैं). पक्का करें कि आपने साइन इन किया हो और इस बात की जांच कर ली हो कि आपके पास प्रोजेक्ट.
2. ऐप्लिकेशन डिस्ट्रिब्यूशन पेज पर में जाकर, वह ऐप्लिकेशन चुनें जिसे आपको उपलब्ध कराना है. इसके बाद, शुरू करें पर क्लिक करें.

3. अपना ऐप्लिकेशन अपलोड करने के लिए, appdistribution:distribute कमांड चलाएं और उसे टेस्टर में डिस्ट्रिब्यूट किया जा सकता है. नीचे दिए गए पैरामीटर का इस्तेमाल करके, डिस्ट्रिब्यूशन:

   ऐप्लिकेशनडिस्ट्रिब्यूशन:डिस्ट्रिब्यूट के विकल्प
   --app	ज़रूरी है: आपके ऐप्लिकेशन का Firebase ऐप्लिकेशन आईडी. ऐप्लिकेशन ढूंढने के लिए, Firebase कंसोल में आईडी सामान्य सेटिंग पेज. --app 1:1234567890:android:0a1b2c3d4e5f67890
   --token	सीआई की पुष्टि करते समय प्रिंट हुआ रीफ़्रेश टोकन को Firebase सीएलआई की मदद से एनवायरमेंट करें (पढ़ें सीआई के साथ सीएलआई का इस्तेमाल करें सिस्टम देखें). --token "$FIREBASE_TOKEN"
   --release-notes --release-notes-file	इस बिल्ड के लिए प्रॉडक्ट की जानकारी वाला दस्तावेज़. आपके पास सीधे तौर पर रिलीज़ नोट बताने का विकल्प होता है: --release-notes "Text of release notes" या, किसी सादे टेक्स्ट वाली फ़ाइल का पाथ बताएं: --release-notes-file "/path/to/release-notes.txt"
   --testers --testers-file	टेस्टर के ऐसे ईमेल पते जिन्हें न्योता भेजना है. टेस्टर की जानकारी, कॉमा लगाकर अलग की गई ईमेल की सूची के तौर पर दी जा सकती है पते: --testers "ali@example.com, bri@example.com, cal@example.com" या, आप एक ऐसी सादा टेक्स्ट फ़ाइल का पाथ तय कर सकते हैं जिसमें कॉमा लगाकर अलग की गई ईमेल पतों की सूची: --testers-file "/path/to/testers.txt"
   --groups --groups-file	जांच करने वाले ऐसे ग्रुप जिन्हें न्योता भेजना है (इसका लिंक देखें टेस्टर मैनेज करें). ग्रुप की जानकारी ग्रुप के उपनामों का इस्तेमाल करके दी जाती है. इससे आपको ये काम करने में मदद मिल सकती है Firebase कंसोल में खोजें. आप समूहों को कॉमा-सेपरेटेड लिस्ट के रूप में तय कर सकते हैं: --groups "qa-team, trusted-testers" या, आप एक ऐसी सादा टेक्स्ट फ़ाइल का पाथ तय कर सकते हैं जिसमें कॉमा लगाकर अलग की गई ग्रुप के नामों की सूची: --groups-file "/path/to/groups.txt"
   --debug	वह फ़्लैग जिसे वर्बोस लॉग आउटपुट प्रिंट करने के लिए शामिल किया जा सकता है.
   --test-devices --test-devices-file	नीचे दिए गए डिस्ट्रिब्यूशन टाइप, ऑटोमेटेड टेस्टर बीटा सुविधा का हिस्सा हैं. वे टेस्ट डिवाइस जिन पर आपको बिल्ड डिस्ट्रिब्यूट करना है (इसका रेफ़रंस देखें ऑटोमेटेड टेस्ट). टेस्टर की जानकारी, कॉमा लगाकर अलग की गई ईमेल की सूची के तौर पर दी जा सकती है पते: --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" या, आप एक ऐसी सादा टेक्स्ट फ़ाइल का पाथ तय कर सकते हैं जिसमें सेमीकोलन लगाकर अलग किए गए टेस्ट डिवाइसों की सूची: --test-devices-file: "/path/to/test-devices.txt"
   --test-username	ऑटोमेटेड टेस्ट के दौरान अपने-आप लॉगिन होने के लिए उपयोगकर्ता नाम.
   --test-password --test-password-file	ऑटोमैटिक लॉगिन के लिए पासवर्ड, जिसका इस्तेमाल ऑटोमेटेड टेस्ट के दौरान किया जाएगा. या, आप पासवर्ड वाली सादी टेक्स्ट फ़ाइल का पाथ तय कर सकते हैं: --test-password-file: "/path/to/test-password.txt"
   --test-username-resource	ऑटोमेटेड टेस्ट के दौरान अपने-आप लॉगिन होने के लिए, उपयोगकर्ता नाम फ़ील्ड के संसाधन का नाम.
   --test-password-resource	ऑटोमेटेड टेस्ट के दौरान अपने-आप लॉगिन होने के लिए, पासवर्ड फ़ील्ड के लिए संसाधन का नाम.
   --test-non-blocking	एसिंक्रोनस तरीके से ऑटोमेटेड टेस्ट चलाएं. अपने-आप होने वाले टेस्ट के नतीजों के लिए, Firebase कंसोल पर जाएं.

   उदाहरण के लिए:

   firebase appdistribution:distribute test.aab  \
       --app 1:1234567890:android:0a1b2c3d4e5f67890  \
       --release-notes "Bug fixes and improvements" --testers-file testers.txt
   

   रिलीज़ अपलोड होने के बाद, Firebase सीएलआई ये लिंक दिखाता है. ये लिंक आपको बाइनरी मैनेज करने में मदद करते हैं. साथ ही, यह पक्का करते हैं कि टेस्टर और डेवलपर के पास सही रिलीज़ है:

   • firebase_console_uri - Firebase कंसोल, जिसमें सिर्फ़ एक रिलीज़ दिखाई गई है. इसे शेयर किया जा सकता है अपने संगठन के अन्य डेवलपर के साथ लिंक करें.
   • testing_uri - टेस्टर में रिलीज़ का लिंक अनुभव (Android के लिए खास ऐप्लिकेशन) जो टेस्टर को रिलीज़ की जानकारी नोट लिख सकता है और ऐप्लिकेशन को उनके डिवाइस पर इंस्टॉल कर सकता है. टेस्टर को ये ज़रूरी शर्तें पूरी करनी होंगी लिंक का इस्तेमाल करने के लिए रिलीज़ को ऐक्सेस करना.
   • binary_download_uri - सीधे तौर पर साइन किया गया लिंक ऐप्लिकेशन बाइनरी डाउनलोड और इंस्टॉल करता है (APK या एएबी फ़ाइल) को अपनाएं. एक घंटे बाद लिंक काम नहीं करेगा.

   टेस्टर और ग्रुप को मैनेज करना

   रिलीज़ डिस्ट्रिब्यूट करने के अलावा, appdistribution:testers:add और जांच करने वाले नए लोगों को न्योता भेजने या उन्हें हटाने के लिए appdistribution:testers:remove आपके Firebase प्रोजेक्ट के मौजूदा टेस्टर.

   टेस्टर को जोड़ने के बाद हैं, तो आप उन्हें अलग-अलग रिलीज़ में जोड़ सकते हैं. टेस्टर को हटाने पर, उसके पास इसका ऐक्सेस नहीं रहेगा रिलीज़ करते हैं. ध्यान दें कि जिन टेस्टर को हाल ही में हटाया गया है वे हालांकि, इससे कुछ समय तक आपकी रिलीज़ को ऐक्सेस किया जा सकता है.

   उदाहरण के लिए:

   firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
   
   firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
   

   टेस्टर के ईमेल पतों को अलग करने के लिए, अलग स्पेस होना चाहिए. टेस्टर के बारे में भी बताया जा सकता है --file /path/to/testers.txt का इस्तेमाल करके.

   अगर टेस्टर बड़ी संख्या में हैं, तो आपको इन ग्रुप का इस्तेमाल करना चाहिए: appdistribution:group:create का इस्तेमाल किया जा सकता है और Firebase में ग्रुप बनाने या मिटाने के लिए appdistribution:group:delete प्रोजेक्ट.

   --group-alias का इस्तेमाल करके appdistribution:testers:add और appdistribution:testers:remove निर्देश.

   उदाहरण के लिए:

   firebase appdistribution:group:create "QA team" qa-team
   
   firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
   
   firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
   
   firebase appdistribution:group:delete qa-team
   

बिल्ड डिस्ट्रिब्यूट करने के बाद, यह Firebase कंसोल का App Distribution डैशबोर्ड, 150 दिन (पांच महीने) के लिए. जब बिल्ड की समयसीमा खत्म होने से 30 दिन का समय बीत जाता है, तो दोनों में समयसीमा खत्म होने की सूचना दिखती है कंसोल और आपके टेस्टर के टेस्ट डिवाइस पर बिल्ड की सूची.

जिन टेस्टर को ऐप्लिकेशन की जांच करने का न्योता नहीं मिला है उन्हें ईमेल से न्योते मिलेंगे शुरू करते हैं, और मौजूदा टेस्टर को नए बिल्ड के बारे में ईमेल सूचनाएं मिलती हैं परीक्षण के लिए तैयार है (इसे पढ़ें टेस्टर सेट अप गाइड टेस्ट को इंस्टॉल करने से जुड़े निर्देशों के लिए ऐप्लिकेशन). आप हर एक टेस्टर की स्थिति पर नज़र रख सकते हैं-क्या उन्होंने और क्या उन्होंने Firebase कंसोल में ऐप्लिकेशन डाउनलोड किया है.

टेस्टर को 30 दिनों के अंदर, ऐप्लिकेशन की जांच करने का न्योता स्वीकार करना होगा. इसके बाद, ऐप्लिकेशन की समयसीमा खत्म हो जाएगी. जब किसी न्योते की समयसीमा खत्म होने के पांच दिन बाद की समयसीमा खत्म होने की सूचना होती है, तो रिलीज़ पर टेस्टर के बगल में मौजूद Firebase कंसोल. न्योता टेस्टर की लाइन पर मौजूद ड्रॉप-डाउन मेन्यू का इस्तेमाल करके, उसे फिर से भेजकर रिन्यू किया जा सकता है.

अगले चरण

• ऐप्लिकेशन में सुझाव लागू करें ताकि टेस्टर आपके ऐप्लिकेशन के बारे में आसानी से सुझाव/राय दे सकें या शिकायत कर सकें. इसमें ये भी शामिल हैं स्क्रीनशॉट).

• इन-ऐप्लिकेशन सूचनाएं दिखाने का तरीका जानें आपके ऐप्लिकेशन के नए बिल्ड इंस्टॉल करने के लिए उपलब्ध होने पर, उन्हें आपके टेस्टर को उपलब्ध कराया जाएगा.

• सीआई/सीडी का इस्तेमाल करके, QA जांच करने वाले लोगों को Android ऐप्लिकेशन उपलब्ध कराने के सबसे सही तरीके जानें.