आप किसी भी सतत एकीकरण (सीआई) प्रणाली का उपयोग करके अपना ऐप विकसित करते समय फायरबेस टेस्ट लैब का उपयोग कर सकते हैं। जब भी आप अपने ऐप स्रोत कोड के अपडेट की जांच करते हैं तो निरंतर एकीकरण सिस्टम आपको स्वचालित रूप से अपना ऐप बनाने और परीक्षण करने देता है।
जेनकींस सीआई के साथ फायरबेस टेस्ट लैब का उपयोग करना
यह अनुभाग बताता है कि जेनकींस सीआई के साथ टेस्ट लैब का उपयोग कैसे करें।
आवश्यकताएं
इससे पहले कि आप जेनकींस के साथ फायरबेस टेस्ट लैब का उपयोग कर सकें, आपको निम्नलिखित चरण पूरे करने होंगे:
जीक्लाउड सेट करें. फ़ायरबेस प्रोजेक्ट बनाने और अपने स्थानीय Google क्लाउड SDK वातावरण को कॉन्फ़िगर करने के लिए gcloud कमांड लाइन से फ़ायरबेस टेस्ट लैब का उपयोग करने के निर्देशों का पालन करें।
एक सेवा खाता बनाएं और अधिकृत करें. सेवा खाते स्पैम जांच या कैप्चा संकेतों के अधीन नहीं हैं, जो अन्यथा आपके सीआई बिल्ड को अवरुद्ध कर सकते हैं। Google क्लाउड कंसोल में एक संपादक की भूमिका के साथ एक सेवा खाता बनाएं और फिर इसे सक्रिय करें (कैसे जानने के लिए gcloud auth activate-service-account दस्तावेज़ देखें)।
आवश्यक API सक्षम करें. सेवा खाते का उपयोग करके लॉग इन करने के बाद: Google डेवलपर्स कंसोल एपीआई लाइब्रेरी पेज में, Google क्लाउड टेस्टिंग एपीआई और क्लाउड टूल परिणाम एपीआई सक्षम करें। इन एपीआई को सक्षम करने के लिए, इन एपीआई नामों को कंसोल के शीर्ष पर खोज बॉक्स में टाइप करें, और फिर उस एपीआई के अवलोकन पृष्ठ पर एपीआई सक्षम करें पर क्लिक करें।
जेनकींस स्थापित करें और सेटअप करें
आप लिनक्स या विंडोज़ पर जेनकींस सीआई स्थापित और सेट कर सकते हैं। इस गाइड के कुछ विवरण लिनक्स पर जेनकींस सीआई को स्थापित करने और चलाने के लिए विशिष्ट हैं, जिसमें फ़ाइल पथों में स्लैश ( / ) का उपयोग भी शामिल है।
लिनक्स या विंडोज चलाने वाले कंप्यूटर पर जेनकींस को डाउनलोड और इंस्टॉल करने के लिए, जेनकींस इंस्टॉल करने के निर्देशों का पालन करें। जेनकींस स्थापित करने के बाद, सेटअप पूरा करने और जेनकींस डैशबोर्ड तक पहुंचने के लिए जेनकींस को शुरू करने और एक्सेस करने के निर्देशों का पालन करें।
वैश्विक सुरक्षा सेटिंग्स कॉन्फ़िगर करें
पहली बार स्थापित होने पर जेनकींस में उपयोगकर्ता प्रमाणीकरण और पहुंच नियंत्रण कॉन्फ़िगर नहीं किया गया है। फायरबेस टेस्ट लैब के साथ जेनकींस का उपयोग करने से पहले, एक्सेस नियंत्रण लागू करने और उपयोगकर्ताओं को प्रमाणित करने के लिए वैश्विक सुरक्षा सेटिंग्स कॉन्फ़िगर करें।
वैश्विक सुरक्षा सेटिंग्स कॉन्फ़िगर करने के लिए
- अपने सर्वर पर जेनकींस डैशबोर्ड पर नेविगेट करें। ऐसा करने के लिए, http://<servername>:8080 पर ब्राउज़ करें, जहां <servername> उस कंप्यूटर का नाम है जहां आपने जेनकींस स्थापित किया है।
- जेनकींस डैशबोर्ड पर, जेनकींस प्रबंधित करें पर क्लिक करें और फिर वैश्विक सुरक्षा कॉन्फ़िगर करें पर क्लिक करें।
- वैश्विक सुरक्षा कॉन्फ़िगर करें पृष्ठ पर, सुरक्षा सक्षम करें पर क्लिक करें और फिर सहेजें पर क्लिक करें।
जेनकींस के लिए सुरक्षा सेटिंग्स कॉन्फ़िगर करने के बारे में अधिक जानकारी के लिए, त्वरित और सरल सुरक्षा , मानक सुरक्षा सेटअप और जेनकींस को सुरक्षित करना देखें।
एक जेनकींस प्रोजेक्ट बनाएं
इसके बाद, फायरबेस टेस्ट लैब के साथ अपने ऐप का निरंतर एकीकरण परीक्षण चलाने के लिए एक प्रोजेक्ट बनाएं।
जेनकींस प्रोजेक्ट बनाने के लिए
- अपने सर्वर पर जेनकींस डैशबोर्ड पर नेविगेट करें। ऐसा करने के लिए, http://<servername>:8080 पर ब्राउज़ करें, जहां <servername> उस कंप्यूटर का नाम है जहां आपने जेनकींस स्थापित किया है।
- जेनकींस डैशबोर्ड पर, नया आइटम क्लिक करें।
- आइटम नाम फ़ील्ड में अपने प्रोजेक्ट के लिए एक नाम टाइप करें:
- एकल बिल्ड कॉन्फ़िगरेशन का उपयोग करने वाला प्रोजेक्ट बनाने के लिए फ़्रीस्टाइल प्रोजेक्ट चुनें।
- एक प्रोजेक्ट बनाने के लिए बिल्ड मल्टी-कॉन्फ़िगरेशन प्रोजेक्ट चुनें जो कई अलग-अलग बिल्ड कॉन्फ़िगरेशन पर चलता है। यदि आप अपने ऐप को विभिन्न बिल्ड कॉन्फ़िगरेशन (एकाधिक लोकेशंस, एकाधिक एंड्रॉइड एपीआई स्तर इत्यादि) के साथ बनाने की योजना बना रहे हैं, तो एक मल्टी-कॉन्फ़िगरेशन प्रोजेक्ट सबसे अच्छा विकल्प है।
- सहेजें पर क्लिक करें.
आपका प्रोजेक्ट बन जाने के बाद, आपका वेब ब्राउज़र आपके प्रोजेक्ट का मुख्य पृष्ठ प्रदर्शित करता है।
पुनरीक्षण नियंत्रण और ग्रैडल बिल्ड चरण जोड़ें
यह अनुभाग वर्णन करता है कि जेनकींस को गिटहब जैसे संशोधन नियंत्रण प्रणालियों के साथ कैसे एकीकृत किया जाए, और स्रोत कोड से एपीके पैकेज बनाने के लिए ग्रैडल बिल्ड चरणों को कैसे जोड़ा जाए।
GitHub और अन्य संशोधन नियंत्रण प्रणालियों के साथ एकीकरण
यदि आप अपने ऐप के लिए स्रोत कोड को प्रबंधित करने के लिए GitHub या किसी अन्य संशोधन नियंत्रण प्रणाली का उपयोग करते हैं, तो आप स्वचालित बिल्ड चलाने के लिए जेनकींस को कॉन्फ़िगर कर सकते हैं और हर बार आपके ऐप के अपडेट चेक किए जाने पर परीक्षण चला सकते हैं। आप समय-समय पर बिल्ड चलाने के लिए जेनकींस को भी कॉन्फ़िगर कर सकते हैं।
जेनकींस में बिल्ड को कॉन्फ़िगर करने के बारे में जानने के लिए, स्वचालित बिल्ड को कॉन्फ़िगर करना देखें।
एपीके पैकेजों के पुनर्निर्माण के लिए ग्रैडल बिल्ड चरणों को जोड़ना
यदि आप अपने ऐप के लिए स्रोत कोड को प्रबंधित करने के लिए एक संशोधन नियंत्रण प्रणाली का उपयोग करते हैं, तो आपको हर बार जेनकींस द्वारा आपके पुनरीक्षण नियंत्रण प्रणाली से स्रोत कोड डाउनलोड करने पर नए एपीके बायनेरिज़ बनाने के लिए एक ग्रैडल बिल्ड चरण शामिल करना होगा।
अपने एप्लिकेशन के लिए मुख्य निर्देशिका में निम्नलिखित कमांड चलाने के लिए एक बिल्ड चरण जोड़ें:
./gradlew :app:assembleDebug ./gradlew :app:assembleDebugAndroidTest
टेस्ट लैब के साथ परीक्षण करते समय ग्रैडल द्वारा बनाए गए एपीके पैकेज का उपयोग करने के लिए एक बिल्ड चरण जोड़ें। आप इस पथ का उपयोग नीचे दिए गए शेल स्क्रिप्ट उदाहरण में <local_server_path> के रूप में कर सकते हैं, जहां <AppFolder> आपके ऐप के लिए एंड्रॉइड स्टूडियो प्रोजेक्ट फ़ोल्डर है:
<AppFolder>/app/build/outputs/apk
जेनकींस में टेस्ट लैब बिल्ड चरण जोड़ें
अब आप gcloud कमांड लाइन का उपयोग करके टेस्ट लैब चलाने के लिए जेनकींस में एक बिल्ड चरण जोड़ने के लिए तैयार हैं।
Gcloud बिल्ड चरण जोड़ने के लिए
- अपने प्रोजेक्ट के मुख्य पृष्ठ से, कॉन्फ़िगर करें पर क्लिक करें।
प्रोजेक्ट कॉन्फ़िगरेशन पृष्ठ पर, बिल्ड अनुभाग तक नीचे स्क्रॉल करें, और फिर बिल्ड चरण जोड़ें मेनू से एक्ज़िक्यूट शेल चुनें।
जेनकिंस एक्ज़िक्यूट शेल कमांड विंडो में, सर्वर पर नमूना ऐप के पथ के लिए <local_server_path> , अपने ऐप के एपीके के लिए <app_apk> , और अपने ऐप के परीक्षण एपीके के लिए <app_test_apk> को प्रतिस्थापित करते हुए निम्नलिखित दर्ज करें:
gcloud firebase test android run --app <local_server_path>/<app_apk>.apk --test <local_server_path>/<app_test_apk>.apk
परीक्षण परिणामों का विश्लेषण करें
टेस्ट लैब द्वारा आपके ऐप का परीक्षण पूरा करने के बाद, आप अपने प्रोजेक्ट में फायरबेस कंसोल या Google क्लाउड स्टोरेज बकेट में परीक्षण परिणामों की समीक्षा कर सकते हैं। आप अपने स्थानीय कंप्यूटर पर परीक्षण परिणाम डेटा की प्रतिलिपि बनाने के लिए ऊपर दिखाए गए शेल कमांड में एक gsutil कमांड भी जोड़ सकते हैं। अधिक जानने के लिए, फायरबेस टेस्ट लैब परिणामों का विश्लेषण देखें।
अन्य सीआई प्रणालियों के साथ निरंतर एकीकरण
अन्य सीआई सिस्टम के साथ फायरबेस टेस्ट लैब का उपयोग करने का तरीका जानने के लिए, उनके दस्तावेज़ देखें: