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 के लिए, किसी और हार्डवेयर की ज़रूरत नहीं होती. हालांकि, हमारा सुझाव है कि शुरुआत के लिए, CTS होस्ट की ज़रूरी शर्त का इस्तेमाल करें.
OmniLab ATS को इंस्टॉल करने के दो तरीके हैं:
- इंस्टॉलर प्रोग्राम चलाएं.
- इसे मैन्युअल तरीके से इंस्टॉल करें. इसके लिए, आपको कई प्रोग्राम और संसाधन इंस्टॉल करने होंगे.
इंस्टॉलर प्रोग्राम की मदद से इंस्टॉल करना
Ubuntu 20.04 और उसके बाद के वर्शन पर, इंस्टॉलर प्रोग्राम, OmniLab ATS को चलाने के लिए ज़रूरी सभी प्रोग्राम और संसाधनों को इंस्टॉल और कॉन्फ़िगर करता है.
इंस्टॉल प्रोग्राम का इस्तेमाल करने के लिए:
इंस्टॉलर प्रोग्राम चलाएं:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
OmniLab ATS CLI के इंस्टॉल किए गए वर्शन की जांच करने के लिए,
mtt versionचलाएं.
मैन्युअल तरीके से इंस्टॉल करना
Docker इंस्टॉल करना
अपनी Linux मशीन पर, Docker Community Edition (CE) इंस्टॉल करने के लिए दिए गए निर्देशों का पालन करें.
रूट उपयोगकर्ता के तौर पर Docker को मैनेज करने के लिए, इंस्टॉल करने के बाद के चरणों का पालन करें.
अनुमति में किए गए बदलावों के लागू होने के लिए, आपको अपनी टर्मिनल विंडो को रीस्टार्ट करना पड़ सकता है या साइन आउट करके फिर से साइन इन करना पड़ सकता है.
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 updatesudo apt install python3 python3-distutils
किसी खास Python 3 वर्शन (जैसे, 3.10) को इंस्टॉल करने के लिए, इन कमांड को चलाएं:
sudo apt-get updatesudo 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 और वाई-फ़ाई पीएसके डालें. हालांकि, वाई-फ़ाई पीएसके डालना ज़रूरी नहीं है.
पांचवीं इमेज. वाई-फ़ाई हॉटस्पॉट की सेटिंग.
सेटअप विज़र्ड पूरा करने के बाद, लागू की गई नई सेटिंग के साथ पेज फिर से लोड हो जाता है.
कोई डिवाइस कनेक्ट करें
किसी डिवाइस को टेस्टिंग के लिए इस्तेमाल करने के लिए, यूएसबी डीबगिंग की सुविधा चालू होनी चाहिए. डीबग करने की सुविधा चालू करने के लिए:
'डेवलपर के लिए सेटिंग और टूल' चालू करना और डिबग करना में दिए गए निर्देशों का पालन करें.
अगर आपको मनमुताबिक ADB कुंजियों के साथ पहले से लोड किए गए Android बिल्ड इस्तेमाल करने हैं, तो कस्टम
.adb_keyफ़ाइलों को~/.android/डायरेक्ट्री में रखें.ये फ़ाइलें अपने-आप लोड हो जाती हैं और उन डिवाइसों के लिए यूएसबी डिबगिंग की सुविधा अपने-आप चालू करने के लिए, ADB को भेज दी जाती हैं जिन पर ये बिल्ड चल रहे हैं.
यूएसबी का इस्तेमाल करके, डिवाइस को होस्ट मशीन से कनेक्ट करें.
वेब इंटरफ़ेस रीफ़्रेश करने के एक मिनट के अंदर डिवाइस, OmniLab ATS डिवाइस टैब में दिखता है. इस टैब पर, डिवाइसों की स्थिति भी देखी जा सकती है.
छठी इमेज. किसी डिवाइस को कनेक्ट करना.
डिवाइस की अलग-अलग स्थितियां ये हैं:
- उपलब्ध है - डिवाइस कनेक्ट है और जांच करने के लिए तैयार है.
- असाइन किया गया - डिवाइस कनेक्ट है और टेस्ट कर रहा है. हर डिवाइस पर एक बार में सिर्फ़ एक टेस्ट चलाया जा सकता है. इसलिए, नया टेस्ट चलाने से पहले, डिवाइस पर मौजूदा टेस्ट पूरा होना चाहिए.
परीक्षण चलाना
कोई टेस्ट चुनना
OmniLab ATS में, पहले से बंडल किए गए सीटीएस कॉन्फ़िगरेशन का एक सेट होता है. इनमें से किसी एक टेस्ट को चलाने के लिए, टेस्ट सुइट टैब पर जाएं और चुने गए टेस्ट के लिए टेस्ट चलाएं पर क्लिक करें.
सातवीं इमेज. कोई टेस्ट चुनना.
टेस्ट में बदलाव करने या नए टेस्ट जोड़ने के लिए, टेस्ट जोड़ना लेख पढ़ें.
टेस्ट रन कॉन्फ़िगर करना
इस खास टेस्ट रन के लिए, पैरामीटर में बदलाव करें. ज़्यादातर पैरामीटर, चुने गए टेस्ट कॉन्फ़िगरेशन में तय की गई वैल्यू के साथ पहले से भरे होते हैं.
इस चरण को डिफ़ॉल्ट वैल्यू का इस्तेमाल करके पूरा किया जा सकता है. हालांकि, ज़रूरत के हिसाब से फिर से कोशिश करें और Command जैसे किसी भी पैरामीटर में बदलाव किया जा सकता है.
आठवीं इमेज. टेस्ट रन कॉन्फ़िगर करना.
जांच चलाने के पैरामीटर ये हैं:
- नाम - उस टेस्ट सुइट का नाम जिसे आपको चलाना है.
- रन की संख्या - शेड्यूल किए जाने पर, इस टेस्ट को कितनी बार चलाया जाना चाहिए. टेस्ट रन, ट्रेड फ़ेडरेशन का इस्तेमाल करके शेड्यूल किए जाते हैं. अगर क्षमता है, तो यह 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 बजे सीटीएस 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वीं इमेज. टेस्ट रन के नतीजे.
लॉग टैब में, लाइव होस्ट और ट्रेड किए गए लॉग देखे जा सकते हैं.
इमेज 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. डिवाइस कार्रवाइयां टैब.
डिवाइस के लिए कोई नई कार्रवाई जोड़ना
नया डिवाइस ऐक्शन पर क्लिक करें.
37वीं इमेज. नए डिवाइस पर की जाने वाली कार्रवाई का बटन.
नाम और जानकारी डालें.
38वीं इमेज. डिवाइस ऐक्शन का नाम.
टारगेट तैयार करने वाला जोड़ें पर क्लिक करें.
ट्रेड फ़ेडरेशन टारगेट तैयार करने वाले की पूरी क्लास का नाम डालें. उदाहरण के लिए,
com.android.tradefed.targetprep.RunHostCommandTargetPreparer.
इमेज 39. टारगेट तैयार करने वाला व्यक्ति जोड़ना.
टारगेट तैयार करने वाले उपलब्ध टूल की सूची, com.android.tradefed.targetprep रेफ़रंस में देखी जा सकती है.
40वीं इमेज. टारगेट तैयार करने वाले लोगों की सूची.
टारगेट तैयार करने वाले टूल के साथ इस्तेमाल करने के लिए कोई भी विकल्प जोड़ें. उपलब्ध विकल्प देखने के लिए, AOSP में हर टारगेट तैयार करने वाले के सोर्स कोड के लिए, targetprep देखें:
41वीं इमेज. कार्रवाई के विकल्प का उदाहरण.
कोई विकल्प जोड़ने के लिए, टारगेट तैयार करने वाला विकल्प जोड़ें पर क्लिक करें और ज़रूरी वैल्यू डालें.
इमेज 42. ऐक्शन कमांड का उदाहरण.
डिवाइस ऐक्शन को लागू करने के लिए ज़रूरी टेस्ट संसाधनों की जानकारी दें. उदाहरण के लिए, फ़्लैश करने के लिए इमेज बनाएं. संसाधन की परिभाषा जोड़ने के लिए, टेस्ट संसाधन जोड़ें पर क्लिक करें और ज़रूरी फ़ील्ड भरें. अगर आपको पता है कि आपकी फ़ाइलें कहां मौजूद हैं, तो ब्राउज़ करें पर क्लिक करके, डाउनलोड करने के लिए डिफ़ॉल्ट यूआरएल दिया जा सकता है. अगर टारगेट तैयार करने वाले लोग, डायरेक्ट्री को टेस्ट रिसॉर्स के तौर पर स्वीकार करते हैं, तो डिकंप्रेस करें को चुनें. इसके बाद, काम करने के लिए बनाई गई फ़ोल्डर में मौजूद, रिलेटिव डेस्टिनेशन डायरेक्ट्री और उन फ़ाइल के नाम डालें जिन्हें डिकंप्रेस करना है. अगर फ़ाइलों के नाम नहीं दिए जाते हैं, तो टेस्ट रिसॉर्स से सभी फ़ाइलों को डिकंप्रेस कर दिया जाता है.
इमेज 43. कार्रवाई की जांच के लिए संसाधन.
अपडेट करें पर क्लिक करें.
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. मल्टी-होस्ट मोड का आर्किटेक्चर.
एटीएस कंट्रोलर को शुरू करने के लिए, यह कमांड इस्तेमाल करें:
mtt start --operation_mode=ON_PREMISEदेखें कि
http://${CONTROLLER_HOSTNAME}:8000पर कंट्रोलर को ऐक्सेस किया जा सकता है या नहीं.वर्कर शुरू करने के लिए, नीचे दिए गए निर्देश का इस्तेमाल करें:
mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
अगर आपका नेटवर्क, होस्ट को एक-दूसरे से बातचीत करने की अनुमति नहीं देता है, तो आपको एटीएस वर्कर्स के लिए, नीचे दिए गए सेटअप के ज़्यादा बेहतर निर्देशों का पालन करना होगा.
एसएसएच टनल का इस्तेमाल करके, दोनों होस्ट को कनेक्ट करें. प्राइमरी और फ़ाइल सर्वर पोर्ट के लिए पोर्ट चुनें. उदाहरण के लिए, 9000 और 9006.
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAMEएटीएस कॉन्फ़िगर करना और चालू करना.
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 में दो डिफ़ॉल्ट कॉन्फ़िगरेशन होते हैं. इस गाइड में, अपनी फ़ाइलों को असरदार तरीके से मैनेज करने के लिए, नीतियों और कॉन्फ़िगरेशन को पसंद के मुताबिक बनाने का तरीका बताया गया है.
नीतियां
यह नीति, फ़ाइलों या डायरेक्ट्री पर की जाने वाली कार्रवाई और टारगेट चुनने की शर्तों के बारे में बताती है. टेबल में उपलब्ध ऑपरेशन दिखाए गए हैं:
| ऑपरेशन का टाइप | पैरामीटर |
|---|---|
ARCHIVE | remove_file: अगर true है, तो संग्रहित करने के बाद फ़ाइल को हटाएं. |
DELETE |
शर्तें, फ़ाइल की विशेषताओं और सिस्टम की जानकारी पर आधारित हैं. इन शर्तों को टेबल में दिखाया गया है:
| शर्त का टाइप | ब्यौरा | पैरामीटर |
|---|---|---|
LAST_MODIFIED_TIME | फ़ाइलों को, पिछली बार बदलाव करने की तारीख और समय के हिसाब से फ़िल्टर करना. | ttl: समय के लिए अलग-अलग तरह के एक्सप्रेशन इस्तेमाल किए जा सकते हैं. उदाहरण के लिए, 10m, 2h, 7 days, 4w. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट के बारे में जानने के लिए, pytimeparse पर जाएं. |
LAST_ACCESS_TIME | फ़ाइलों को, पिछली बार ऐक्सेस करने की तारीख और समय के आधार पर फ़िल्टर करें. | LAST_MODIFIED_TIME जैसा ही. |
NAME_MATCH | रेगुलर एक्सप्रेशन का इस्तेमाल करके फ़ाइलों को उनके नाम के हिसाब से फ़िल्टर करें. | pattern: रेगुलर एक्सप्रेशन, जैसे कि नतीजे के ज़िप से मिलान करने के लिए [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip. |
SYSTEM_AVAILABLE_SPACE | सिस्टम पर उपलब्ध जगह के हिसाब से कार्रवाइयां ट्रिगर करें. | threshold: जब उपलब्ध स्पेस, थ्रेशोल्ड से कम हो जाए, तब ऐक्शन को ट्रिगर करें. उदाहरण के लिए, 200(B), 200KB, 200MB, 200GB, 2TB. |
इमेज 53. फ़ाइल क्लीनर से जुड़ी नई नीति जोड़ें.
कॉन्फ़िगरेशन
कॉन्फ़िगरेशन, एक या उससे ज़्यादा नीतियों को खास डायरेक्ट्री के साथ जोड़ता है. चुनी गई डायरेक्ट्री में मौजूद फ़ाइलों और डायरेक्ट्री को, तय की गई नीतियों के आधार पर प्रोसेस किया जाता है. नीतियां उसी क्रम में लागू होती हैं जिस क्रम में वे कॉन्फ़िगरेशन में दिखती हैं.
सभी टारगेट डायरेक्ट्री, /data डायरेक्ट्री में होनी चाहिए. अगर आपका
कॉन्फ़िगरेशन, टारगेट डायरेक्ट्री को logs के तौर पर बताता है, तो इसे /data/logs के तौर पर दिखाया जाता है.
54वीं इमेज. फ़ाइल क्लीनर के कॉन्फ़िगरेशन में बदलाव करें.
रीसेट करें
सेटिंग रीसेट करें पर क्लिक करने से, फ़ाइल क्लीनर कॉन्फ़िगरेशन वापस अपनी डिफ़ॉल्ट स्थिति पर आ जाता है. इस कार्रवाई से, सभी कस्टम आइटम मिट जाते हैं.
इमेज 55. फ़ाइल क्लीनर की सेटिंग रीसेट करें.
सहायता
गड़बड़ी की रिपोर्ट
OmniLab ATS में आपके योगदान से, टूल को बेहतर बनाने में मदद मिलती है. इसलिए, हमें आपका सुझाव चाहिए! नई रिलीज़ के बारे में जानकारी के लिए, OmniLab ATS के रिलीज़ नोट देखें. गड़बड़ियों की शिकायत करने या सुझाव देने के लिए, गड़बड़ी की शिकायत करें. पार्टनर को अपने पार्टनर चैनलों का इस्तेमाल करके, गड़बड़ियों या सुझावों की शिकायत करनी चाहिए.