Android ऐप्लिकेशन को अपने-आप टेस्ट करें

ऑटोमेटेड टेस्टर की सुविधा, बीटा वर्शन में उपलब्ध है. बीटा रिलीज़ पर, सेवा स्तर समझौते (एसएलए) या इसे रोकने की नीति लागू नहीं होती. साथ ही, ऐसा हो सकता है कि इसे सीमित तौर पर सहायता मिले या कोई सहायता न मिले.

फ़िलहाल, बिना किसी अतिरिक्त शुल्क के हमारी बेहतरीन ऑटोमेटेड टेस्टर सुविधा का इस्तेमाल किया जा सकता है. बिना शुल्क के इस्तेमाल की जा सकने वाली रोज़ाना की सीमा पूरी हो जाने पर, इस सुविधा का इस्तेमाल जारी रखा जा सकता है. साथ ही, टेस्ट लैब की दरें लागू हो जाएंगी. हम ऑटोमेटेड टेस्टर (टेस्टर) सुविधा के लिए शुल्क देने की प्रक्रिया को पारदर्शी बनाने का वादा करते हैं. सुविधा उपलब्ध होने से पहले हम पूरी जानकारी शेयर करेंगे.

इस गाइड में बताया गया है कि Firebase कंसोल में App Distribution ऑटोमेटेड टेस्टर की सुविधा का इस्तेमाल करके, टेस्टर के लिए बिल्ड अपने-आप कैसे डिस्ट्रिब्यूट किए जा सकते हैं. ऑटोमेटेड टेस्टर की सुविधा, आपके ऐप्लिकेशन के लिए हमेशा तैयार रहने वाला और इस्तेमाल में आसान धुएं की जांच करने वाला टूल उपलब्ध कराती है.

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

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

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

चेतावनी: अपने ऐप्लिकेशन को Firebase पर रजिस्टर करते समय, पक्का करें कि आपने उस ऐप्लिकेशन के पैकेज का वही नाम डाला हो जिसे आपको उपलब्ध कराया जा रहा है. पैकेज के नाम की वैल्यू, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होती है. साथ ही, आपके Firebase प्रोजेक्ट के साथ रजिस्टर होने के बाद, Firebase में आपके ऐप्लिकेशन के लिए इसे बदला नहीं जा सकता.

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

Firebase कंसोल का इस्तेमाल करके, अपने ऐप्लिकेशन को ऑटोमेटेड टेस्टर को उपलब्ध कराएं

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

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

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

अपना ऐप्लिकेशन अपलोड करने के लिए, appdistribution:distribute कमांड इस्तेमाल करें और इसे टेस्टर के लिए उपलब्ध कराएं. ऑटोमेटेड टेस्टर सुविधा के साथ अपने डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के लिए, इन पैरामीटर का इस्तेमाल करें:

ऐप्लिकेशन डिस्ट्रिब्यूशन:डिस्ट्रिब्यूट के विकल्प
`--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 सीएलआई का इस्तेमाल शुरू करने और अपने डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के अलग-अलग तरीकों के बारे में ज़्यादा जानकारी के लिए, Firebase सीएलआई का इस्तेमाल करके टेस्टर को Android ऐप्लिकेशन डिस्ट्रिब्यूट करें देखें.

Gradle का इस्तेमाल करके, अपने-आप काम करने वाले टेस्टर को अपना ऐप्लिकेशन उपलब्ध कराना

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

App Distribution बिल्ड पैरामीटर
`testDevices` या `testDevicesFile`	ऑटोमेटेड टेस्ट का इस्तेमाल करके, जांच वाले जिन डिवाइसों को आपको बिल्ड डिस्ट्रिब्यूट करना है. आपके पास टेस्ट डिवाइसों को सेमीकोलन से अलग की गई, डिवाइस की खास जानकारी की सूची के तौर पर बताने का विकल्प है `testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` इसके अलावा, किसी ऐसी फ़ाइल का पाथ दिया जा सकता है जिसमें सेमीकोलन से अलग की गई डिवाइस की खास जानकारी की सूची हो: `testDevicesFile="/path/to/testDevices.txt"`
`testUsername`	ऑटोमेटेड टेस्ट के दौरान, अपने-आप लॉगिन होने की सुविधा के लिए उपयोगकर्ता नाम.
`testUsernameResource`	अपने-आप होने वाले टेस्ट के दौरान, अपने-आप लॉगिन होने की सुविधा के लिए उपयोगकर्ता नाम फ़ील्ड के लिए संसाधन का नाम.
`testPassword` या `testPasswordFile`	अपने-आप होने वाले टेस्ट के दौरान, अपने-आप लॉगिन होने का पासवर्ड इस्तेमाल किया जाए. या, पासवर्ड वाली किसी सामान्य टेक्स्ट फ़ाइल का पाथ बताया जा सकता है: testPasswordFile="/path/to/testPassword.txt"
`testPasswordResource`	अपने-आप होने वाले टेस्ट के दौरान, अपने-आप लॉगिन होने की सुविधा के लिए इस्तेमाल होने वाले पासवर्ड फ़ील्ड के लिए संसाधन का नाम.
`testNonBlocking`	एसिंक्रोनस तरीके से अपने-आप होने वाले टेस्ट चलाएं. अपने-आप टेस्ट के नतीजे देखने के लिए, FIrebase कंसोल पर जाएं.

Gradle और अपने डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के अलग-अलग तरीकों के बारे में ज़्यादा जानकारी पाने के लिए, Gredle का इस्तेमाल करके, टेस्टर को Android ऐप्लिकेशन डिस्ट्रिब्यूट करना लेख पढ़ें.

फ़ास्टलेन का इस्तेमाल करके, अपने ऐप्लिकेशन को ऑटोमेटेड टेस्टर को उपलब्ध कराएं

./fastlane/Fastfile लेन में, firebase_app_distribution ब्लॉक जोड़ें. ऑटोमेटेड टेस्टर सुविधा के साथ अपने डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के लिए, इन पैरामीटर का इस्तेमाल करें:

firebase_app_distribution पैरामीटर
`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 कंसोल पर जाएं.

फ़ास्टलेन का इस्तेमाल शुरू करने और अपने डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के अलग-अलग तरीकों के बारे में ज़्यादा जानकारी पाने के लिए, फ़ास्टलेन का इस्तेमाल करके टेस्टर को Android ऐप्लिकेशन डिस्ट्रिब्यूट करें देखें.

क्रॉल होने के अपने-आप टेस्ट स्टेटस

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

क्रॉल करने की स्थिति	ब्यौरा
मंज़ूरी मिलना बाकी है	अपने-आप होने वाली जांच अब भी चल रही है और जल्द ही आपके नतीजे उपलब्ध होंगे.
पास हो गया	अपने-आप होने वाली जांच में, आपके ऐप्लिकेशन को क्रॉल किया गया और कोई क्रैश नहीं मिला.
अपलोड नहीं हुआ	अपने-आप होने वाली जांच पूरी नहीं हो सकी, क्योंकि जांच के दौरान आपका ऐप्लिकेशन क्रैश हो गया.
कुछ ठोस नतीजा नहीं निकला	इंफ़्रास्ट्रक्चर से जुड़ी गड़बड़ियों की वजह से, अपने-आप टेस्ट नहीं हो सका.