Android कंपैटबिलिटी टेस्ट सुइट की पुष्टि करने वाला (सीटीएस की पुष्टि करने वाला) टूल, कंपैटबिलिटी टेस्ट सुइट (सीटीएस). सीटीएस ऐसे एपीआई और फ़ंक्शन की जांच करता है जो CTS Verifier ऐसे एपीआई और फ़ंक्शन के लिए ऐसी जांच देता है जो मैन्युअल इनपुट या पोज़िशनिंग के बिना, जैसे कि ऑडियो को किसी स्टेशनरी डिवाइस पर टेस्ट किया गया टचस्क्रीन, एक्सलरोमीटर, और कैमरा.
ज़रूरी शर्तें
सीटीएस वेरिफ़ायर चलाने से पहले पक्का करें कि आपके पास नीचे दिए गए उपकरण हैं:
- ऐसा Android डिवाइस जिस पर इस बात की पुष्टि की गई हो कि Android API के साथ काम करता है या नहीं सीटीएस पास कर रहा हूं. इस डिवाइस की जांच की जा रही है (डीयूटी).
- यूएसबी 2.0 के साथ काम करने वाले पोर्ट वाला Linux कंप्यूटर. डीयूटी के सभी कनेक्शन, इस पोर्ट के ज़रिए साइन इन करना होगा.
- दूसरा Android डिवाइस, जिसमें पहले से मालूम ब्लूटूथ, वाई-फ़ाई डायरेक्ट, और वाई-फ़ाई की सुविधा है अवेयर, यूडब्ल्यूबी (अगर डीयूटी, यूडब्ल्यूबी के साथ काम करता है), और एनएफ़सी होस्ट कार्ड एम्युलेशन (एचसीई) लागू करना.
- ऐक्सेस पॉइंट नाम और पासवर्ड के साथ कॉन्फ़िगर किया गया वाई-फ़ाई राऊटर. राऊटर में इंटरनेट से डिसकनेक्ट होने की सुविधा होनी चाहिए, लेकिन वह चालू नहीं है बंद करें.
यह भी पक्का करें कि आपने ट्राइपॉड, डिवाइस होल्डर, और प्री-मेज़र की जानकारी भी सेट की हो यूडब्ल्यूबी के लिए, दूरी (प्रॉक्सिमिटी) मेज़र करने वाले टेस्ट के लिए ज़रूरी दूरियां, वाई-फ़ाई एनएएन और ब्लूटूथ आरएसएसआई. जानकारी के लिए, यह देखें मौजूदगी का कैलिब्रेशन.
एनएफ़सी की जांच के लिए, यूआईसीसी से जुड़ी ज़रूरी शर्तें
CTS Verifier में ये एनएफ़सी टेस्ट केस मौजूद हैं:
- फ़ील्ड-ऑफ़ (0x54 के लेन-देन डेटा का इस्तेमाल करता है)
- चुने हुए का निशान हटाएं (0x52 से लेन-देन डेटा का इस्तेमाल करता है)
- HCI निर्देश (0025000000) (0x02 के लेन-देन डेटा का इस्तेमाल करता है)
लेन-देन इवेंट की जांच के लिए दो डिवाइसों की ज़रूरत होती है, जिनमें से एक में इन ऐक्सेस नियमों के साथ SecureElement UICC:
- CtsVerifier APK हैश: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- एनएफ़सी इवेंट ऐक्सेस के लिए, आधिकारिक ऐप्लिकेशन आइडेंटिफ़ायर (AID): 0xA000000476416E64726F696443545341
एम्युलेटर की तरफ़, हमें उम्मीद है कि ट्रांज़ैक्शन इवेंट गतिविधि को फ़ोरग्राउंड में किया जा सकता है.
सेटअप
टेस्ट डिवाइस के सिस्टम नेविगेशन मोड को, तीन बटन वाले मोड में इस तरह बदलें अनुसरण करता है:
- Settings खोलें.
- सिस्टम पर जाएं > हाथ के जेस्चर > सिस्टम नेविगेशन.
- कोई भी बटन-आधारित नेविगेशन मोड, तीन बटन वाला मोड चुनें, अगर उपलब्ध हैं.
सीटीएस वेरिफ़ायर टेस्टिंग एनवायरमेंट सेट अप करने के लिए:
Linux कंप्यूटर पर:
अनुमति देने के लिए CTS Verifier इंस्टॉल करने से पहले निम्न आदेश चलाएं बिना SDK टूल वाले इंटरफ़ेस का ऐक्सेस.
adb shell settings put global hidden_api_policy 1
Android Studio इंस्टॉल करें.
इनके लिए CTS Verifier APK डाउनलोड करें किस Android वर्शन का इस्तेमाल कर सकते हैं.
DUT को Linux कंप्यूटर से कनेक्ट करें.
Linux कंप्यूटर पर किसी टर्मिनल से, DUT पर
CtsVerifier.apkइंस्टॉल करें.adb install -r -g CtsVerifier.apk
Android 10 और उसके बाद वाले वर्शन के लिए, ये काम करें कमांड का इस्तेमाल करें.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
Android 11 और उसके बाद वाले वर्शन के लिए, ये काम करें इस कमांड का इस्तेमाल करके, रिपोर्ट को डिवाइस की बाहरी टॉप-लेवल की डायरेक्ट्री में जाकर बदल सकते हैं.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Android 13 और उसके बाद वाले वर्शन के लिए, ये काम करें आदेश की पुष्टि करें.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Android 14 और उसके बाद वाले वर्शन के लिए, ये काम करें निर्देश दें, ताकि ऐप्लिकेशन को स्क्रीन चालू करने की अनुमति दी जा सके.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
पक्का करें कि डीयूटी में, सिस्टम की तारीख और समय सही तरीके से सेट किए गए हों.
सीटीएस वेरिफ़ायर चलाएं
CTS Verifier ऐप्लिकेशन को लॉन्च करने के लिए, डीयूटी पर दिए गए CTS Verifier आइकॉन पर टैप करें.
पहला डायग्राम. CTS Verifier का आइकॉन
ऐप्लिकेशन, मैन्युअल तरीके से पुष्टि करने के लिए उपलब्ध जांच के कई सेट दिखाता है.
दूसरा डायग्राम. सीटीएस की पुष्टि करने वाले टूल का मेन्यू
हर जांच में, स्क्रीन के निचले हिस्से में सामान्य एलिमेंट का एक सेट होता है.
तीसरी इमेज. टेस्ट स्क्रीन, जिसमें टेस्ट के सामान्य एलिमेंट हाइलाइट किए गए हैं
- पास (✓). अगर डीयूटी, जानकारी के मुताबिक जांच की ज़रूरी शर्तों को पूरा करता है, तो टैप करें निर्देश.
- जानकारी (?). जांच करने से जुड़े निर्देश देखने के लिए टैप करें. ये भी अपने-आप दिखते हैं पहली बार टेस्ट खोलने पर.
- फ़ेल (!). अगर डीयूटी, दी गई जानकारी के मुताबिक जांच की ज़रूरी शर्तों को पूरा नहीं करता है, तो टैप करें निर्देश.
यूएसबी ऐक्सेसरी मोड और कैमरा कैलिब्रेशन टेस्ट जैसे कुछ टेस्ट की ज़रूरत होती है अतिरिक्त टेस्ट सेटअप और निर्देश देखें, जैसा कि नीचे दिए गए सेक्शन में बताया गया है.
8.0 और इसके बाद के वर्शन के लिए, यूएसबी ऐक्सेसरी मोड की जांच करें
चौथी इमेज. 8.0 और ऊपर
पांचवी इमेज. 8.0 और ओएस वाले डिवाइस के लिए, यूएसबी ऐक्सेसरी मोड की जांच करना ऊपर
7.x और उससे पहले के वर्शन के लिए, यूएसबी ऐक्सेसरी मोड की जांच करें
यूएसबी डेस्कटॉप मशीन को चलाने के लिए, यूएसबी ऐक्सेसरी टेस्ट करने के लिए, Linux कंप्यूटर की ज़रूरत होती है (होस्ट) प्रोग्राम का हिस्सा है.
- DUT को Linux कंप्यूटर से कनेक्ट करें.
कंप्यूटर पर, सीटीएस की मदद से
cts-usb-accessoryप्रोग्राम को एक्ज़ीक्यूट करें पुष्टि करने वाला पैकेज:./cts-usb-accessory
DUT पर पॉप-अप मैसेज दिखने का इंतज़ार करें. इसके बाद, ठीक है को चुनें.
छठी इमेज. यूएसबी ऐक्सेसरी की जांच
DUT पर CTS Verifier ऐप्लिकेशन में यूएसबी ऐक्सेसरी टेस्ट पर जाएं.
कंप्यूटर पर, कंसोल से मिले आउटपुट की समीक्षा करें. आउटपुट का उदाहरण:
CTS USB Accessory Tester Found possible Android device (413c:2106) - attempting to switch to accessory mode... Failed to read protocol versionfigure3 Found Android device in accessory mode (18d1:2d01)... [RECV] Message from Android device #0 [SENT] Message from Android accessory #0 [RECV] Message from Android device #1 [SENT] Message from Android accessory #1 [RECV] Message from Android device #2 [SENT] Message from Android accessory #2 [RECV] Message from Android device #3 [SENT] Message from Android accessory #3 [RECV] Message from Android device #4 [SENT] Message from Android accessory #4 [RECV] Message from Android device #5 [SENT] Message from Android accessory #5 [RECV] Message from Android device #6 [SENT] Message from Android accessory #6 [RECV] Message from Android device #7 [SENT] Message from Android accessory #7 [RECV] Message from Android device #8 [SENT] Message from Android accessory #8 [RECV] Message from Android device #9 [SENT] Message from Android accessory #9 [RECV] Message from Android device #10 [SENT] Message from Android accessory #10
कैमरे के फ़ील्ड ऑफ़ व्यू को कैलिब्रेट करें
डिवाइस का तुरंत पता लगाने के लिए, फ़ील्ड ऑफ़ व्यू कैलिब्रेशन प्रोसेस का इस्तेमाल करें फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) को थोड़ा सटीक बनाएं.
टेस्ट एनवायरमेंट को सेट अप करें:
- प्रिंट करें calibration-pattern.pdf टारगेट फ़ाइल को 11” x 17” या A3 साइज़ के पेपर पर सेव किया जा सकता है.
- प्रिंट किए गए पैटर्न को सख्त बैकिंग पर माउंट करें.
कैमरा डिवाइस और प्रिंट किए गए टारगेट को नीचे दिखाए गए तरीके से घुमाएं डायग्राम.
सातवीं इमेज. कैमरे का प्रिंट किया गया टारगेट
टारगेट की चौड़ाई सेट करें:
- स्क्रीन के निचले हिस्से पर मौजूद ठोस रेखाओं के बीच की दूरी (सेंटीमीटर में) मापें टारगेट पैटर्न (~38 cm).
- कैलिब्रेशन ऐप्लिकेशन शुरू करें.
- सेटअप बटन दबाएं और मार्कर की दूरी चुनें.
- टारगेट पैटर्न (~100 सेंटीमीटर) की दूरी मापें और डालें.
- कैलिब्रेशन की झलक पर वापस जाने के लिए, 'वापस जाएं' बटन दबाएं.
पुष्टि करें कि उपकरण और लक्ष्य को चित्र में दिखाए गए तरीके से रखा गया है और सेटअप डायलॉग में सही दूरियां डाली गई हैं. झलक इमेज को वर्टिकल लाइन के साथ दिखाता है और उसे ओवरले करता है; इस लाइन में आपसे लक्ष्य पैटर्न की सेंटर लाइन से अलाइन होनी चाहिए. ट्रांसपैरंट ग्रिड से अन्य वर्टिकल लाइनों के साथ इस्तेमाल किया जा सकता है, ताकि यह पक्का किया जा सके कि ऑप्टिकल ऐक्सिस लक्ष्य के लिए ऑर्थोगोनल.
कैलिब्रेशन टेस्ट करें:
- सबसे नीचे बाईं ओर मौजूद सिलेक्टर का इस्तेमाल करके, इमेज का रिज़ॉल्यूशन चुनें. इसके बाद, क्लिक करें. जांच, कैलिब्रेशन मोड में जाती है और तस्वीर पर दो वर्टिकल लाइनों को ओवरले करके, फ़ोटो को दिखाता है.
- सटीक जानकारी तय करें:
- अगर लाइनें, टारगेट पैटर्न पर वर्टिकल लाइनों के साथ अलाइन होती हैं कुछ सेंटीमीटर में, चुना गया रिज़ॉल्यूशन सटीक है.
- अगर लाइनें एक जैसी नहीं हैं, तो इसका मतलब है कि रिपोर्ट किया गया फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) गलत है. इसे ठीक करने के लिए, स्क्रीन पर सबसे नीचे दिए गए स्लाइडर को तब तक अडजस्ट करें, जब तक यह ओवरले, टारगेट पैटर्न के साथ ज़्यादा से ज़्यादा अलाइन हो सकता है. जब ओवरले और टारगेट पैटर्न इमेज अलाइन होती है, तो दिखाया गया फ़ील्ड ऑफ़ व्यू, सही अनुमान से काफ़ी मिलता-जुलता है वैल्यू. रिपोर्ट किया गया फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू) +/-2 डिग्री के बीच होना चाहिए कैलिब्रेशन मान होता है.
- 'वापस जाएं' बटन दबाएं और सभी इमेज के लिए कैलिब्रेशन टेस्ट दोहराएं DUT के साथ काम करने वाले समाधान.
दूसरे मोड के लिए सीटीएस वेरिफ़ायर चलाएं
CTS 10 R6 और CTS 11 R2 रिलीज़ की शुरुआत में, सीटीएस पुष्टि की सुविधा ज़रूरी टेस्ट के साथ काम करती है वैकल्पिक मोड वाले डिवाइसों या एक से ज़्यादा स्क्रीन मोड वाले डिवाइसों के लिए.
CTS Verifier में मुख्य सूची के तौर पर सबसे ऊपर एक बटन दिख रहा है, जिसका इस्तेमाल करके इसे चालू किया जा सकता है डिवाइस का इस्तेमाल करके, लोग अनफ़ोल्ड और फ़ोल्डेड डिसप्ले मोड के बीच टॉगल कर सकते हैं. सीटीएस वेरिफ़ायर दिखेगा चुने गए डिसप्ले मोड के लिए ज़रूरी टेस्ट कर सकता है. दूसरे विकल्प को लागू करने के लिए का इस्तेमाल करते हैं, तो आपको बटन को सही डिसप्ले पर स्विच करना होगा मोड और दिखाए गए टेस्ट की सूची को चलाएं.
फ़ोल्ड किए गए टेस्ट के नतीजे, उसे अनफ़ोल्ड करने के बाद भी उसी रिपोर्ट में रिकॉर्ड किए जाएंगे टेस्ट. जिस जांच के नतीजे से जांच का सेट है उसकी पहचान करने के लिए, फ़ोल्ड किए गए मोड में, हर जांच के नाम में सफ़िक्स जोड़ा जाता है.
<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
<RunHistory subtest="CREATE_ALARM[folded]">
<Run start="1594176663973" end="1594176665841" isAutomated="false" />
</RunHistory>
</Test>
परिणाम निर्यात करें
सभी जांच पूरी होने के बाद, नतीजों को रिपोर्ट के तौर पर सेव किया जा सकता है और उन्हें डाउनलोड किया जा सकता है कंप्यूटर से कनेक्ट करते हैं. डीयूटी के आधार पर, रिपोर्ट के नामों पर अपने-आप टाइम-स्टैम्प लग जाता है सिस्टम समय.
जांच के नतीजों को सेव करने के लिए, सूची में सबसे ऊपर मौजूद 'सेव करें' (डिस्क) आइकॉन पर टैप करें की कैटगरी में बांट देता है.
उस पॉप-अप मैसेज की इंतज़ार करें जो सेव की गई रिपोर्ट का फ़ाइल पाथ दिखाता है (इसके लिए उदाहरण,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip), तो वह पाथ रिकॉर्ड करेगा.DUT को Linux कंप्यूटर से कनेक्ट करें.
Linux कंप्यूटर पर Android SDK इंस्टॉल करके, रिपोर्ट डाउनलोड करें
adb shell content readयाadb pull CTSVerifierReportPathका इस्तेमाल करके, कनेक्ट किए गए डिवाइस से कॉपी करें.Android 7.x और उसके बाद वाले वर्शन के लिए, नीचे दिए गए निर्देश का इस्तेमाल करके सभी रिपोर्ट डाउनलोड करें:
adb pull /sdcard/verifierReports
Android 6.0 और उससे पहले के वर्शन के लिए, नीचे दिए गए निर्देश का इस्तेमाल करके सभी रिपोर्ट डाउनलोड करें:
adb pull /mnt/sdcard/ctsVerifierReports/
Android 10 और उसके बाद के वर्शन के लिए, ऑटोमोटिव और डिवाइस दूसरा उपयोगकर्ता, डाउनलोड करें नई रिपोर्ट देखने के लिए नीचे दिए गए निर्देश का इस्तेमाल करें:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैकनेक्ट किए गए डिवाइस में उपलब्ध सभी रिपोर्ट को सूची में दिखाने के लिए:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
सूची से कोई रिपोर्ट डाउनलोड करने के लिए, लाइन का आईडी डालें या फ़ाइल नाम. उदाहरण के लिए:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
पास/फ़ेल के नतीजे मिटाने के लिए, CTS Verifier ऐप्लिकेशन में जाकर नतीजे चुनें और मेन्यू > हटाएं.