आप किसी निरंतर एकीकरण (CI) प्रणाली का उपयोग करके अपने ऐप को विकसित करते समय Firebase Test Lab का उपयोग कर सकते हैं। निरंतर एकीकरण प्रणाली आपको हर बार जब आप अपने ऐप स्रोत कोड के अपडेट में चेक इन करते हैं तो स्वचालित रूप से आपके ऐप का निर्माण और परीक्षण करने देती हैं।
जेनकिंस सीआई के साथ फायरबेस टेस्ट लैब का उपयोग करना
यह खंड बताता है कि जेनकिन्स सीआई के साथ टेस्ट लैब का उपयोग कैसे करें।
आवश्यकताएं
इससे पहले कि आप जेनकींस के साथ फायरबेस टेस्ट लैब का उपयोग कर सकें, आपको निम्नलिखित चरणों को पूरा करना होगा:
जीक्लाउड सेट करें। Firebase प्रोजेक्ट बनाने और अपने स्थानीय Google क्लाउड SDK वातावरण को कॉन्फ़िगर करने के लिए gcloud कमांड लाइन से Firebase टेस्ट लैब का उपयोग करने के निर्देशों का पालन करें।
एक सेवा खाता बनाएँ और अधिकृत करें। सेवा खाते स्पैम चेक या कैप्चा संकेतों के अधीन नहीं हैं, जो अन्यथा आपके सीआई बिल्ड को ब्लॉक कर सकते हैं। Google क्लाउड कंसोल में एक संपादक की भूमिका के साथ एक सेवा खाता बनाएं और फिर इसे सक्रिय करें (कैसे जानने के लिए gcloud प्रमाणीकरण सक्रिय-सेवा-खाता दस्तावेज़ देखें)।
आवश्यक एपीआई सक्षम करें। सेवा खाते का उपयोग करके लॉग इन करने के बाद: Google Developers कंसोल API लाइब्रेरी पृष्ठ में, Google क्लाउड परीक्षण API और क्लाउड टूल परिणाम API सक्षम करें। इन एपीआई को सक्षम करने के लिए, इन एपीआई नामों को कंसोल के शीर्ष पर खोज बॉक्स में टाइप करें, और फिर उस एपीआई के अवलोकन पृष्ठ पर एपीआई सक्षम करें पर क्लिक करें।
जेनकींस को स्थापित और स्थापित करें
आप Linux या Windows पर Jenkins CI को इंस्टॉल और सेट अप कर सकते हैं। इस गाइड के कुछ विवरण लिनक्स पर जेनकिन्स सीआई को स्थापित करने और चलाने के लिए विशिष्ट हैं, जिसमें फ़ाइल पथों में स्लैश ( /
) का उपयोग शामिल है।
Linux या Windows चलाने वाले कंप्यूटर पर Jenkins को डाउनलोड और इंस्टॉल करने के लिए, Jenkins इंस्टॉल करने के निर्देशों का पालन करें। जेनकींस स्थापित करने के बाद, सेटअप पूरा करने और जेनकींस डैशबोर्ड तक पहुंचने के लिए जेनकींस को शुरू करने और एक्सेस करने के निर्देशों का पालन करें।
वैश्विक सुरक्षा सेटिंग्स कॉन्फ़िगर करें
जेनकिंस के पास पहली बार स्थापित होने पर उपयोगकर्ता प्रमाणीकरण और अभिगम नियंत्रण कॉन्फ़िगर नहीं होता है। फायरबेस टेस्ट लैब के साथ जेनकिंस का उपयोग करने से पहले, अभिगम नियंत्रण लागू करने और उपयोगकर्ताओं को प्रमाणित करने के लिए वैश्विक सुरक्षा सेटिंग्स कॉन्फ़िगर करें।
वैश्विक सुरक्षा सेटिंग्स को कॉन्फ़िगर करने के लिए
- अपने सर्वर पर जेनकिंस डैशबोर्ड पर नेविगेट करें। ऐसा करने के लिए, http://<servername>:8080 पर ब्राउज़ करें, जहाँ <servername> उस कंप्यूटर का नाम है जहाँ आपने जेनकींस स्थापित किया है।
- Jenkins डैशबोर्ड पर, Jenkins प्रबंधित करें क्लिक करें और फिर वैश्विक सुरक्षा कॉन्फ़िगर करें क्लिक करें.
- वैश्विक सुरक्षा कॉन्फ़िगर करें पृष्ठ पर, सुरक्षा सक्षम करें क्लिक करें और फिर सहेजें क्लिक करें.
जेनकिंस के लिए सुरक्षा सेटिंग्स को कॉन्फ़िगर करने के बारे में अधिक जानकारी के लिए, त्वरित और सरल सुरक्षा , मानक सुरक्षा सेटअप और सुरक्षा जेनकींस देखें।
जेनकिंस प्रोजेक्ट बनाएं
इसके बाद, फायरबेस टेस्ट लैब के साथ अपने ऐप का निरंतर एकीकरण परीक्षण चलाने के लिए एक प्रोजेक्ट बनाएं।
जेनकिंस प्रोजेक्ट बनाने के लिए
- अपने सर्वर पर जेनकिंस डैशबोर्ड पर नेविगेट करें। ऐसा करने के लिए, http://<servername>:8080 पर ब्राउज़ करें, जहाँ <servername> उस कंप्यूटर का नाम है जहाँ आपने जेनकींस स्थापित किया है।
- Jenkins डैशबोर्ड पर New Item पर क्लिक करें।
- आइटम नाम फ़ील्ड में अपने प्रोजेक्ट के लिए एक नाम टाइप करें:
- एकल बिल्ड कॉन्फ़िगरेशन का उपयोग करने वाली परियोजना बनाने के लिए फ़्रीस्टाइल प्रोजेक्ट चुनें।
- कई अलग-अलग बिल्ड कॉन्फ़िगरेशन पर चलने वाली परियोजना बनाने के लिए बिल्ड मल्टी-कॉन्फ़िगरेशन प्रोजेक्ट चुनें। यदि आप अपने ऐप को विभिन्न प्रकार के बिल्ड कॉन्फ़िगरेशन (एकाधिक स्थान, कई एंड्रॉइड एपीआई स्तर, आदि) के साथ बनाने की योजना बना रहे हैं, तो एक बहु-कॉन्फ़िगरेशन प्रोजेक्ट सबसे अच्छा विकल्प है।
- सहेजें पर क्लिक करें।
आपका प्रोजेक्ट बन जाने के बाद, आपका वेब ब्राउज़र आपके प्रोजेक्ट के लिए मुख्य पृष्ठ प्रदर्शित करता है।
संशोधन नियंत्रण और ग्रेडल बिल्ड चरण जोड़ें
यह खंड वर्णन करता है कि जेनकींस को गिटहब जैसे पुनरीक्षण नियंत्रण प्रणालियों के साथ कैसे एकीकृत किया जाए, और स्रोत कोड से एपीके पैकेज बनाने के लिए ग्रैडल बिल्ड चरणों को कैसे जोड़ा जाए।
गिटहब और अन्य संशोधन नियंत्रण प्रणालियों के साथ एकीकरण
यदि आप अपने ऐप के स्रोत कोड को प्रबंधित करने के लिए गिटहब या अन्य संशोधन नियंत्रण प्रणाली का उपयोग करते हैं, तो आप जेनकींस को स्वचालित बिल्ड चलाने के लिए कॉन्फ़िगर कर सकते हैं और हर बार आपके ऐप में अपडेट चेक किए जाने पर परीक्षण चला सकते हैं। आप समय-समय पर बिल्ड चलाने के लिए जेनकींस को भी कॉन्फ़िगर कर सकते हैं।
जेनकिंस में बिल्ड को कॉन्फ़िगर करने के बारे में जानने के लिए, स्वचालित बिल्ड कॉन्फ़िगर करना देखें।
एपीके पैकेज के पुनर्निर्माण के लिए ग्रैडल बिल्ड स्टेप्स जोड़ना
यदि आप अपने ऐप के स्रोत कोड को प्रबंधित करने के लिए एक पुनरीक्षण नियंत्रण प्रणाली का उपयोग करते हैं, तो आपको जेनकींस द्वारा आपके पुनरीक्षण नियंत्रण प्रणाली से स्रोत कोड डाउनलोड करने पर हर बार नई एपीके बायनेरिज़ बनाने के लिए एक ग्रैडल बिल्ड चरण शामिल करना होगा।
अपने एप्लिकेशन की मुख्य निर्देशिका में निम्न कमांड चलाने के लिए एक बिल्ड चरण जोड़ें:
./gradlew :app:assembleDebug ./gradlew :app:assembleDebugAndroidTest
टेस्ट लैब के साथ परीक्षण करते समय ग्रैडल द्वारा बनाए गए एपीके पैकेज का उपयोग करने के लिए एक बिल्ड स्टेप जोड़ें। आप नीचे दिए गए शेल स्क्रिप्ट उदाहरण में इस पथ का उपयोग <local_server_path> के रूप में कर सकते हैं, जहां <AppFolder> आपके ऐप के लिए Android स्टूडियो प्रोजेक्ट फ़ोल्डर है:
<AppFolder>/app/build/outputs/apk
Jenkins में टेस्ट लैब बिल्ड चरण जोड़ें
अब आप gcloud कमांड लाइन का उपयोग करके टेस्ट लैब चलाने के लिए Jenkins में एक बिल्ड स्टेप जोड़ने के लिए तैयार हैं।
एक gcloud बिल्ड स्टेप जोड़ने के लिए
- अपने प्रोजेक्ट के मुख्य पृष्ठ से, कॉन्फ़िगर करें पर क्लिक करें।
प्रोजेक्ट कॉन्फ़िगरेशन पृष्ठ पर, बिल्ड सेक्शन तक नीचे स्क्रॉल करें, और फिर ऐड बिल्ड स्टेप मेनू से एक्ज़ीक्यूट शेल चुनें।
Jenkins Execute शेल कमांड विंडो में, निम्न दर्ज करें, सर्वर पर नमूना ऐप के पथ के लिए <local_server_path> , अपने ऐप के APK के लिए <app_apk> और अपने ऐप के परीक्षण 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
कमांड भी जोड़ सकते हैं। अधिक जानने के लिए, Firebase टेस्ट लैब परिणामों का विश्लेषण देखें।
अन्य CI सिस्टम के साथ निरंतर एकीकरण
अन्य CI सिस्टम के साथ Firebase टेस्ट लैब का उपयोग करने का तरीका जानने के लिए, उनके डॉक्स देखें: