OmniLab Android टेस्ट स्टेशन

OmniLab ATS एक टेस्टिंग टूल है. इसका इस्तेमाल करके, Android डेवलपर और टेस्ट इंजीनियर, स्टैंडर्ड Android टेस्ट सुइट चलाने के लिए यूज़र इंटरफ़ेस का इस्तेमाल कर सकते हैं. जैसे, Android Compatibility Test Suite (CTS). यह टूल, Trade Federation (TF) और Google Mobly जैसे अलग-अलग टेस्ट फ़्रेमवर्क के लिए वेब इंटरफ़ेस के तौर पर काम करता है. इससे, आपको कम सेटअप के साथ टेस्ट डिवाइसों के सेट पर सीटीएस और कई डिवाइसों के टेस्ट चलाने की सुविधा मिलती है. साथ ही, लगातार टेस्ट चलाने के लिए शेड्यूल सेट अप करने की सुविधा भी मिलती है.

OmniLab ATS सेट अप करना

इस सेक्शन में, OmniLab ATS को इंस्टॉल और सेट अप करने का तरीका बताया गया है.

OmniLab ATS, इन जगहों से सोर्स कोड का इस्तेमाल करता है:

• OmniLab ATS का सोर्स कोड
• TradeFed क्लस्टर का सोर्स कोड

OmniLab ATS इंस्टॉल करना

चलाए जा रहे टेस्ट सुइट के लिए, हार्डवेयर और सॉफ़्टवेयर की सभी ज़रूरी शर्तों का पालन करें.

सीटीएस की ज़रूरी शर्तें, source.android.com पर देखी जा सकती हैं.

OmniLab ATS के लिए, हार्डवेयर से जुड़ी कोई अन्य ज़रूरी शर्त नहीं है. हालांकि, हमारा सुझाव है कि शुरुआत के लिए, सीटीएस होस्ट की ज़रूरी शर्त का इस्तेमाल करें.

OmniLab ATS को इंस्टॉल करने के दो तरीके हैं:

• इंस्टॉलर प्रोग्राम चलाएं.
• इसे मैन्युअल तरीके से इंस्टॉल करें. इसके लिए, आपको कई प्रोग्राम और संसाधन इंस्टॉल करने होंगे.

इंस्टॉलर प्रोग्राम की मदद से इंस्टॉल करना

Ubuntu 20.04 और उसके बाद के वर्शन पर, इंस्टॉलर प्रोग्राम, OmniLab ATS को चलाने के लिए ज़रूरी सभी प्रोग्राम और संसाधनों को इंस्टॉल और कॉन्फ़िगर करता है.

इंस्टॉल प्रोग्राम का इस्तेमाल करने के लिए:

1. इंस्टॉलर प्रोग्राम चलाने के लिए:

   curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
   

2. OmniLab ATS CLI के इंस्टॉल किए गए वर्शन की जांच करने के लिए, mtt version चलाएं.

मैन्युअल तरीके से इंस्टॉल करना

Docker इंस्टॉल करना

1. अपनी Linux मशीन पर, Docker Community Edition (CE) इंस्टॉल करने के लिए दिए गए निर्देशों का पालन करें.

2. रूट उपयोगकर्ता के तौर पर Docker को मैनेज करने के लिए, इंस्टॉल करने के बाद के चरणों का पालन करें.

3. अनुमति में किए गए बदलावों को लागू करने के लिए, आपको अपनी टर्मिनल विंडो को रीस्टार्ट करना पड़ सकता है या साइन आउट करके फिर से साइन इन करना पड़ सकता है.

Python 3 इंस्टॉल करना

OmniLab ATS CLI की पुष्टि, Python के 3.7 से 3.11 वर्शन के लिए की गई है.

Ubuntu 16.04 या उससे पहले के वर्शन के लिए, सबसे पहले Python 3 के लिए रिपॉज़िटरी जोड़ें. इसके लिए, इनमें से कोई एक तरीका अपनाएं:

• इस निर्देश को चलाएं:

  sudo add-apt-repository ppa:deadsnakes/ppa
  

• सोर्स से रिपॉज़िटरी बनाएं और इंस्टॉल करें.

Python 3 इंस्टॉल करने के लिए, ये कमांड चलाएं:

sudo apt-get update
sudo apt install python3 python3-distutils

Python 3 का कोई खास वर्शन (उदाहरण के लिए, 3.10) इंस्टॉल करने के लिए, इन कमांड का इस्तेमाल करें:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

OmniLab ATS CLI पाना

कमांड-लाइन इंटरफ़ेस (सीएलआई) पैकेज यहां डाउनलोड करें.

OmniLab ATS शुरू करना

OmniLab ATS को इस कमांड से शुरू करें:

mtt start

पहली बार यूज़र इंटरफ़ेस (यूआई) शुरू करने पर, उसे दिखने में कुछ मिनट लग सकते हैं. सीएलआई, ब्राउज़र में यूआई को ऐक्सेस करने के लिए एक वेब यूआरएल दिखाता है. डिफ़ॉल्ट रूप से, वेब यूआरएल localhost:8000 होता है. अगर ज़रूरी हो, तो --port फ़्लैग की मदद से, स्टार्टअप के समय डिफ़ॉल्ट पोर्ट बदला जा सकता है.

अगर कोई नया वर्शन उपलब्ध है, तो उसे मौजूदा वर्शन पर अपडेट किया जा सकता है. नई रिलीज़ के बारे में जानने के लिए, रिलीज़ नोट देखें.

मौजूदा वर्शन पर अपडेट करने के लिए, यह चलाएं:

mtt start --force_update

ऐप्लिकेशन को बंद करने के लिए, यह चलाएं:

mtt stop

अन्य निर्देशों की सूची देखने के लिए, इनका इस्तेमाल करें:

mtt --help

डेटाबेस का बैक अप लेना और उसे वापस लाना

OmniLab ATS के डेटाबेस का बैक अप लेने के लिए, ऐप्लिकेशन को बंद करें और यह कमांड चलाएं. इससे, मौजूदा डेटाबेस का बैक अप आपकी होम डायरेक्ट्री में mtt-backup.tar नाम की TAR फ़ाइल में ले लिया जाएगा:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

ऐप्लिकेशन को वापस लाने के लिए, ऐप्लिकेशन शुरू करने से पहले यह कमांड चलाएं:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

सेटअप विज़ार्ड

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

कॉन्फ़िगरेशन का बैकअप वापस लाना

अगर आपके पास किसी दूसरे OmniLab ATS होस्ट से कॉन्फ़िगरेशन फ़ाइल का बैक अप है, तो उस होस्ट से बदले गए किसी भी कॉन्फ़िगरेशन को कॉपी करने के लिए, फ़ाइल को अपलोड किया जा सकता है. इसके लिए, फ़ाइल अपलोड करें बटन पर क्लिक करें.

पहली इमेज. कॉन्फ़िगरेशन का बैकअप रीस्टोर करना.

डिफ़ॉल्ट सेवा खाता सेट करना

आपके पास ऐसा सर्विस खाता सेट करने का विकल्प है जिसका इस्तेमाल OmniLab ATS आपके संसाधनों (उदाहरण के लिए, Google Cloud Storage, Google Drive) को ऐक्सेस करते समय डिफ़ॉल्ट रूप से करता है. अपने सेवा खाते की पुष्टि करने के लिए, सेवा खाते की कुंजी अपलोड करें पर क्लिक करें. इसके बाद, अपने सेवा खाते की JSON कुंजी फ़ाइल चुनें.

दूसरी इमेज. सेवा खाता सेट करना.

सेवा खाते की पुष्टि हो जाने के बाद, खाते का ईमेल पता पेज पर सबसे ऊपर दाएं कोने में दिखता है. सेवा खाता बदलने के लिए, खाते के नाम पर क्लिक करें. इसके बाद, मौजूदा डिफ़ॉल्ट खाता हटाएं और सेवा खाते की नई पासकोड अपलोड करें.

तीसरी इमेज. सेवा खाता बदलना.

कॉन्फ़िगरेशन सेट इंपोर्ट करना

कॉन्फ़िगरेशन सेट, टेस्ट सुइट चलाने के लिए कॉन्फ़िगरेशन का बंडल होता है. इसमें डिवाइस से जुड़ी कार्रवाइयां और बिल्ड चैनल शामिल होते हैं. कॉन्फ़िगरेशन सेट, किसी खास Google Cloud Storage (जीसीएस) बकेट में होस्ट किए जाते हैं. अपने Google खाते से GCS बिल्ड चैनल की पुष्टि करने के बाद, आपको उन सभी कॉन्फ़िगरेशन सेट की सूची दिखती है जो आपके लिए उपलब्ध हैं.

टेस्ट स्टेशन के होस्ट में जोड़ने के लिए, कोई भी कॉन्फ़िगरेशन सेट चुनें और चुने गए इंपोर्ट करें पर क्लिक करें.

चौथी इमेज. कॉन्फ़िगरेशन सेट इंपोर्ट करना.

वाई-फ़ाई की सेटिंग शामिल करना

सीटीएस के कुछ टेस्ट के लिए, आपके डिवाइस को वाई-फ़ाई हॉटस्पॉट से कनेक्ट करना ज़रूरी है. अपना वाई-फ़ाई नेटवर्क चुनने के लिए, वाई-फ़ाई SSID और वाई-फ़ाई पीएसके डालें. हालांकि, वाई-फ़ाई पीएसके डालना ज़रूरी नहीं है.

पांचवीं इमेज. वाई-फ़ाई हॉटस्पॉट की सेटिंग.

सेटअप विज़र्ड पूरा करने के बाद, पेज फिर से लोड हो जाता है और उसमें लागू की गई नई सेटिंग दिखती हैं.

कोई डिवाइस कनेक्ट करें

किसी डिवाइस को टेस्टिंग के लिए इस्तेमाल करने के लिए, यूएसबी डीबगिंग की सुविधा चालू होनी चाहिए. डीबग करने की सुविधा चालू करने के लिए:

1. 'डेवलपर के लिए सेटिंग और टूल' चालू करना और डिबग करना में दिए गए निर्देशों का पालन करें.

2. अगर आपको कस्टम ADB पासकोड के साथ पहले से लोड किए गए टेस्ट Android बिल्ड का इस्तेमाल करना है, तो कस्टम .adb_key फ़ाइलों को ~/.android/ डायरेक्ट्री में डालें.

   ये फ़ाइलें अपने-आप लोड हो जाती हैं और उन डिवाइसों के लिए यूएसबी डिबगिंग की सुविधा अपने-आप चालू करने के लिए, ADB को भेज दी जाती हैं जिन पर ये बिल्ड चल रहे हैं.

3. यूएसबी का इस्तेमाल करके, डिवाइस को होस्ट मशीन से कनेक्ट करें.

   वेब इंटरफ़ेस को रीफ़्रेश करने के एक मिनट के अंदर, डिवाइस OmniLab ATS डिवाइस टैब में दिखने लगता है. इस टैब पर, डिवाइसों की स्थिति भी देखी जा सकती है.

   

   छठी इमेज. किसी डिवाइस को कनेक्ट करना.

डिवाइस की अलग-अलग स्थितियां ये हैं:

• उपलब्ध है - डिवाइस कनेक्ट है और जांच करने के लिए तैयार है.
• असाइन किया गया - डिवाइस कनेक्ट है और टेस्ट कर रहा है. हर डिवाइस पर एक बार में सिर्फ़ एक टेस्ट चलाया जा सकता है. इसलिए, नया टेस्ट चलाने से पहले, डिवाइस पर मौजूदा टेस्ट पूरा हो जाना चाहिए.

परीक्षण चलाना

कोई टेस्ट चुनना

OmniLab ATS में, पहले से बंडल किए गए सीटीएस कॉन्फ़िगरेशन का एक सेट शामिल होता है. इनमें से किसी एक टेस्ट को चलाने के लिए, टेस्ट सुइट टैब पर जाएं और चुने गए टेस्ट के लिए टेस्ट चलाएं पर क्लिक करें.

सातवीं इमेज. कोई टेस्ट चुनना.

टेस्ट में बदलाव करने या नए टेस्ट जोड़ने के लिए, टेस्ट जोड़ना लेख पढ़ें.

टेस्ट रन कॉन्फ़िगर करना

इस खास टेस्ट रन के लिए इस्तेमाल करने के लिए, पैरामीटर में बदलाव करें. ज़्यादातर पैरामीटर, चुने गए टेस्ट कॉन्फ़िगरेशन में तय की गई वैल्यू के साथ पहले से भरे होते हैं.

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

आठवीं इमेज. टेस्ट रन को कॉन्फ़िगर करना.

टेस्ट रन के पैरामीटर ये हैं:

• नाम - उस टेस्ट सुइट का नाम जिसे आपको चलाना है.
• रन की संख्या - शेड्यूल किए जाने पर, इस टेस्ट को कितनी बार चलाया जाना चाहिए. टेस्ट रन, ट्रेड फ़ेडरेशन का इस्तेमाल करके शेड्यूल किए जाते हैं. अगर क्षमता है, तो यह 20 टेस्ट रन एक साथ चला सकता है.
• फिर से कोशिश करने की ज़्यादा से ज़्यादा संख्या - अगर कम से कम एक टेस्ट पूरा नहीं होता है, तो टेस्ट को फिर से चलाने की ज़्यादा से ज़्यादा संख्या. आम तौर पर, इसे पूरे सीटीएस रन के लिए, चार से छह बार फिर से कोशिश करने के लिए सेट किया जाता है, ताकि गड़बड़ी वाले टेस्ट को मैनेज किया जा सके.
• सूची में शामिल होने में लगने वाला समय - अगर कोई टेस्ट रन सूची में शामिल है स्थिति में बहुत देर तक बना रहता है, तो वह अपने-आप रद्द हो जाता है. यहां बताएं कि रद्द करने से पहले, कितने समय तक इंतज़ार करना है. डिफ़ॉल्ट रूप से, यह रिपोर्ट हर 24 घंटे में अपलोड की जाती है.

• Command - टेस्ट सुइट चलाने के लिए निर्देश. यहां अतिरिक्त कमांड लाइन आर्ग्युमेंट डाले जा सकते हैं. उदाहरण के लिए, CTS 8.1 में कोई खास मॉड्यूल चलाएं:

  cts-suite -m ShortModuleName
  

• फिर से कोशिश करने का निर्देश - किसी टेस्ट सुइट को फिर से चलाने का निर्देश. यहां कमांड लाइन के अन्य आर्ग्युमेंट जोड़े जा सकते हैं. उदाहरण के लिए, CTS 8.1 में सिर्फ़ किसी खास मॉड्यूल को फिर से चलाने के लिए, इनका इस्तेमाल करें:

  cts --retry 0 -m ShortModuleName
  

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

• पिछला टेस्ट रन - अगर आपको पिछला टेस्ट रन फिर से चलाना है, तो:

  • स्थानीय - अगर रन को मौजूदा होस्ट पर शुरू किया गया था, तो टेस्ट रन की जानकारी देखते समय दिखने वाला टेस्ट रन आईडी डालें.

    

    नौवीं इमेज. स्थानीय भाषा में पिछला टेस्ट रन.

  • रिमोट - अगर टेस्ट किसी दूसरे होस्ट पर चलाया गया था, तो जांच के नतीजों की फ़ाइल अपलोड करें. इसके लिए, रिमोट चुनें, जांच के नतीजों की फ़ाइल अपलोड करें पर क्लिक करें, और अपने लोकल स्टोरेज से कोई फ़ाइल चुनें.

    

    10वीं इमेज. पिछले टेस्ट को रिमोट से चलाना.

डिवाइस चुनें

टेस्ट सुइट चलाने के लिए डिवाइसों को चुनने के लिए, चेकबॉक्स पर क्लिक करें. चुने गए डिवाइसों की संख्या के हिसाब से, स्hard की संख्या अपने-आप बदल जानी चाहिए.

11वीं इमेज. डिवाइस चुनना.

डिवाइस के सीरियल के अलावा किसी अन्य एट्रिब्यूट के हिसाब से डिवाइस चुनने के लिए, "डिवाइस की जानकारी" को मैन्युअल रूप से डाला जा सकता है. उदाहरण के लिए, ऐसे तीन डिवाइस चुनने के लिए जिनका प्रॉडक्ट नाम "bramble" है, यह डालें:

product:bramble;product:bramble;product:bramble

इन एट्रिब्यूट का इस्तेमाल किया जा सकता है:

• build_id
• device_serial
• device_type
• hostname
• प्रॉडक्ट
• product_variant
• sim_state

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

डिवाइस की कार्रवाइयां जोड़ना

डिवाइस ऐक्शन, ऐसी स्क्रिप्ट होती हैं जिन्हें हर टेस्ट रन से पहले चलाया जा सकता है. डिवाइस की कुछ कार्रवाइयां पहले से कॉन्फ़िगर होती हैं. जैसे, फ़्लैश करना और रीबूट करना. डिवाइस से जुड़ी नई कार्रवाइयां बनाने के लिए, डिवाइस से जुड़ी नई कार्रवाई बनाएं लेख पढ़ें.

12वीं इमेज. डिवाइस की कार्रवाइयां.

टेस्ट रन में डिवाइस ऐक्शन जोड़ने के लिए, नई कार्रवाई जोड़ें पर क्लिक करें. इसके बाद, जोड़नी जाने वाली कार्रवाइयों के लिए चेकबॉक्स चुनें और कार्रवाई जोड़ें पर क्लिक करें. डिवाइस पर की जाने वाली कार्रवाइयां, क्रम से की जाती हैं. कार्रवाइयों को खींचकर छोड़कर, उनका क्रम बदला जा सकता है.

13वीं इमेज. कार्रवाइयों का क्रम बदलना.

टेस्ट के लिए संसाधन सेट करना

टेस्ट संसाधन, टेस्ट रन को लागू करने के लिए ज़रूरी फ़ाइलें होती हैं. उदाहरण के लिए, सीटीएस को चलाने के लिए android-cts*.zip फ़ाइल की ज़रूरत होती है. साथ ही, किसी डिवाइस को फ़्लैश करने के लिए, आपको बिल्ड इमेज देनी होती है.

टेस्ट सुइट की ZIP फ़ाइल के लिए डाउनलोड करने का यूआरएल, डिफ़ॉल्ट रूप से पार्टनर को दिए गए Google Drive के लिंक पर होना चाहिए. ब्राउज़ करें पर क्लिक करके, कोई दूसरी फ़ाइल चुनी जा सकती है. पॉप-अप विंडो में, फ़ाइल डाउनलोड करने का लिंक डाला जा सकता है. इसके अलावा, पुष्टि किए गए किसी बिल्ड चैनल से फ़ाइल का इस्तेमाल किया जा सकता है या लोकल स्टोरेज में इस्तेमाल करने के लिए कोई फ़ाइल अपलोड की जा सकती है.

14वीं इमेज. संसाधनों की जांच करें.

वेब यूआरएल के हिसाब से टेस्ट रिसॉर्स चुनने के लिए, यहां पॉप-अप विंडो दी गई है. डाउनलोड करने के लिए यूआरएल लिंक डालें और चुनें बटन पर क्लिक करके, चुने गए विकल्प की पुष्टि करें.

15वीं इमेज. टेस्ट रिसॉर्स सिलेक्टर - वेब यूआरएल.

अगर आपने Google Drive, Google Cloud Storage (GCS) या किसी दूसरे चैनल पर संसाधन अपलोड किए हैं, तो उस चैनल के टैब पर जाकर भी संसाधन चुने जा सकते हैं. Google Drive से कोई संसाधन चुनने का उदाहरण यहां दिया गया है.

16वीं इमेज. रिसॉर्स सिलेक्टर की जांच करें - Google Drive.

फ़ाइलों को चुनने के अलावा, फ़ाइल का नाम फ़ील्ड में वाइल्डकार्ड वर्ण भी इस्तेमाल किए जा सकते हैं. दस्तावेज़ यहां देखे जा सकते हैं.

17वीं इमेज. रिसॉर्स चुनने वाले टूल की जांच करना - वाइल्डकार्ड पैटर्न के साथ काम करना.

OmniLab ATS के लोकल फ़ाइल स्टोरेज से भी कोई फ़ाइल चुनी जा सकती है. इस स्टोरेज में फ़ाइलें अपलोड की जा सकती हैं या सीधे तौर पर लोकल फ़ाइलों और डायरेक्ट्री का इस्तेमाल किया जा सकता है.

18वीं इमेज. रिसॉर्स चुनने वाले टूल की जांच करना - लोकल फ़ाइल स्टोर.

फिर से चलाने के कॉन्फ़िगरेशन जोड़ना

प्राइमरी रन पूरा होने और उसके नतीजे लोड होने के बाद, फिर से चलाए जाने वाले प्रयोग शेड्यूल किए जा सकते हैं. हालांकि, इनमें अलग-अलग डिवाइस, कार्रवाइयों या संसाधनों का इस्तेमाल किया जा सकता है.

19वीं इमेज. फिर से चलाने के कॉन्फ़िगरेशन जोड़ना.

टेस्ट रन शुरू करना

टेस्ट रन के लिए ज़रूरी जानकारी डालने के बाद, टेस्ट रन शुरू करें पर क्लिक करें. अगर सभी जानकारी मान्य है, तो टेस्ट रन शुरू हो जाता है. साथ ही, आपको टेस्ट रन की जानकारी और प्रोग्रेस देखने के लिए, एक पेज पर रीडायरेक्ट कर दिया जाता है.

20वीं इमेज. टेस्ट रन शुरू करना.

टेस्ट प्लान बनाना

टेस्ट प्लान का इस्तेमाल, समय-समय पर शेड्यूल किए गए टेस्ट रन बनाने के लिए किया जाता है. उदाहरण के लिए, हर दिन शाम 5 बजे CTS 9.0 चलाना. नया टेस्ट प्लान बनाने के लिए, नया टेस्ट प्लान बनाएं पर क्लिक करें.

21वीं इमेज. टेस्ट प्लान बनाना.

टेस्ट प्लान कॉन्फ़िगर करना

टेस्ट प्लान का नाम और ऐसे लेबल डालें जिन्हें जोड़ना है. इसके बाद, इस्तेमाल करने के लिए कोई शेड्यूल चुनें.

• मैन्युअल - टेस्ट प्लान, टेस्ट रन सिर्फ़ तब बनाता है, जब कोई उपयोगकर्ता टेस्ट प्लान की सूची वाले पेज पर, टेस्ट प्लान चलाएं पर क्लिक करता है.
• पीरियोडिक - टेस्ट प्लान, चुने गए पीरियोडिक शेड्यूल पर टेस्ट रन को अपने-आप शेड्यूल करता है. उदाहरण के लिए, हर दिन शाम 5 बजे टेस्ट रन शेड्यूल करना.
• पसंद के मुताबिक - टेस्ट प्लान, डाले गए क्रॉन एक्सप्रेशन के आधार पर, टेस्ट रन को अपने-आप शेड्यूल करता है. उदाहरण के लिए, हर दिन शाम 5:00 बजे टेस्ट रन शेड्यूल करने के लिए, क्रॉन एक्सप्रेशन 0 17 * * * है.

22वीं इमेज. टेस्ट प्लान कॉन्फ़िगर करना.

टेस्ट सुइट जोड़ना

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

23वीं इमेज. टेस्ट रन को कॉन्फ़िगर करना.

डिवाइस की कार्रवाइयां जोड़ना

हर टेस्ट रन से पहले, डिवाइस पर की जाने वाली उन कार्रवाइयों को जोड़ें जिन्हें आपको लागू करना है. ज़्यादा जानकारी के लिए, डिवाइस ऐक्शन जोड़ना लेख पढ़ें.

24वीं इमेज. डिवाइस की कार्रवाइयां जोड़ना.

टेस्ट के लिए संसाधन सेट करना

टेस्ट प्लान में टेस्ट रिसॉर्स जोड़ना, उन्हें अलग-अलग टेस्ट रन में जोड़ने जैसा ही है. ज़्यादा जानकारी के लिए, टेस्ट के लिए संसाधन सेट करना लेख पढ़ें.

25वीं इमेज. टेस्ट के लिए संसाधन सेट करना.

टेस्ट रन देखना

टेस्ट रन की सूची

टेस्ट रन पेज पर, शेड्यूल किए गए टेस्ट रन की सूची देखें. टेस्ट रन के बारे में ज़्यादा जानकारी देखने के लिए, देखें पर क्लिक करें.

फ़िल्टर बार में कोई स्ट्रिंग डालकर और Enter बटन दबाकर भी सूची को फ़िल्टर किया जा सकता है. एक से ज़्यादा फ़िल्टर का इस्तेमाल करने के लिए, उन्हें कॉमा से अलग करें. यह फ़िल्टर, उन सभी पंक्तियों को दिखाता है जिनमें किसी कॉलम में सटीक टेक्स्ट (सबस्ट्रिंग मैच नहीं) शामिल होता है. हालांकि, इसमें स्थिति और बनाया गया कॉलम शामिल नहीं होता.

खाली फ़िल्टर सभी पंक्तियां दिखाता है. फ़िलहाल, खाली वैल्यू वाली पंक्तियों को फ़िल्टर करने का कोई तरीका नहीं है.

26वीं इमेज. टेस्ट रन की सूची.

टेस्ट रन की जानकारी

यहां टेस्ट रन की जानकारी देखी जा सकती है. जैसे, स्टेटस, लॉग, और नतीजे.

27वीं इमेज. टेस्ट रन की जानकारी.

टेस्ट रन की स्थिति

टेस्ट रन की प्रोग्रेस, स्टेटस सेक्शन में दिखती है. अगर इस प्रोसेस से जुड़ा कोई मैसेज है, जैसे कि डाउनलोड की प्रोग्रेस, रद्द करने की वजह या गड़बड़ी का मैसेज, तो वह भी यहां दिखेगा.

28वीं इमेज. टेस्ट रन की स्थिति.

टेस्ट रन की स्थितियां ये हैं:

• मंज़ूरी बाकी है - ज़रूरी संसाधन डाउनलोड किए जा रहे हैं.
• लाइन में लगा हुआ - डिवाइस उपलब्ध होने पर, टेस्ट चलाया जा सकता है.
• चल रहा है - टेस्ट, डिवाइस पर चल रहा है.
• पूरा हो गया - जांच पूरी हो गई है और इसके नतीजे रिपोर्ट कर दिए गए हैं.
• रद्द किया गया - उपयोगकर्ता ने टेस्ट रद्द कर दिया था या उपलब्ध डिवाइसों को ढूंढने के दौरान टाइम आउट हो गया था.
• गड़बड़ी - कोई गड़बड़ी हुई, जिसकी वजह से टेस्ट नहीं चल सका.

टेस्ट रन रद्द करना

अगर टेस्ट रन पूरा नहीं हुआ है, तो उसे रद्द किया जा सकता है. इसके लिए, रद्द करें पर क्लिक करें. इसके बाद, पुष्टि करने वाले डायलॉग में हां पर क्लिक करें. अगर टेस्ट रन, queue_timeout_seconds फ़ील्ड में बताए गए समय से ज़्यादा समय तक पंक्ति में है स्टेटस में बने रहते हैं, तो वे अपने-आप रद्द हो जाते हैं. चल रहा है स्थिति में टेस्ट रन रद्द करने पर, इसे लागू होने में कुछ मिनट लग सकते हैं.

29वीं इमेज. टेस्ट रन रद्द करना.

टेस्ट रन के नतीजे

टेस्ट रन पूरा होने के बाद, नतीजे इकट्ठा किए जाते हैं और दिखाए जाते हैं. हर रन के लिए ऐरो पर क्लिक करके, ज़्यादा जानकारी देखी जा सकती है. इकट्ठा किए गए टेस्ट आर्टफ़ैक्ट, जैसे कि test_result.xml और test_result_failures.html देखने के लिए, आउटपुट फ़ाइलें देखें पर क्लिक करें.

30वीं इमेज. टेस्ट रन के नतीजे.

लॉग टैब में, लाइव होस्ट और Tradefed लॉग देखे जा सकते हैं.

31वीं इमेज. लॉग टैब.

अलग-अलग मॉड्यूल के नतीजे, 'जांच के नतीजे' टैब में दिखते हैं.

32वीं इमेज. टेस्ट के नतीजे टैब.

टेस्ट रिसॉर्स के तौर पर इस्तेमाल की गई फ़ाइलों को डाउनलोड किया जा सकता है. इसके लिए, टेस्ट रिसॉर्स टैब में जाकर, खोलें पर क्लिक करें.

33वीं इमेज. टेस्ट संसाधन टैब.

create_time जैसे टेस्ट रन की जानकारी देखने के लिए, कॉन्फ़िगरेशन टैब पर जाएं.

34वीं इमेज. कॉन्फ़िगरेशन टैब.

बेहतर सुविधाएं

कॉन्फ़िगरेशन फ़ाइलें मैनेज करना

OmniLab ATS, पहले से तय किए गए विकल्पों को लोड करने के लिए, YAML में लिखी गई कॉन्फ़िगरेशन फ़ाइलों का इस्तेमाल करता है. जैसे, टेस्ट, चैनल बनाना, और डिवाइस ऐक्शन. यहां कॉन्फ़िगरेशन फ़ाइल का उदाहरण दिया गया है:

// example_file.yaml
tests:
- id : android.cts.9_0.arm
  name: CTS 9.0 (ARM)
  test_resource_defs:
  - name: android-cts.zip
    default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
    test_resource_type: TEST_PACKAGE
  command: cts
  env_vars:
  - name: TF_PATH
    value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
  - name: LD_LIBRARY_PATH
    value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
  setup_scripts:
  output_file_patterns:
  - android-cts/logs/latest/.*
  - android-cts/results/latest/.*\.html
  - android-cts/results/latest/compatibility_result\..*
  - android-cts/results/latest/logo.png
  - android-cts/results/latest/test_result.xml
  result_file: test_result.xml
  java_properties:
  - name: CTS_ROOT
    value: ${TF_WORK_DIR}
  context_file_dir: android-cts/results/
  context_file_pattern: '[\d_\.]+\.zip'
  retry_command_line: retry --retry 0
  runner_sharding_args: --shard-count ${TF_SHARD_COUNT}

build_channels:
- id: google_drive
  name: Google Drive
  provider_name: Google Drive

device_actions:
- id: flash
  name: Flash
  test_resource_defs:
  - name: bootloader.img
    test_resource_type: DEVICE_IMAGE
  - name: radio.img
    test_resource_type: DEVICE_IMAGE
  - name: img.zip
    test_resource_type: DEVICE_IMAGE
  tradefed_target_preparers:
  - class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
    option_values:
    - name: work-dir
      values:
      - ${TF_WORK_DIR}
    - name: host-setup-command
      values:
      - adb -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL flash bootloader bootloader.img
      - fastboot -s $SERIAL flash radio radio.img
      - fastboot -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL -w update img.zip
      - adb -s $SERIAL wait-for-device
    - name: host-cmd-timeout
      values:
      - 10m

OmniLab ATS इंस्टेंस सेट अप करने के बाद, अपने कॉन्फ़िगरेशन को फ़ाइल के तौर पर एक्सपोर्ट करके, उसे अन्य उपयोगकर्ताओं के साथ शेयर किया जा सकता है. ऐसा करने के लिए, सेटिंग पेज पर जाएं और सबसे ऊपर दाईं ओर मौजूद, एक्सपोर्ट करें पर क्लिक करें.

35वीं इमेज. कॉन्फ़िगरेशन फ़ाइल मैनेजमेंट.

कॉन्फ़िगरेशन फ़ाइल डाउनलोड होने के बाद, उसे अन्य उपयोगकर्ताओं के साथ शेयर करें. वे अपने OmniLab ATS इंस्टेंस में कॉन्फ़िगरेशन फ़ाइल जोड़ सकते हैं. इसके लिए, इंपोर्ट करें पर क्लिक करके कॉन्फ़िगरेशन फ़ाइल चुनें.

नया डिवाइस ऐक्शन बनाना

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

36वीं इमेज. डिवाइस की कार्रवाइयां टैब.

डिवाइस के लिए कोई नई कार्रवाई जोड़ना

1. नया डिवाइस ऐक्शन पर क्लिक करें.

   

   37वीं इमेज. नए डिवाइस के लिए ऐक्शन बटन.

2. नाम और जानकारी डालें.

   

   38वीं इमेज. डिवाइस ऐक्शन का नाम.

3. टारगेट तैयार करने वाला जोड़ें पर क्लिक करें.

4. ट्रेड फ़ेडरेशन के टारगेट तैयार करने वाले की पूरी क्लास का नाम डालें. उदाहरण के लिए, com.android.tradefed.targetprep.RunHostCommandTargetPreparer.

   

   39वीं इमेज. टारगेट तैयार करने वाला व्यक्ति जोड़ना.

   टारगेट तैयार करने वाले उपलब्ध टूल की सूची, com.android.tradefed.targetprep रेफ़रंस में देखी जा सकती है.

   

   40वीं इमेज. टारगेट तैयार करने वाले की सूची.

5. टारगेट तैयार करने वाले टूल के साथ इस्तेमाल करने के लिए कोई भी विकल्प जोड़ें. उपलब्ध विकल्प देखने के लिए, AOSP में हर टारगेट तैयार करने वाले के सोर्स कोड के लिए, targetprep देखें:

   

   41वीं इमेज. कार्रवाई के विकल्प का उदाहरण.

6. कोई विकल्प जोड़ने के लिए, टारगेट तैयार करने वाले के लिए विकल्प जोड़ें पर क्लिक करें और ज़रूरी वैल्यू डालें.

   

   42वीं इमेज. ऐक्शन कमांड का उदाहरण.

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

   

   43वीं इमेज. कार्रवाई की जांच के संसाधन.

8. अपडेट करें पर क्लिक करें.

   

   44वीं इमेज. बदलावों को सेव करने की कार्रवाई.

टेस्ट मैनेज करना

किसी टेस्ट में बदलाव करना

सेव किए गए किसी टेस्ट में बदलाव करने के लिए, टेस्ट पेज पर जाएं. इसके बाद, उस टेस्ट की लाइन में मौजूद बदलाव करें पर क्लिक करें जिसमें बदलाव करना है. जांच का कॉन्फ़िगरेशन बदलने के बाद, अपडेट करें पर क्लिक करें.

45वीं इमेज. किसी टेस्ट में बदलाव करना.

नया टेस्ट जोड़ना

नया टेस्ट जोड़ने के लिए, टेस्ट पेज पर जाएं और नया टेस्ट बनाएं पर क्लिक करें. सही जानकारी डालें और बनाएं पर क्लिक करें.

46वीं इमेज. टेस्ट बनाना.

47वीं इमेज. टेस्ट कॉपी करना.

होस्ट कॉन्फ़िगरेशन एक्सपोर्ट करना

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

किसी होस्ट के कॉन्फ़िगरेशन एक्सपोर्ट करने के लिए, सेटिंग पेज पर जाएं और सबसे ऊपर दाएं कोने में मौजूद, एक्सपोर्ट करें पर क्लिक करें.

48वीं इमेज. होस्ट कॉन्फ़िगरेशन एक्सपोर्ट करना.

होस्ट कॉन्फ़िगरेशन फ़ाइल इंपोर्ट करने के लिए, सेटिंग पेज पर जाएं और सबसे ऊपर दाएं कोने में मौजूद, इंपोर्ट करें पर क्लिक करें.

चौथी इमेज. होस्ट कॉन्फ़िगरेशन इंपोर्ट करना.

लोकल फ़ाइलों और डायरेक्ट्री का इस्तेमाल करना

R11 वर्शन से, $HOME/.ats_storage डायरेक्ट्री में मौजूद फ़ाइलें, OmniLab ATS में अपने-आप ऐक्सेस हो जाती हैं. किसी फ़ाइल को उस डायरेक्ट्री में कॉपी करें या ले जाएं. इसके बाद, टेस्ट रन शेड्यूल करते समय, लोकल फ़ाइल टैब से उसे चुना जा सकता है.

cp /path/to/file $HOME/.ats_storage

50वीं इमेज. $HOME/.ats_storage डायरेक्ट्री से कोई फ़ाइल चुनना.

--mount_local_path फ़्लैग की मदद से, स्थानीय फ़ाइल स्टोर में अन्य डायरेक्ट्री माउंट की जा सकती हैं.

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

51वीं इमेज. लोकल फ़ाइल स्टोर में माउंट की गई अन्य डायरेक्ट्री.

एक से ज़्यादा होस्ट वाला मोड चालू करना

मल्टी-होस्ट मोड की मदद से, उपयोगकर्ता एक ही एटीएस कंट्रोलर होस्ट का इस्तेमाल करके, कई एटीएस वर्कहोस्ट पर डिवाइसों और टेस्ट को मैनेज कर सकते हैं.

52वीं इमेज. मल्टी-होस्ट मोड का आर्किटेक्चर.

1. एटीएस कंट्रोलर को शुरू करने के लिए, यह कमांड इस्तेमाल करें:

   mtt start --operation_mode=ON_PREMISE
   

2. देखें कि http://${CONTROLLER_HOSTNAME}:8000 पर कंट्रोलर को ऐक्सेस किया जा सकता है या नहीं.

3. वर्कर्स को शुरू करने के लिए, यह कमांड इस्तेमाल करें:

   mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
   

अगर आपका नेटवर्क, होस्ट को एक-दूसरे से बातचीत करने की अनुमति नहीं देता है, तो आपको एटीएस वर्कर्स के लिए, नीचे दिए गए सेटअप के ज़्यादा बेहतर निर्देशों का पालन करना होगा.

1. एसएसएच टनल का इस्तेमाल करके, दोनों होस्ट को कनेक्ट करें. प्राइमरी और फ़ाइल सर्वर पोर्ट के लिए पोर्ट चुनें. उदाहरण के लिए, 9000 और 9006.

   ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
   

2. एटीएस को कॉन्फ़िगर और शुरू करें.

   DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
   socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
   socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
   mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                   --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                   --operation_mode=ON_PREMISE
   

फ़ाइल क्लीनर

फ़ाइल क्लीनर एक क्रॉन जॉब है, जो हर घंटे चलता है. यह उपयोगकर्ता के तय किए गए कॉन्फ़िगरेशन के आधार पर फ़ाइलों को साफ़ करता है. टेस्ट रन के नतीजों को संग्रहित करने और कुछ समय के लिए रहने वाली फ़ाइलों को मिटाने के लिए, ATS में दो डिफ़ॉल्ट कॉन्फ़िगरेशन होते हैं. इस गाइड में, अपनी फ़ाइलों को असरदार तरीके से मैनेज करने के लिए, नीतियों और कॉन्फ़िगरेशन को पसंद के मुताबिक बनाने का तरीका बताया गया है.

नीतियां

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

ये शर्तें, फ़ाइल की विशेषताओं और सिस्टम की जानकारी के आधार पर तय की जाती हैं. टेबल में, उपलब्ध शर्तें दिखाई गई हैं:

53वीं इमेज. फ़ाइल क्लीनर की नई नीति जोड़ें.

कॉन्फ़िगरेशन

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

सभी टारगेट डायरेक्ट्री, /data डायरेक्ट्री में होनी चाहिए. अगर आपके कॉन्फ़िगरेशन में टारगेट डायरेक्ट्री को logs के तौर पर बताया गया है, तो इसे /data/logs के तौर पर समझा जाता है.

54वीं इमेज. फ़ाइल क्लीनर के कॉन्फ़िगरेशन में बदलाव करें.

रीसेट करें

सेटिंग रीसेट करें पर क्लिक करने से, फ़ाइल क्लीनर का कॉन्फ़िगरेशन डिफ़ॉल्ट स्थिति पर वापस आ जाता है. इस कार्रवाई से, सभी कस्टम आइटम मिट जाते हैं.

55वीं इमेज. फ़ाइल क्लीनर की सेटिंग रीसेट करें.

सहायता

गड़बड़ी की रिपोर्ट

OmniLab ATS में आपके योगदान से, टूल को बेहतर बनाने में मदद मिलती है. इसलिए, हमें आपका सुझाव चाहिए! नई रिलीज़ के बारे में जानकारी के लिए, OmniLab ATS के रिलीज़ नोट देखें. गड़बड़ियों की शिकायत करने या सुझाव देने के लिए, गड़बड़ी की शिकायत करें. पार्टनर को अपने पार्टनर चैनलों का इस्तेमाल करके, गड़बड़ियों या सुझावों की शिकायत करनी चाहिए.