इस गाइड में, Firebase कंसोल में App Distribution ऑटोमेटेड टेस्टर की सुविधा का इस्तेमाल करके, टेस्टर को बिल्ड अपने-आप डिस्ट्रिब्यूट करने का तरीका बताया गया है. ऑटोमेटेड टेस्टर की सुविधा, आपके ऐप्लिकेशन के लिए हमेशा तैयार और आसानी से इस्तेमाल किया जा सकने वाला स्मोक टेस्टिंग टूल उपलब्ध कराती है.
शुरू करने से पहले
अगर आपने पहले से ही ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.
अगर Firebase के किसी दूसरे प्रॉडक्ट का इस्तेमाल नहीं किया जा रहा है, तो आपको सिर्फ़ एक प्रोजेक्ट बनाना होगा और अपना ऐप्लिकेशन रजिस्टर करना होगा. हालांकि, अगर आने वाले समय में आपको अन्य प्रॉडक्ट इस्तेमाल करने हैं, तो Firebase कंसोल का इस्तेमाल करके Firebase जोड़ें में दिए गए सभी चरणों को पूरा करना न भूलें.
जब आप जांच करने वाले लोगों को अपने ऐप्लिकेशन का रिलीज़ से पहले का वर्शन वितरित करने के लिए तैयार हों, तो अपनी सामान्य प्रक्रिया का इस्तेमाल करके अपना APK बनाएं. आपको APK पर अपनी डीबग कुंजी या ऐप्लिकेशन साइनिंग कुंजी से साइन करना होगा.
Firebase कंसोल का इस्तेमाल करके, अपने ऐप्लिकेशन को ऑटोमेटेड टेस्टर को डिस्ट्रिब्यूट करना
अपने ऐप्लिकेशन को ऑटोमेटेड टेस्टर को डिस्ट्रिब्यूट करने के लिए, Firebase कंसोल का इस्तेमाल करके अपनी APK फ़ाइल अपलोड करें:
- Firebase कंसोल का App Distribution पेज खोलें. जब कहा जाए, तब अपना Firebase प्रोजेक्ट चुनें.
- रिलीज़ पेज पर, ड्रॉप-डाउन मेन्यू से वह ऐप्लिकेशन चुनें जिसे आपको उपलब्ध कराना है.
- अपने ऐप्लिकेशन की APK फ़ाइल को अपलोड करने के लिए, उसे कंसोल में खींचें और छोड़ें.
- अपलोड पूरा होने के बाद, टेस्टर या ग्रुप जोड़ें खोज बार में ऑटोमेटेड टेस्टर चुनें.
- अपने-आप चलने वाले टेस्ट को पसंद के मुताबिक बनाने के लिए, बदलाव करें आइकॉन पर क्लिक करें. इसके बाद, अपने-आप चलने वाले टेस्ट को पसंद के मुताबिक बनाएं डायलॉग में, पसंद के मुताबिक बनाने के विकल्प चुनें.
- (ज़रूरी नहीं) डिवाइस कॉन्फ़िगरेशन डायलॉग में, वह एपीआई लेवल, डिवाइस ओरिएंटेशन, और स्थान-भाषा चुनें जो आपके टेस्ट स्पेसिफ़िकेशन के मुताबिक हो.
- (ज़रूरी नहीं) अगर आपके ऐप्लिकेशन के लिए लॉगिन क्रेडेंशियल की ज़रूरत है, तो टेस्ट के दौरान इस्तेमाल किए जा सकने वाले कस्टम उपयोगकर्ता नाम और पासवर्ड बनाने के लिए, लॉगिन क्रेडेंशियल ड्रॉप-डाउन मेन्यू पर क्लिक करें.
- डिस्ट्रिब्यूट करें पर क्लिक करें. अपने ऐप्लिकेशन के लिए, रिलीज़ नोट भी जोड़ा जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.
Firebase CLI का इस्तेमाल करके, अपने ऐप्लिकेशन को ऑटोमेटेड टेस्टर को डिस्ट्रिब्यूट करना
अपना ऐप्लिकेशन अपलोड करने और उसे टेस्टर के साथ शेयर करने के लिए, appdistribution:distribute कमांड चलाएं. अपने डिस्ट्रिब्यूशन को ऑटोमेटेड टेस्टर की सुविधा के लिए कॉन्फ़िगर करने के लिए, इन पैरामीटर का इस्तेमाल करें:
| appdistribution:distribute options | |
|---|---|
--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 CLI का इस्तेमाल शुरू करने और डिस्ट्रिब्यूशन को कॉन्फ़िगर करने के अलग-अलग तरीकों के बारे में ज़्यादा जानने के लिए, Firebase CLI का इस्तेमाल करके टेस्टर को 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 ऐप्लिकेशन उपलब्ध कराएं पर जाएं.
अपने-आप क्रॉल होने वाले टेस्ट की स्थितियां
टेस्ट के नतीजों को समझने में आपकी मदद करने के लिए, अपने-आप होने वाली जांच के नतीजे टैब में, हर डिवाइस के लिए जांच से जुड़ी समस्याएं, ऐप्लिकेशन के स्क्रीनशॉट, और जांच के क्रॉल का वीडियो दिखता है. जांच की स्थिति, जांच के नतीजों वाले पेज पर देखी जा सकती है:
| क्रॉल स्थिति | ब्यौरा |
|---|---|
| मंज़ूरी मिलना बाकी है | अपने-आप होने वाली जांच अब भी चल रही है और आपके नतीजे जल्द ही उपलब्ध होंगे. |
| पास हो गया | अपने-आप होने वाले टेस्ट में आपके ऐप्लिकेशन को क्रॉल कर लिया गया है और इसमें कोई क्रैश नहीं मिला. |
| लेन-देन पूरा नहीं किया जा सका | टेस्ट के दौरान आपका ऐप्लिकेशन क्रैश हो गया, इसलिए ऑटोमैटिक टेस्ट पूरा नहीं हो सका. |
| कोई नतीजा नहीं निकला | इन्फ़्रास्ट्रक्चर से जुड़ी गड़बड़ियों की वजह से, अपने-आप होने वाला टेस्ट पूरा नहीं हो सका. |