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

OmniLab ATS, ऐसा टेस्टिंग टूल है जिसका इस्तेमाल Android डेवलपर और टेस्ट इंजीनियर कर सकते हैं स्टैंडर्ड Android टेस्ट सुइट को चलाने के लिए, यूज़र इंटरफ़ेस का इस्तेमाल किया जा सकता है. उदाहरण के लिए, Android कंपैटबिलिटी टेस्ट सुइट (सीटीएस). यह टूल कई टेस्ट फ़्रेमवर्क के लिए वेब इंटरफ़ेस की तरह काम करता है, जैसे कि ट्रेड फ़ेडरेशन (टीएफ़) और Google Mobly से आपको सीटीएस और कम से कम सेटअप के साथ कई टेस्ट डिवाइसों पर मल्टी-डिवाइस टेस्ट लगातार टेस्ट चलाने के लिए शेड्यूल बनाएं.

OmniLab ATS सेट अप करें

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

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

• OmniLab एटीएस सोर्स कोड
• TradeFed क्लस्टर सोर्स कोड

OmniLab ATS इंस्टॉल करें

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

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

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

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

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

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

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

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

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

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

2. OmniLab ATS सीएलआई का इंस्टॉल किया गया वर्शन देखने के लिए mtt version चलाएं.

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

Docker इंस्टॉल करें

1. फ़ॉलो करें Docker कम्यूनिटी एडिशन (सीई) इंस्टॉल करने के लिए निर्देश कंप्यूटर पर Chromebook सिंक करें.

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 सीएलआई पाएं

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

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 एटीएस होस्ट के साथ, किसी भी कॉन्फ़िगरेशन को कॉपी करने के लिए फ़ाइल अपलोड की जा सकती है फ़ाइल अपलोड करें बटन पर क्लिक करके उस होस्ट में बदलाव किया जा सकता है.

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

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

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

दूसरा डायग्राम. सेवा खाता सेट किया जा रहा है.

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

तीसरी इमेज. सेवा खाते को बदला जा रहा है.

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

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

ऐसे कॉन्फ़िगरेशन सेट को चुनें जिन्हें आपको अपने टेस्ट स्टेशन के होस्ट में जोड़ना है. इसके बाद, क्लिक करें चुने गए को इंपोर्ट करें.

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  cts-suite -m ShortModuleName
  

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

  cts --retry 0 -m ShortModuleName
  

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

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

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

    

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

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

    

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

डिवाइस चुनें

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

11वीं इमेज. डिवाइसों को चुना जा रहा है.

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

product:bramble;product:bramble;product:bramble

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

• बिल्ड_आईडी
• device_serial
• device_type
• होस्टनेम
• प्रॉडक्ट
• product_variant
• Sim_state

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

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

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

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

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

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

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

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

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

14वीं इमेज. परीक्षण संसाधन.

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

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

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

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

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

17वीं इमेज. टेस्ट रिसोर्स सिलेक्टर - वाइल्डकार्ड पैटर्न इस्तेमाल करने की सुविधा.

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

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

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

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

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

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

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

इमेज 20. टेस्ट रन शुरू किया जा रहा है.

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

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

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

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

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

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

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

टेस्ट सुइट जोड़ें

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

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

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

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

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

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

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

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

टेस्ट की जानकारी देखें

टेस्ट रन लिस्ट

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

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

अगर कोई फ़िल्टर खाली है, तो नतीजे के तौर पर सभी पंक्तियां दिखती हैं. फ़िलहाल, पंक्तियों को फ़िल्टर करने का कोई तरीका नहीं है का इस्तेमाल करें.

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

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

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

इमेज 27. टेस्ट चलाने की जानकारी.

टेस्ट चलाने की स्थिति

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

इमेज 28. टेस्ट चलाने की स्थिति.

टेस्ट के लिए इस्तेमाल की जाने वाली स्थितियों की जांच नीचे दी गई है:

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

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

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

इमेज 29. टेस्ट रन रद्द किया जा रहा है.

टेस्ट चलाए जाने के नतीजे

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

तीसरी इमेज. परीक्षण रन परिणाम.

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

इमेज 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. टारगेट तैयार करने वाले टूल के साथ इस्तेमाल करने के लिए कोई भी विकल्प जोड़ें. उपलब्ध विकल्प देखने के लिए, सही का निशान लगाएं targetप्रेप एओएसपी में हर टारगेट तैयार करने वाले के सोर्स कोड के लिए:

   

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

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

   

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

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

   

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

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

   

   इमेज 44. कार्रवाई से जुड़े बदलाव सेव करें.

जांच मैनेज करना

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

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

इमेज 45. टेस्ट में बदलाव किया जा रहा है.

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

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

इमेज 46. टेस्ट बनाया जा रहा है.

इमेज 47. टेस्ट को कॉपी किया जा रहा है.

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

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

किसी होस्ट के कॉन्फ़िगरेशन को एक्सपोर्ट करने के लिए, सेटिंग पेज पर जाएं और एक्सपोर्ट करें पर क्लिक करें टैप करें.

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

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

इमेज 49. होस्ट कॉन्फ़िगरेशन इंपोर्ट किया जा रहा है.

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

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

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
   

फ़ाइल क्लीनर

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

नीतियां

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

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

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

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

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

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

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

रीसेट करें

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

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

सहायता

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

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