कंटिन्यूअस इंटिग्रेशन (सीआई) सिस्टम की मदद से जांच शुरू करें

किसी भी कंटिन्यूअस इंटिग्रेशन (सीआई) सिस्टम का इस्तेमाल करके, अपना ऐप्लिकेशन डेवलप करते समय, Firebase टेस्ट लैब का इस्तेमाल किया जा सकता है. कंटिन्यूअस इंटिग्रेशन सिस्टम की मदद से, हर बार अपने ऐप्लिकेशन के सोर्स कोड में होने वाले अपडेट को देखते समय, आपका ऐप्लिकेशन अपने-आप बनने और टेस्ट करने की सुविधा मिलती है.

जेनकिन्स सीआई के साथ Firebase टेस्ट लैब का इस्तेमाल करना

इस सेक्शन में बताया गया है कि Jenकिन्स CI के साथ टेस्ट लैब का इस्तेमाल कैसे किया जाए.

ज़रूरी शर्तें

जेनकिन्स के साथ Firebase टेस्ट लैब का इस्तेमाल करने से पहले, आपको ये चरण पूरे करने होंगे:

1. gcloud सेट अप करें. Firebase प्रोजेक्ट बनाने और अपने लोकल Google Cloud SDK एनवायरमेंट को कॉन्फ़िगर करने के लिए, gcloud कमांड लाइन से Firebase टेस्ट लैब का इस्तेमाल करना में दिए गए निर्देशों का पालन करें.

2. सेवा खाता बनाएं और उसे अनुमति दें. सेवा खातों पर, स्पैम की जांच या कैप्चा प्रॉम्प्ट लागू नहीं होते. इनकी वजह से, आपके सीआई बिल्ड को ब्लॉक किया जा सकता है. Google Cloud Console में, एडिटर की भूमिका वाला सेवा खाता बनाएं और उसे चालू करें. इसका तरीका जानने के लिए, gcloud auth Activate-service-account दस्तावेज़ देखें.

3. ज़रूरी एपीआई चालू करें. सेवा खाते का इस्तेमाल करके लॉग इन करने के बाद: Google Developers Console एपीआई लाइब्रेरी पेज में, Google Cloud Testing API और Cloud टूल के नतीजों वाले एपीआई को चालू करें. इन एपीआई को चालू करने के लिए, कंसोल के सबसे ऊपर मौजूद खोज बॉक्स में, एपीआई के इन नामों को टाइप करें. इसके बाद, एपीआई के खास जानकारी देने वाले पेज पर जाकर, एपीआई को चालू करें पर क्लिक करें.

जेनकिन्स को इंस्टॉल और सेट अप करना

Linux या Windows पर, जेनकिंस सीआई को इंस्टॉल और सेट अप किया जा सकता है. इस गाइड में दी गई कुछ जानकारी, Linux पर जेनकिन्स CI इंस्टॉल करने और उसे चलाने के बारे में है. इसमें फ़ाइल पाथ में स्लैश (/) का इस्तेमाल करना भी शामिल है.

Linux या Windows पर चलने वाले कंप्यूटर पर जेनकिन्स डाउनलोड और इंस्टॉल करने के लिए, Jenकिन्स इंस्टॉल करना में दिए गए निर्देशों का पालन करें. जेनकिन्स को इंस्टॉल करने के बाद, सेटअप पूरा करने और उसे ऐक्सेस करने के लिए जेनकिंस को शुरू करना और ऐक्सेस करना पर दिए गए निर्देशों का पालन करें.

वैश्विक सुरक्षा सेटिंग कॉन्फ़िगर करें

पहली बार इंस्टॉल किए जाने पर, जेनकिन्स के पास उपयोगकर्ता की पुष्टि करने और ऐक्सेस कंट्रोल कॉन्फ़िगर करने की सुविधा नहीं होती. Firebase टेस्ट लैब के साथ जेनकिन्स का इस्तेमाल करने से पहले, ऐक्सेस कंट्रोल लागू करने और उपयोगकर्ताओं की पुष्टि करने के लिए ग्लोबल सुरक्षा सेटिंग कॉन्फ़िगर करें.

वैश्विक सुरक्षा सेटिंग कॉन्फ़िगर करने के लिए

1. अपने सर्वर पर जेनकिन्स डैशबोर्ड पर जाएँ. ऐसा करने के लिए, http://<servername>:8080 पर ब्राउज़ करें. यहां <servername>, उस कंप्यूटर का नाम है जिस पर आपने जेनकिन्स इंस्टॉल किया है.
2. जेनकिंस डैशबोर्ड पर, Jenकिन्स को प्रबंधित करें पर क्लिक करें. इसके बाद, वैश्विक सुरक्षा कॉन्फ़िगर करें पर क्लिक करें.
3. ग्लोबल सिक्योरिटी कॉन्फ़िगर करें पेज पर, सुरक्षा चालू करें पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.

जेनकिन्स के लिए सुरक्षा सेटिंग कॉन्फ़िगर करने के बारे में ज़्यादा जानकारी के लिए, क्विक और आसान सिक्योरिटी, स्टैंडर्ड सिक्योरिटी सेटअप, और जैनकिन्स को सुरक्षित करना देखें.

जेनकिन्स प्रोजेक्ट बनाना

इसके बाद, Firebase टेस्ट लैब की मदद से अपने ऐप्लिकेशन का लगातार इंटिग्रेशन टेस्टिंग करने के लिए एक प्रोजेक्ट बनाएं.

जेनकिन्स प्रोजेक्ट बनाने के लिए

1. अपने सर्वर पर जेनकिन्स डैशबोर्ड पर जाएँ. ऐसा करने के लिए, http://<servername>:8080 पर ब्राउज़ करें. यहां <servername>, उस कंप्यूटर का नाम है जिस पर आपने जेनकिन्स इंस्टॉल किया है.
2. जेनकिंस डैशबोर्ड पर, नया आइटम पर क्लिक करें.
3. आइटम का नाम फ़ील्ड में, अपने प्रोजेक्ट का नाम लिखें:
   • सिंगल बिल्ड कॉन्फ़िगरेशन का इस्तेमाल करने वाला प्रोजेक्ट बनाने के लिए, Freestyle प्रोजेक्ट चुनें.
   • कई अलग-अलग बिल्ड कॉन्फ़िगरेशन पर चलने वाला प्रोजेक्ट बनाने के लिए, मल्टी-कॉन्फ़िगरेशन प्रोजेक्ट बनाएं चुनें. अगर आपको अपने ऐप्लिकेशन को अलग-अलग तरह के बिल्ड कॉन्फ़िगरेशन (एक से ज़्यादा स्थान-भाषा, कई Android एपीआई लेवल वगैरह) के साथ बनाना है, तो मल्टी-कॉन्फ़िगरेशन प्रोजेक्ट सबसे सही विकल्प होगा.
4. सेव करें पर क्लिक करें.

प्रोजेक्ट बनने के बाद, आपका वेब ब्राउज़र आपके प्रोजेक्ट का मुख्य पेज दिखाता है.

रिविज़न कंट्रोल और Gradle बिल्ड चरण जोड़ें

इस सेक्शन में बताया गया है कि जेनकिन्स को GitHub जैसे रिविज़न कंट्रोल सिस्टम के साथ कैसे इंटिग्रेट किया जाता है. साथ ही, सोर्स कोड से APK पैकेज बनाने के लिए, Gradle बिल्ड चरणों को जोड़ने का तरीका क्या है.

GitHub और अन्य रिविज़न कंट्रोल सिस्टम के साथ इंटिग्रेट करना

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

जेनकिन्स में बिल्ड कॉन्फ़िगर करने के बारे में जानने के लिए, अपने-आप होने वाले बिल्ड कॉन्फ़िगर करना देखें.

APK पैकेज को फिर से बनाने के लिए, Gradle बिल्ड के तरीके जोड़ना

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

1. अपने ऐप्लिकेशन की मुख्य डायरेक्ट्री में इन निर्देशों को चलाने के लिए, एक बिल्ड स्टेप जोड़ें:

   ./gradlew :app:assembleDebug
   ./gradlew :app:assembleDebugAndroidTest
   

2. टेस्ट लैब से टेस्ट करते समय, Gradle के बनाए गए APK पैकेज का इस्तेमाल करने के लिए, एक बिल्ड चरण जोड़ें. नीचे दिए गए शेल स्क्रिप्ट के उदाहरण में, इस पाथ का इस्तेमाल <local_server_path> के तौर पर किया जा सकता है. इसमें <Appफ़ोल्डर> आपके ऐप्लिकेशन का Android Studio प्रोजेक्ट फ़ोल्डर है:

   <AppFolder>/app/build/outputs/apk
   

जेनकिन्स में टेस्ट लैब बिल्ड जोड़ने का तरीका जोड़ें

अब आप gcloud कमांड लाइन का इस्तेमाल करके टेस्ट लैब चलाने के लिए जेनकिन्स में एक बिल्ड स्टेप जोड़ने के लिए तैयार हैं.

gcloud बिल्ड जोड़ने का तरीका

1. अपने प्रोजेक्ट के मुख्य पेज पर, कॉन्फ़िगर करें पर क्लिक करें.

2. प्रोजेक्ट कॉन्फ़िगरेशन पेज पर, नीचे की ओर स्क्रोल करके बिल्ड सेक्शन पर जाएं. इसके बाद, बिल्ड का चरण जोड़ें मेन्यू से शेल लागू करें चुनें.

3. Jenins exell command विंडो में, सर्वर पर सैंपल ऐप्लिकेशन के पाथ के लिए <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
   

टेस्ट के नतीजों का विश्लेषण करना

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

अन्य सीआई सिस्टम के साथ लगातार इंटिग्रेशन

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

• बिटराइज़
• सर्कल का सीआई

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