Android संगतता परीक्षण सूट सत्यापनकर्ता (CTS सत्यापनकर्ता) संगतता परीक्षण सूट (CTS) का पूरक है। जबकि सीटीएस उन एपीआई और कार्यों की जांच करता है जिन्हें स्वचालित किया जा सकता है, सीटीएस सत्यापनकर्ता एपीआई और कार्यों के लिए परीक्षण प्रदान करता है जिसे ऑडियो गुणवत्ता, टचस्क्रीन, एक्सेलेरोमीटर और कैमरे जैसे मैन्युअल इनपुट के बिना स्थिर डिवाइस पर परीक्षण नहीं किया जा सकता है।
आवश्यकताएं
सीटीएस सत्यापनकर्ता चलाने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित उपकरण हैं:
- एंड्रॉइड डिवाइस जिसने सीटीएस को सफलतापूर्वक पास करके एंड्रॉइड एपीआई संगतता को सत्यापित किया है। यह परीक्षणाधीन डिवाइस (DUT) है।
- USB 2.0 संगत पोर्ट के साथ Linux कंप्यूटर। DUT के सभी कनेक्शन इसी पोर्ट से होकर जाते हैं।
- ज्ञात संगत ब्लूटूथ, वाई-फाई डायरेक्ट और एनएफसी होस्ट कार्ड एमुलेशन (एचसीई) कार्यान्वयन के साथ दूसरा एंड्रॉइड डिवाइस।
- एक्सेस प्वाइंट नाम और पासवर्ड के साथ कॉन्फ़िगर किया गया वाई-फाई राउटर। राउटर में इंटरनेट से डिस्कनेक्ट करने की क्षमता होनी चाहिए, लेकिन यह बंद नहीं होना चाहिए।
एनएफसी टेस्ट के लिए यूआईसीसी आवश्यकताएँ
सीटीएस सत्यापनकर्ता के पास निम्नलिखित एनएफसी परीक्षण मामले हैं:
- फ़ील्ड-ऑफ़ (0x54 से लेन-देन डेटा का उपयोग करता है)
- अचयनित करें (0x52 से लेन-देन डेटा का उपयोग करता है)
- HCI कमांड (0025000000) (0x02 से लेनदेन डेटा का उपयोग करता है)
लेन-देन घटना परीक्षणों के लिए दो उपकरणों की आवश्यकता होती है, जिनमें से एक में निम्नलिखित एक्सेस नियमों के साथ सिक्योर एलिमेंट यूआईसीसी होना चाहिए:
- CtsVerifier APK हैश: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- एनएफसी इवेंट एक्सेस के लिए अधिकृत एप्लिकेशन पहचानकर्ता (एआईडी): 0xA000000476416E64726F696443545341
एमुलेटर की तरफ, हम उम्मीद करते हैं कि लेन-देन की घटना इसी गतिविधि को अग्रभूमि में धकेल देगी।
स्थापित करना
टेस्ट डिवाइस के सिस्टम नेविगेशन मोड को निम्नानुसार तीन-बटन मोड में बदलें:
- खुली सेटिंग।
- सिस्टम > जेस्चर > सिस्टम नेविगेशन पर नेविगेट करें।
- किसी भी बटन-आधारित नेविगेशन मोड का चयन करें, यदि उपलब्ध हो तो तीन-बटन मोड को प्राथमिकता दी जाती है।
सीटीएस सत्यापनकर्ता परीक्षण वातावरण स्थापित करने के लिए:
लिनक्स कंप्यूटर पर:
गैर-एसडीके इंटरफेस तक पहुंच की अनुमति देने के लिए सीटीएस सत्यापनकर्ता को स्थापित करने से पहले निम्नलिखित कमांड चलाएँ।
adb shell settings put global hidden_api_policy 1
एंड्रॉइड स्टूडियो स्थापित करें।
परीक्षण करने के लिए Android के संस्करण के लिए CTS सत्यापनकर्ता APK डाउनलोड करें।
DUT को 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
एंड्रॉइड 11 और उच्चतर के लिए, डिवाइस की बाहरी शीर्ष-स्तरीय निर्देशिका के तहत रिपोर्ट को स्व-परिभाषित निर्देशिका में सहेजने की अनुमति देने के लिए निम्न कमांड चलाएँ।
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
जनरेट की गई वर्क प्रोफ़ाइल को सही अनुमति देने के लिए
--user profileIDफ्लैग को निम्नानुसार शामिल करें:adb shell appops set --user profileID com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Android 13 और उच्चतर के लिए, CTS सत्यापनकर्ता के लिए टेस्ट API एक्सेस की अनुमति देने के लिए निम्न कमांड चलाएँ।
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
सुनिश्चित करें कि DUT में सिस्टम डेटा और समय सही ढंग से सेट है।
सीटीएस सत्यापनकर्ता चलाएँ
DUT पर CTS सत्यापनकर्ता आइकन पर टैप करके CTS सत्यापनकर्ता एप्लिकेशन लॉन्च करें।
चित्र 1. सीटीएस सत्यापनकर्ता चिह्न
ऐप मैन्युअल सत्यापन के लिए उपलब्ध कई परीक्षण सेट प्रदर्शित करता है।
चित्र 2. परीक्षणों का सीटीएस सत्यापनकर्ता मेनू
प्रत्येक परीक्षण में स्क्रीन के नीचे सामान्य तत्वों का एक सेट होता है।
चित्र 3. हाइलाइट किए गए सामान्य परीक्षण तत्वों के साथ टेस्ट स्क्रीन
- दर्रा (✓)। यदि DUT जानकारी निर्देशों के अनुसार परीक्षण आवश्यकताओं को पूरा करता है तो टैप करें।
- जानकारी (?). परीक्षण निर्देश प्रदर्शित करने के लिए टैप करें। पहली बार परीक्षण खोले जाने पर स्वचालित रूप से भी प्रकट होता है।
- विफल (!)। यदि DUT जानकारी निर्देशों के अनुसार परीक्षण आवश्यकताओं को पूरा नहीं करता है तो टैप करें।
कुछ परीक्षण, जैसे कि USB उपसाधन मोड और कैमरा अंशांकन परीक्षण, के लिए अतिरिक्त परीक्षण सेटअप और निर्देशों की आवश्यकता होती है, जैसा कि निम्नलिखित अनुभागों में बताया गया है।
8.0 और उच्चतर के लिए USB एक्सेसरी मोड का परीक्षण करें
चित्रा 4. 8.0 और इसके बाद के संस्करण के लिए यूएसबी सहायक परीक्षण प्रक्रिया
चित्रा 5. 8.0 और ऊपर के लिए यूएसबी सहायक मोड का परीक्षण
7.x और उससे कम के लिए USB एक्सेसरी मोड का परीक्षण करें
USB एक्सेसरी टेस्ट के लिए USB डेस्कटॉप मशीन (होस्ट) प्रोग्राम को चलाने के लिए Linux कंप्यूटर की आवश्यकता होती है।
- DUT को Linux कंप्यूटर से कनेक्ट करें।
कंप्यूटर पर, CTS सत्यापनकर्ता पैकेज से
cts-usb-accessoryप्रोग्राम निष्पादित करें:./cts-usb-accessory
DUT पर एक पॉपअप संदेश के प्रकट होने की प्रतीक्षा करें, फिर OK चुनें।
चित्रा 6. यूएसबी सहायक परीक्षण
DUT पर CTS सत्यापनकर्ता एप्लिकेशन में USB एक्सेसरी टेस्ट पर जाएं।
कंप्यूटर पर, कंसोल से आउटपुट की समीक्षा करें। उदाहरण आउटपुट:
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
कैमरे के देखने के क्षेत्र को कैलिब्रेट करें
मध्यम सटीकता के साथ डिवाइस के देखने के क्षेत्र को जल्दी से निर्धारित करने के लिए दृश्य अंशांकन प्रक्रिया के क्षेत्र का उपयोग करें।
परीक्षण वातावरण सेट करें:
- 11" x 17" या A3 आकार के पेपर पर अंशांकन-पैटर्न.पीडीएफ लक्ष्य फ़ाइल प्रिंट करें।
- मुद्रित पैटर्न को कठोर बैकिंग पर माउंट करें।
कैमरा डिवाइस और प्रिंटेड लक्ष्य को निम्न आरेख में दिखाए अनुसार ओरिएंट करें।
चित्र 7. कैमरा मुद्रित लक्ष्य
लक्ष्य चौड़ाई निर्धारित करें:
- मुद्रण अशुद्धियों (~38 सेमी) को ध्यान में रखते हुए लक्ष्य पैटर्न पर ठोस रेखाओं के बीच की दूरी (सेंटीमीटर में) मापें।
- अंशांकन अनुप्रयोग प्रारंभ करें।
- सेटअप बटन दबाएं और मार्कर दूरी चुनें।
- मापें और लक्ष्य पैटर्न (~ 100 सेमी) के लिए दूरी दर्ज करें ।
- अंशांकन पूर्वावलोकन पर वापस जाने के लिए बैक बटन दबाएं।
सत्यापित करें कि डिवाइस और लक्ष्य को चित्र में दिखाए अनुसार रखा गया है और सेटअप संवाद में सही दूरी दर्ज की गई है। पूर्वावलोकन छवि को उस पर आच्छादित एक लंबवत रेखा के साथ प्रदर्शित करता है; यह रेखा लक्ष्य पैटर्न की केंद्र रेखा के साथ संरेखित होनी चाहिए। पारदर्शी ग्रिड का उपयोग अन्य ऊर्ध्वाधर रेखाओं के साथ किया जा सकता है ताकि यह सुनिश्चित किया जा सके कि ऑप्टिकल अक्ष लक्ष्य के लिए ओर्थोगोनल है।
अंशांकन परीक्षण चलाएँ:
- छवि रिज़ॉल्यूशन चुनें (नीचे बाईं ओर चयनकर्ता का उपयोग करके), फिर फ़ोटो लेने के लिए स्क्रीन पर टैप करें। परीक्षण अंशांकन मोड में प्रवेश करता है और छवि पर आच्छादित दो ऊर्ध्वाधर रेखाओं के साथ फोटो प्रदर्शित करता है।
- सटीकता निर्धारित करें:
- यदि रेखाएं कुछ सेंटीमीटर के भीतर लक्ष्य पैटर्न पर लंबवत रेखाओं के साथ संरेखित होती हैं, तो चयनित रिज़ॉल्शन के लिए रिपोर्ट किया गया फ़ील्ड ऑफ़ व्यू सटीक है।
- यदि रेखाएँ संरेखित नहीं होती हैं, तो रिपोर्ट किया गया दृश्य क्षेत्र गलत है। इसे ठीक करने के लिए, स्क्रीन के नीचे स्लाइडर को तब तक समायोजित करें जब तक कि ओवरले लक्ष्य पैटर्न के साथ यथासंभव निकटता से संरेखित न हो जाए। जब ओवरले और लक्ष्य प्रतिमान छवि संरेखित होती है, तो प्रदर्शित दृश्य क्षेत्र सही मान के करीब होता है। देखने का रिपोर्ट किया गया क्षेत्र अंशांकन मान के +/-2 डिग्री के भीतर होना चाहिए।
- वापस बटन दबाएं और डीयूटी द्वारा समर्थित सभी छवि संकल्पों के लिए अंशांकन परीक्षण दोहराएं।
वैकल्पिक मोड के लिए CTS सत्यापनकर्ता चलाएँ
CTS 10 R6 और CTS 11 R2 रिलीज़ शुरू करते हुए, CTS सत्यापनकर्ता वैकल्पिक मोड वाले उपकरणों या एक से अधिक स्क्रीन मोड वाले उपकरणों के लिए आवश्यक परीक्षणों का समर्थन करता है।
सीटीएस सत्यापनकर्ता में मुख्य सूची दृश्य के शीर्ष पर एक बटन दिखाया गया है जो उपयोगकर्ताओं को अनफोल्डेड और फोल्डेड डिस्प्ले मोड के बीच टॉगल करने में सक्षम बनाता है। सीटीएस सत्यापनकर्ता चयनित प्रदर्शन मोड के लिए आवश्यक परीक्षण दिखाएगा। सीटीएस सत्यापनकर्ता में वैकल्पिक मोड को निष्पादित करने के लिए, बटन को उपयुक्त प्रदर्शन मोड में स्विच करना चाहिए और दिखाए गए परीक्षणों की सूची को चलाना चाहिए।
मोड़े गए परीक्षणों के परिणाम अनफ़ोल्ड किए गए परीक्षणों के साथ उसी रिपोर्ट में दर्ज किए जाएंगे। प्रत्येक परीक्षा परिणाम की पहचान करने के लिए जिसमें से परीक्षण सेट है, तह मोड के तहत प्रत्येक परीक्षण नाम में एक प्रत्यय जोड़ा जाता है।
<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>
निर्यात परिणाम
सभी परीक्षण पूर्ण होने के बाद, आप परिणामों को रिपोर्ट के रूप में सहेज सकते हैं और उन्हें कंप्यूटर पर डाउनलोड कर सकते हैं। DUT सिस्टम समय के आधार पर रिपोर्ट के नाम स्वचालित रूप से समय-मुद्रित होते हैं।
अपने परीक्षण परिणामों को सहेजने के लिए, परीक्षण श्रेणियों की सूची के शीर्ष पर सहेजें (डिस्क) आइकन टैप करें।
एक पॉपअप संदेश की प्रतीक्षा करें जो सहेजी गई रिपोर्ट का फ़ाइल पथ प्रदर्शित करता है (उदाहरण के लिए,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip), फिर पथ रिकॉर्ड करें।DUT को 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 सत्यापनकर्ता ऐप में परिणामों का चयन करें और मेनू > साफ़ करें चुनें।