सीटीएस परीक्षण चलाएँ

ट्रेड फेडरेशन एंड्रॉइड डिवाइस पर परीक्षण चलाने के लिए एक सतत परीक्षण ढांचा है। संगतता परीक्षण सूट (सीटीएस) चलाने के लिए, पहले ट्रेडफेड परीक्षण ढांचे की व्याख्या के लिए ट्रेड फेडरेशन अवलोकन पढ़ें।

परीक्षण योजना चलाने के लिए:

1. एंड्रॉइड डिवाइस सेटअप के अनुसार डिवाइसेस अंडर टेस्ट (DUTs) सेट करें।
2. सुनिश्चित करें कि आपने एंड्रॉइड डिबग ब्रिज (एडीबी) और एंड्रॉइड एसेट पैकेजिंग टूल (एएपीटी) दोनों के नवीनतम संस्करण स्थापित किए हैं और उन टूल का स्थान अपनी मशीन के सिस्टम पथ में जोड़ा है। उन उपकरणों को स्थापित करने के बारे में जानकारी के लिए, सीटीएस की स्थापना: एडीबी और एएपीटी देखें।
3. जारी सीटीएस बिल्ड को अपने लिनक्स होस्ट मशीन पर डाउनलोड करें और बिल्ड को होस्ट स्थान पर अनज़िप करें।
4. कम से कम एक डिवाइस कनेक्ट करें. DUT तैयार करने के लिए:
   • डिवाइस को होम स्क्रीन पर सेट करने के लिए होम बटन दबाएँ।
   • किसी अन्य कार्य के लिए DUT का उपयोग न करें.
   • सेंसर गतिविधि को ट्रिगर करने से बचने के लिए DUT को स्थिर स्थिति में रखें।
   • डिवाइस के कैमरे को किसी ऐसी वस्तु की ओर इंगित करें जिस पर ध्यान केंद्रित किया जा सके।
   • सीटीएस चलने के दौरान डिवाइस पर कोई भी कुंजी न दबाएं। कुंजियाँ दबाने या DUT की स्क्रीन को छूने से चल रहे परीक्षणों में बाधा आती है और परीक्षण विफल हो सकता है।

5. CTS कंसोल cts-tradefed स्क्रिप्ट को उस फ़ोल्डर से लॉन्च करें जहां CTS पैकेज को अनज़िप किया गया है। होस्ट के कमांड-लाइन शेल पर, चलाएँ:

   ./android-cts/tools/cts-tradefed

6. डिफ़ॉल्ट परीक्षण योजना चलाएँ (सभी परीक्षण पैकेज शामिल हैं):

   cts-tradefed > run cts

   • यदि आप परीक्षण निष्पादन समय में सुधार करना चाहते हैं, तो आप परीक्षणों को कई उपकरणों में विभाजित कर सकते हैं। शेयरिंग के लिए होस्ट को कम से कम दो डिवाइस कनेक्ट करने की आवश्यकता होती है, लेकिन दक्षता के लिए छह या अधिक डिवाइस की अनुशंसा की जाती है। 1 से अधिक डिवाइस को साझा करते समय:

     • एंड्रॉइड 9 और उच्चतर के लिए, कमांड विकल्प का उपयोग करें

       --shard-count number_of_shards

     • एंड्रॉइड 8.1 और उससे पहले के संस्करण के लिए, कमांड विकल्प का उपयोग करें

       --shards number_of_shards

   • यदि आप संपूर्ण परीक्षण सूट नहीं चलाना चाहते हैं, तो आप कमांड लाइन से अपनी पसंद की सीटीएस योजना चला सकते हैं:

     run cts --plan test_plan_name

     परीक्षण योजना का नाम ढूंढने के लिए:

     • एंड्रॉइड 7.0 और उच्चतर के लिए, परीक्षण मॉड्यूल की सूची देखने के लिए, दर्ज करें

       list modules

     • एंड्रॉइड 6.0 और उससे पहले के संस्करण के लिए, रिपॉजिटरी में परीक्षण योजनाओं की सूची देखने के लिए, दर्ज करें

       list plans

     • एंड्रॉइड 6.0 और उससे पहले के संस्करण के लिए, रिपॉजिटरी में परीक्षण पैकेजों की सूची देखने के लिए, दर्ज करें

       list packages

   • सीटीएस संस्करणों के आधार पर अतिरिक्त कमांड विकल्पों के लिए, कंसोल कमांड संदर्भ , या ट्रेडफेड कंसोल में "सभी की मदद करें" के अंतर्गत देखें।

7. जब तक सभी परीक्षण मॉड्यूल पूरे नहीं हो जाते और पिछले दो पुनः प्रयास सत्रों में परीक्षण विफलता संख्या समान नहीं हो जाती, तब तक एकाधिक पुनः प्रयास सत्र चलाएँ।

   • Android 9 और उच्चतर के लिए, उपयोग करें

     run retry --retry session_number --shard-count number_of_shards

   • Android 7.0–8.1 के लिए, उपयोग करें

     run cts --retry session_number --shards number_of_shards

   • सीटीएस संस्करण के आधार पर अतिरिक्त पुनः प्रयास कमांड विकल्पों के लिए, सीटीएस v2 कमांड कंसोल देखें।

   • सीटीएस पुनः प्रयास के कार्यान्वयन विवरण को समझने के लिए, ट्रेड फेडरेशन सुइट पुनः प्रयास देखें।

8. केवल विफल पैराटर्मरीकृत परीक्षणों पर पुनः प्रयास सत्र चलाएँ। उत्तीर्ण पैरामीटरयुक्त परीक्षणों का पुनः प्रयास नहीं किया जाता है।

   • एंड्रॉइड 11 और उच्चतर के लिए, निम्न पुनः प्रयास कमांड विकल्प run cts कमांड में डिफ़ॉल्ट रूप से सक्षम है:

     run retry --retry  --new-parameterized-handling

9. कंसोल पर रिपोर्ट की गई परीक्षण प्रगति और परिणाम देखें।

एंड्रॉइड टेस्ट स्टेशन का उपयोग करके सीटीएस चलाएं

एंड्रॉइड टेस्ट स्टेशन एक परीक्षण स्वचालन उपकरण है जिसका उपयोग एंड्रॉइड डेवलपर्स और परीक्षण इंजीनियर मानक परीक्षण सूट चलाने के लिए उपयोगकर्ता इंटरफ़ेस को नियोजित करने के लिए कर सकते हैं। यह एंड्रॉइड कम्पैटिबिलिटी टेस्ट सूट (सीटीएस) के साथ काम करता है।

उपकरण एटीएस उपयोगकर्ता गाइड के माध्यम से सार्वजनिक रूप से उपलब्ध है, और इसका कोड एओएसपी ( multitest_transport , tradefed_cluster ) में खुला है।

वैकल्पिक मोड के लिए सीटीएस चलाएँ

सीटीएस 10 आर4 रिलीज़ वैकल्पिक मोड वाले उपकरणों के लिए, या एक से अधिक स्क्रीन वाले उपकरणों के लिए एक परीक्षण योजना जोड़ता है। run cts-foldable उपयोग करके वैकल्पिक मोड परीक्षण योजना निष्पादित करें।

वैकल्पिक स्क्रीन मोड के लिए उत्तीर्ण या असफल परीक्षण मामलों को display_mode के मान के साथ जोड़ा जाता है, उदाहरण के लिए, testcase1[display_mode=0] ।

सीटीएस 13 में, डिवाइसस्टेटमैनेजर एपीआई निम्नलिखित कॉन्फ़िगरेशन विकल्प के साथ परीक्षण मॉड्यूल को फोल्डेबल डिवाइस के विभिन्न डिवाइस राज्यों पर चलाने की अनुमति देता है। सीटीएस cts-foldable परीक्षण योजना को चलाने की आवश्यकता के बिना डिवाइस में परिभाषित डिस्प्ले फोल्डिंग स्थिति के आधार पर सीटीएस में परीक्षण निष्पादन स्वचालित है।

<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />

सीटीएस में मल्टी-डिवाइस परीक्षण

Android 13 और उच्चतर मल्टी-डिवाइस परीक्षण का समर्थन करते हैं। जिन परीक्षणों के लिए एकाधिक उपकरणों की आवश्यकता होती है, वे सीटीएस रन के दौरान स्वचालित रूप से निष्पादित होते हैं। सीटीएस 13 में कुछ मल्टी-डिवाइस परीक्षण शामिल हैं जो शार्डिंग का उपयोग करने पर स्वचालित रूप से ट्रिगर होते हैं। हालाँकि परीक्षण के लिए भौतिक सेटअप में अतिरिक्त परिवर्तनों की आवश्यकता नहीं होती है, परीक्षणों को सही ढंग से चलाने के लिए virtualenv स्थापित करने की आवश्यकता होती है। विवरण के लिए, मल्टी-डिवाइसेस सूट देखें।

मल्टी-डिवाइस परीक्षण चलाएँ

मल्टी-डिवाइस परीक्षण को स्वतंत्र रूप से चलाने के लिए, निम्नलिखित कोड का उपयोग करें:

  cts-tradefed > run cts-multidevice
  

सभी नियमित विकल्प समर्थित हैं. विशिष्ट उपकरणों को लक्षित करने के लिए, लक्षित उपकरणों की संख्या के लिए --serial <serial1> --serial <serial2> इत्यादि जोड़ें।

मल्टी-डिवाइस परीक्षणों को स्वचालित रूप से ट्रिगर करने के लिए, शार्डिंग का उपयोग करें, जैसे --shard-count 2 में।