Android 11 या इसके बाद के वर्शन के लिए, डिवाइस इंटरैक्शन के सहायक मॉड्यूल की मदद से, यह तय किया जा सकता है कि किसी डिवाइस पर, CTS के कुछ टेस्ट, यूज़र इंटरफ़ेस (यूआई) के साथ कैसे इंटरैक्ट करें. इसका मतलब है कि Android Compatibility Definition Document (CDD) या एपीआई दस्तावेज़ों में शामिल नहीं किए गए यूज़र इंटरफ़ेस (यूआई) एलिमेंट को बदलने जैसी कार्रवाइयां, सीटीएस पास करने के दौरान भी की जा सकती हैं.
जो OEM, प्रॉडक्ट डेवलपमेंट के दौरान Android यूज़र इंटरफ़ेस (यूआई) को अपनी ज़रूरत के मुताबिक बनाना चाहते हैं और जिन्हें सीटीएस पास करना है वे हेल्पर मॉड्यूल लागू कर सकते हैं. अगर Android के डिफ़ॉल्ट तरीके का इस्तेमाल किया जाता है, तो आपको कुछ और करने की ज़रूरत नहीं है.
हेल्पर मॉड्यूल लागू करना
यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाने से जुड़ी ज़रूरी शर्तें
यूज़र इंटरफ़ेस से जुड़ी ज़रूरी शर्तों के लिए, सीडीडी या मुख्य मॉड्यूल देखें. अगर आपका पसंदीदा यूज़र इंटरफ़ेस (यूआई), सीडीडी या मुख्य मॉड्यूल में शामिल है, तो उस यूज़र इंटरफ़ेस को पसंद के मुताबिक नहीं बनाया जा सकता.
अगर पसंदीदा यूज़र इंटरफ़ेस (यूआई) के साथ इंटरैक्ट करने वाली सीटीएस टेस्ट में, मदद करने वाले फ़्रेमवर्क का इस्तेमाल नहीं किया जाता है, तो उस यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक नहीं बनाया जा सकता. यूज़र इंटरफ़ेस (यूआई) में बदलाव करने से पहले, टेस्ट मॉड्यूल को बदलने के लिए, टेस्ट के मालिक के साथ मिलकर काम करें.
इसके अलावा, यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाया जा सकता है.
लागू करने का वर्कफ़्लो
- अपने प्रॉडक्ट के हिसाब से यूज़र इंटरफ़ेस (यूआई) को ज़रूरत के मुताबिक बनाएं.
- मौजूदा AOSP हेल्पर मॉड्यूल को, उन CTS टेस्ट मॉड्यूल के सबक्लास के तौर पर तय करें जिन्हें यूज़र इंटरफ़ेस (यूआई) के साथ इंटरैक्ट करना है. कस्टमाइज़ किए गए यूज़र इंटरफ़ेस (यूआई) के लिए, ज़रूरी इंटरैक्शन को सही तरीके से बदलें. बदलावों के टाइप के हिसाब से, बदलाव करने का तरीका अलग-अलग होता है.
- OEM सबक्लास,
com.[oem].cts.helpersजैसे OEM पैकेज में होते हैं. - हर OEM सब-क्लास को एक सामान्य प्रीफ़िक्स के साथ नाम दिया जाता है, जिससे उसे AOSP के लागू होने से अलग किया जा सकता है. AOSP के प्रीफ़िक्स में
Defaultहोता है.
- OEM सबक्लास,
- टेस्ट रनर के इन नियमों का पालन करके, हेल्पर को APK में बनाएं.
Android.bpकोandroid_test_helper_appका एलान, उस पैकेज के नाम से करना चाहिए जिसमें यह शामिल है.- APK के लिए,
AndroidManifest.xmlकोinteraction-helpers-prefixनाम की एक मेटाडेटा प्रॉपर्टी का एलान करना होगा. इसमें, पिछले बुलेट पॉइंट में चुनी गई क्लास प्रीफ़िक्स की वैल्यू होनी चाहिए. - ऐप्लिकेशन,
cts-helpers-core,cts-helpers-interfaces, औरcom.android.cts.helpers.aospपर निर्भर होना चाहिए. अगर OEM सहायता प्रोग्राम, सभी ज़रूरी इंटरफ़ेस को पूरी तरह से लागू करते हैं, तोcom.android.cts.helpers.aospका इस्तेमाल करना ज़रूरी नहीं है.
- डिवाइस इमेज में
ro.vendor.cts_interaction_helper_packagesप्रॉपर्टी सेट करें, ताकि APK का नाम शामिल किया जा सके. अगर आपको कई APK में, सहायक लागू करने की सुविधा को अलग करना है, तो इस प्रॉपर्टी में कोलन से अलग किए गए पैकेज की सूची हो सकती है. - पक्का करें कि सीटीएस के लिए Tradefed को चलाते समय, APK
testcasesडायरेक्ट्री में उपलब्ध हो. अगर ज़रूरी हो, तो लॉगकैट मैसेज की जांच करके पुष्टि करें कि सही हेल्पर लागू करने वाला क्लास चुना गया है. - ज़रूरी नहीं, लेकिन इसका सुझाव दिया जाता है: AOSP में हेल्पर लागू करने का तरीका सबमिट करें या इसे तीसरे पक्ष की जांच के लिए उपलब्ध कराएं.
हेल्पर को लागू करने का उदाहरण
उदाहरण के लिए, CtsPrintTestCases को ICtsPrintHelper में तय किए गए इंटरफ़ेस के साथ हेल्पर की ज़रूरत है. AOSP को लागू करने की प्रोसेस को
com.android.cts.helpers.aosp.DefaultCtsPrintHelper कहा जाता है.
प्रिंट यूज़र इंटरफ़ेस (यूआई) को पसंद के मुताबिक बनाने पर, com.oem.cts.helpers.OemCtsPrintHelperऐसी सबक्लास DefaultCtsPrintHelper बनाई जा सकती हैं.
Android.bp में android_test_helper_app का नाम com.oem.cts.helpers है,
जो com.oem.cts.helpers.apk बनाता है,
और AndroidManifest.xml में interaction-helpers-prefix को Oem के तौर पर दिखाता है.
डिवाइस प्रॉपर्टी ro.vendor.cts_interaction_helper_packages को
com.oem.cts.helpers पर सेट किया गया है.
लागू करने के तरीके
रेफ़रंस के तौर पर लागू किए गए इंटरफ़ेस में, cts/libs/helpers में मौजूद इंटरफ़ेस और cts/helpers में मौजूद डिफ़ॉल्ट AOSP हेल्पर शामिल हैं. टॉप-लेवल इंटरफ़ेस के बारे में जानकारी, cts/libs/helpers/core/src/com/android/cts/helpers/ICtsDeviceInteractionHelper.java में दी गई है.
सीटीएस टेस्ट को उसके सहायक टूल से कनेक्ट करने के लिए, टेस्ट के मालिक @Rule
cts/libs/helpers/core/src/com/android/cts/helpers/DeviceInteractionHelperRule.java में दी गई परिभाषा का इस्तेमाल कर सकते हैं.
फ़्रेमवर्क और उसके हेल्पर के काम करने के तरीके का इस्तेमाल करने वाले हर सीटीएस मॉड्यूल को, cts/libs/helpers/core/src/com/android/cts/helpers में बताए गए इंटरफ़ेस में दस्तावेज़ के तौर पर सेव किया जाता है.
सीटीएस टेस्ट चलाना
हेल्पर के बिना टेस्ट करना
एक प्रॉपर्टी के अलावा, डिवाइस पर रनटाइम के दौरान, हेल्पर के बिना टेस्ट करने का विकल्प मौजूद नहीं होता. हालांकि, सीटीएस टेस्ट के डिवाइस के साथ इंटरैक्ट करने के तरीके में बदलाव किया जा सकता है. अगर आपको हेल्पर लागू किए बिना सीटीएस चलाना है, तो आपके पास ये दो विकल्प हैं:
- डिवाइस से
ro.vendor.cts_interaction_helper_packagesप्रॉपर्टी हटाएं. इससे, उस बिल्ड में हेल्पर का इस्तेमाल नहीं किया जा सकता. - CTS चलाने से पहले,
testcasesडायरेक्ट्री से हेल्पर APK को हटाएं. इससे, APK कोtestcasesपर वापस लाने तक, किसी भी रन में हेल्पर का इस्तेमाल नहीं किया जा सकता.
Tradefed के आर्ग्युमेंट और ro.vendor.cts_interaction_helper_packages प्रॉपर्टी कंट्रोल की मदद से, डिफ़ॉल्ट सेटिंग में बदलाव किया जा सकता है. यहीं से हेल्पर APK लोड होता है.
उपलब्ध हर सेटिंग के लिए, उम्मीद की जाने वाली वैल्यू या सीमाओं के बारे में जानने के लिए, यहां देखें.
ro.vendor.cts_interaction_helper_packages, पैकेज के नामों वाली स्ट्रिंग है. इसमें कोलन लगाकर पैकेज के नाम अलग-अलग किए गए हैं. इसमें कोई भी वैल्यू हो सकती है, जो OEM के हेल्पर लागू करने के लिए मान्य पैकेज के तौर पर चुनी जा सकती है.cts-tradefed,device-interaction-helper:property-nameआर्ग्युमेंट स्वीकार करता है, जो एक टेस्ट रन के लिए, उम्मीद की गई प्रॉपर्टी को कुछ समय के लिए बदल देता है, जैसे कि--module-arg 'CtsPrintTestCases:{device-interaction-helper}property-name:debug.cts.hlp'. प्रॉपर्टी के नाम की वैल्यू, डिवाइस पर सेट की गई कोई भी प्रॉपर्टी हो सकती है. प्रॉपर्टी की वैल्यू पर वही पाबंदियां लागू होती हैं जो ऊपर बताई गईro.vendor.cts_interaction_helper_packagesप्रॉपर्टी पर लागू होती हैं.
पसंद के मुताबिक बनाने की सुविधा के साथ टेस्ट करना
डिफ़ॉल्ट रूप से, रेफ़रंस के तौर पर लागू किए गए टूल, स्टॉक Android पर सीटीएस की शर्तें पूरी करते हैं. देखें कि पार्टनर के लागू किए गए वर्शन, यूज़र इंटरफ़ेस (यूआई) में पसंद के मुताबिक बदलाव करके, सीटीएस की शर्तें पूरी करते हैं या नहीं. वे सभी CTS मॉड्यूल चलाएं जिनमें आपके पसंद के मुताबिक बनाए गए यूज़र इंटरफ़ेस या सुविधाएं शामिल हैं.
ऐसा हो सकता है कि कुछ सीटीएस मॉड्यूल या हेल्पर, अभी तक पसंद के मुताबिक बनाने की कुछ सुविधाओं के साथ काम न करें.
- ऐसा हो सकता है कि जिस यूज़र इंटरफ़ेस (यूआई) को आपको पसंद के मुताबिक बनाना है उससे इंटरैक्ट करने वाला सीटीएस मॉड्यूल, हेल्पर फ़्रेमवर्क का इस्तेमाल न करे. मांग और टेस्ट के मालिक की प्राथमिकताओं के आधार पर, सीटीएस मॉड्यूल को हेल्पर फ़्रेमवर्क में बदला जा सकता है. प्रोसेस के शुरुआती दौर में ही कन्वर्ज़न के लिए अनुरोध करें, ताकि यह पक्का किया जा सके कि कन्वर्ज़न शेड्यूल पर हो. यह उसी तरह है जैसे अपनी योजना की सुविधाओं के साथ काम करने के लिए, सीटीएस में बदलाव का अनुरोध करना.
- हो सकता है कि किसी मौजूदा हेल्पर से मिलने वाले फ़ंक्शन, आपके हिसाब से पूरी तरह से पसंद के मुताबिक न हों. हेल्पर फ़ंक्शन में यूज़र इंटरफ़ेस (यूआई) की डिपेंडेंसी शामिल नहीं होनी चाहिए. अगर किसी हेल्पर फ़ंक्शन में यूज़र इंटरफ़ेस (यूआई) पर निर्भरता है, तो इसे CTS में मौजूद गड़बड़ियों की तरह ही माना जा सकता है.