सीटीएस वेरिफ़ायर का इस्तेमाल करना

Android Compatibility Test Suite Verifier (CTS Verifier), Compatibility Test Suite (CTS) के साथ काम करता है. सीटीएस उन एपीआई और फ़ंक्शन की जांच करता है जिन्हें ऑटोमेट किया जा सकता है. वहीं, सीटीएस की पुष्टि करने वाला टूल उन एपीआई और फ़ंक्शन की जांच करता है जिनकी जांच, मैन्युअल इनपुट या पोज़िशनिंग के बिना, स्टैशनरी डिवाइस पर नहीं की जा सकती. जैसे, ऑडियो क्वालिटी, टचस्क्रीन, ऐक्सीलेरोमीटर, और कैमरा.

ज़रूरी शर्तें

CTS Verifier चलाने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

• ऐसा Android डिवाइस जिसने सीटीएस टेस्ट पास करके, Android API के साथ काम करने की पुष्टि की हो. यह टेस्ट किया जा रहा डिवाइस (DUT) है.
• यूएसबी 2.0 पोर्ट वाला Linux कंप्यूटर. डीयूटी से जुड़े सभी कनेक्शन, इस पोर्ट से होते हैं.
• दूसरा Android डिवाइस, जिसमें ब्लूटूथ, वाई-फ़ाई डायरेक्ट, वाई-फ़ाई ऐवेयर, UWB (अगर डीयूटी UWB के साथ काम करता है), और एनएफ़सी होस्ट कार्ड इम्यूलेशन (एचसीई) लागू करने की सुविधा हो.
• ऐक्सेस पॉइंट के नाम और पासवर्ड के साथ कॉन्फ़िगर किया गया वाई-फ़ाई राऊटर. राऊटर में इंटरनेट से डिसकनेक्ट होने की सुविधा होनी चाहिए, लेकिन वह बंद न हो.

पक्का करें कि आपने UWB, वाई-फ़ाई एनएएन, और ब्लूटूथ आरएसएसआई के लिए, दूरी (प्रॉक्सिमिटी) को मेज़र करने वाले टेस्ट के लिए, ट्राइपॉड, डिवाइस होल्डर, और पहले से मेज़र की गई दूरियां भी तैयार कर ली हों. ज़्यादा जानकारी के लिए, मौजूदगी का कैलिब्रेशन देखें.

एनएफ़सी टेस्ट के लिए यूआईसीसी से जुड़ी ज़रूरी शर्तें

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
• एनएफ़सी इवेंट को ऐक्सेस करने के लिए, अनुमति पा चुके ऐप्लिकेशन आइडेंटिफ़ायर (एआईडी): 0xA000000476416E64726F696443545341

हमारा अनुमान है कि इम्यूलेटर की ओर से, लेन-देन वाले इवेंट से जुड़ी गतिविधि को फ़ोरग्राउंड में भेजा जाएगा.

सेटअप

टेस्ट डिवाइस के सिस्टम नेविगेशन मोड को, तीन बटन वाले मोड में बदलने के लिए यहां दिया गया तरीका अपनाएं:

1. Settings खोलें.
2. सिस्टम > जेस्चर > सिस्टम नेविगेशन पर जाएं.
3. बटन पर आधारित कोई भी नेविगेशन मोड चुनें. अगर उपलब्ध हो, तो तीन बटन वाला मोड चुनें.

ध्यान दें: Android 10 पर काम करने वाले Pixel 4 डिवाइसों पर, सिस्टम नेविगेशन मोड बदलना, वर्कफ़्लो का एक विकल्प है. यह अन्य Android डिवाइसों या ओएस वर्शन पर बदल सकता है.

CTS Verifier का टेस्टिंग एनवायरमेंट सेट अप करने के लिए:

1. Linux कंप्यूटर पर:

   • CTS पुष्टि करने वाले टूल को इंस्टॉल करने से पहले, यहां दिया गया निर्देश चलाएं, ताकि नॉन-SDK इंटरफ़ेस को ऐक्सेस करने की अनुमति दी जा सके.

     adb shell settings put global hidden_api_policy 1
     

   • Android Studio इंस्टॉल करें.

   • जिस Android वर्शन की जांच करनी है उसके लिए, CTS Verifier APK डाउनलोड करें.

2. डीयूटी को Linux कंप्यूटर से कनेक्ट करें.

3. Linux कंप्यूटर पर टर्मिनल से, डीयूटी पर CtsVerifier.apk इंस्टॉल करें.

   adb install -r -g CtsVerifier.apk
   

4. Android 10 और उसके बाद के वर्शन के लिए, ऐप्लिकेशन को रिपोर्ट बनाने की अनुमति देने के लिए, यह कमांड चलाएं.

   adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
   

5. Android 11 और उसके बाद के वर्शन के लिए, डिवाइस की बाहरी टॉप-लेवल डायरेक्ट्री में, खुद से तय की गई डायरेक्ट्री में रिपोर्ट सेव करने की अनुमति देने के लिए, यह कमांड चलाएं.

   adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
   

6. Android 13 और उसके बाद के वर्शन के लिए, CTS पुष्टि करने वाले टूल के लिए टेस्ट एपीआई ऐक्सेस की अनुमति देने के लिए, यह कमांड चलाएं.

   adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
   

7. Android 14 और उसके बाद के वर्शन के लिए, ऐप्लिकेशन को स्क्रीन चालू करने की अनुमति देने के लिए, यह कमांड चलाएं.

   adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
   

8. पक्का करें कि डीयूटी में, सिस्टम की तारीख और समय सही तरीके से सेट किए गए हों.

ध्यान दें: ज़्यादा जानकारी के लिए, इंस्टैंट ऐप्लिकेशन के लिए CTS की पुष्टि करने वाली सुविधा देखें.

सीटीएस की पुष्टि करने वाला टूल चलाना

डीयूटी पर CTS Verifier आइकॉन पर टैप करके, CTS Verifier ऐप्लिकेशन लॉन्च करें.

पहली इमेज. सीटीएस की पुष्टि करने वाले का आइकॉन

ऐप्लिकेशन में, मैन्युअल तरीके से पुष्टि करने के लिए कई टेस्ट सेट उपलब्ध होते हैं.

दूसरी इमेज. टेस्ट के लिए सीटीएस की पुष्टि करने वाले टूल का मेन्यू

हर टेस्ट में, स्क्रीन पर सबसे नीचे सामान्य एलिमेंट का एक सेट होता है.

तीसरी इमेज. टेस्ट स्क्रीन, जिसमें सामान्य टेस्ट एलिमेंट हाइलाइट किए गए हैं

• पास (✓). अगर डीयूटी, जानकारी के निर्देशों के मुताबिक टेस्ट की ज़रूरी शर्तें पूरी करता है, तो टैप करें.
• जानकारी (?). टेस्ट के निर्देश देखने के लिए टैप करें. यह पहली बार टेस्ट खोलने पर भी अपने-आप दिखता है.
• फ़ेल (!). अगर डीयूटी, जानकारी के लिए दिए गए निर्देशों के मुताबिक, जांच की ज़रूरी शर्तों को पूरा नहीं करता है, तो टैप करें.

ध्यान दें: कुछ टेस्ट में पास/फ़ेल का पता अपने-आप हो जाता है.

यूएसबी ऐक्सेसरी मोड और कैमरे के कैलिब्रेशन टेस्ट जैसे कुछ टेस्ट के लिए, टेस्ट का अतिरिक्त सेटअप और निर्देश ज़रूरी होते हैं. इनके बारे में नीचे दिए गए सेक्शन में बताया गया है.

Android 8.0 और उसके बाद के वर्शन के लिए, यूएसबी ऐक्सेसरी मोड की जांच करना

चौथी इमेज. Android 8.0 और इसके बाद के वर्शन के लिए, यूएसबी ऐक्सेसरी की जांच करने का तरीका

पांचवीं इमेज. 8.0 और इसके बाद के वर्शन के लिए, यूएसबी ऐक्सेसरी मोड की जांच करना

7.x और इससे पहले के वर्शन के लिए, यूएसबी एक्सेसरी मोड की जांच करना

यूएसबी एक्सेसरी की जांच करने के लिए, Linux कंप्यूटर की ज़रूरत होती है, ताकि यूएसबी डेस्कटॉप मशीन (होस्ट) प्रोग्राम को चलाया जा सके.

1. डीयूटी को Linux कंप्यूटर से कनेक्ट करें.

2. कंप्यूटर पर, CTS Verifier पैकेज से cts-usb-accessory प्रोग्राम को चलाएं:

   ./cts-usb-accessory

3. डीयूटी पर पॉप-अप मैसेज दिखने का इंतज़ार करें. इसके बाद, ठीक है को चुनें.
   

   छठी इमेज. यूएसबी ऐक्सेसरी की जांच

4. डीयूटी पर, CTS Verifier ऐप्लिकेशन में USB ऐक्सेसरी टेस्ट पर जाएं.

5. कंप्यूटर पर, कंसोल से मिले आउटपुट की समीक्षा करें. आउटपुट का उदाहरण:

   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
   

कैमरे के फ़ील्ड ऑफ़ व्यू को कैलिब्रेट करना

फ़ील्ड ऑफ़ व्यू को कैलिब्रेट करने की प्रोसेस का इस्तेमाल करके, डिवाइस के फ़ील्ड ऑफ़ व्यू का पता लगाएं.

1. टेस्ट एनवायरमेंट सेट अप करें:

   1. calibration-pattern.pdf टारगेट फ़ाइल को 11” x 17” या A3 साइज़ के पेपर पर प्रिंट करें.
   2. प्रिंट किए गए पैटर्न को किसी कठोर बैकिंग पर माउंट करें.

   3. कैमरा डिवाइस और प्रिंट किए गए टारगेट को इस डायग्राम में दिखाए गए तरीके से अलाइन करें.
      

      सातवीं इमेज. कैमरे से प्रिंट किया गया टारगेट

2. टारगेट की चौड़ाई सेट करें:

   1. प्रिंटिंग में होने वाली गड़बड़ियों को ध्यान में रखते हुए, टारगेट पैटर्न पर मौजूद सॉलिड लाइन के बीच की दूरी (सेंटीमीटर में) को मेज़र करें. यह दूरी, ~38 cm होनी चाहिए.
   2. कैलिब्रेशन ऐप्लिकेशन शुरू करें.
   3. सेटअप बटन दबाएं और मार्कर की दूरी चुनें.
   4. टारगेट पैटर्न से दूरी को मापें और डालें (~100 सें॰मी॰).
   5. कैलिब्रेशन की झलक देखने के लिए, 'वापस जाएं' बटन दबाएं.

3. पुष्टि करें कि डिवाइस और टारगेट, फ़ोटो में दिखाए गए तरीके से रखे गए हों और सेटअप डायलॉग में सही दूरियां डाली गई हों. झलक में, इमेज पर एक वर्टिकल लाइन ओवरले की गई है. यह लाइन, टारगेट पैटर्न की सेंटर लाइन के साथ अलाइन होनी चाहिए. पारदर्शी ग्रिड का इस्तेमाल, अन्य वर्टिकल लाइनों के साथ किया जा सकता है. इससे यह पक्का किया जा सकता है कि ऑप्टिकल ऐक्सिस, टारगेट के लिए ऑर्थोगोनल है.

4. कैलिब्रेशन टेस्ट चलाएं:

   1. सबसे नीचे बाईं ओर मौजूद सिलेक्टर का इस्तेमाल करके, इमेज का रिज़ॉल्यूशन चुनें. इसके बाद, फ़ोटो लेने के लिए स्क्रीन पर टैप करें. इसके बाद, टेस्ट कैलिब्रेशन मोड में जाता है और फ़ोटो को इमेज पर दो वर्टिकल लाइनों से ओवरले करके दिखाया जाता है.
   2. सटीक होने की जांच करना:
      • अगर लाइनें, टारगेट पैटर्न पर कुछ सेंटीमीटर के अंदर वर्टिकल लाइनों से अलाइन हैं, तो चुने गए रिज़ॉल्यूशन के लिए रिपोर्ट किया गया फ़ील्ड ऑफ़ व्यू सटीक होगा.
      • अगर लाइनें अलाइन नहीं होती हैं, तो इसका मतलब है कि फ़ील्ड ऑफ़ व्यू की रिपोर्ट गलत है. इसे ठीक करने के लिए, स्क्रीन के नीचे मौजूद स्लाइडर को तब तक अडजस्ट करें, जब तक कि ओवरले, टारगेट पैटर्न के साथ अलाइन नहीं हो जाती. जब ओवरले और टारगेट पैटर्न की इमेज अलाइन होती हैं, तो व्यू का दिखाया गया फ़ील्ड, सही वैल्यू का करीब-करीब सटीक अनुमान होता है. रिपोर्ट किया गया फ़ील्ड ऑफ़ व्यू, कैलिब्रेशन वैल्यू से +/-2 डिग्री के अंदर होना चाहिए.
   3. 'वापस जाएं' बटन दबाएं और डीयूटी के साथ काम करने वाले सभी इमेज रिज़ॉल्यूशन के लिए कैलिब्रेशन टेस्ट को दोहराएं.

अन्य मोड के लिए CTS Verifier चलाना

CTS 10 R6 और CTS 11 R2 रिलीज़ से, CTS Verifier उन डिवाइसों के लिए ज़रूरी टेस्ट करता है जिनमें अलग-अलग मोड या एक से ज़्यादा स्क्रीन मोड होते हैं.

CTS Verifier में मुख्य सूची व्यू में सबसे ऊपर एक बटन दिखता है. इसकी मदद से, उपयोगकर्ता फ़ोल्ड किए गए और अनफ़ोल्ड किए गए डिसप्ले मोड के बीच टॉगल कर सकते हैं. चुने गए डिसप्ले मोड के लिए, सीटीएस की पुष्टि करने वाला टूल ज़रूरी टेस्ट दिखाएगा. 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>

नतीजे एक्सपोर्ट करना

सभी जांच पूरी होने के बाद, नतीजों को रिपोर्ट के तौर पर सेव किया जा सकता है और उन्हें कंप्यूटर पर डाउनलोड किया जा सकता है. रिपोर्ट के नामों पर, डीयूटी के सिस्टम टाइम के आधार पर अपने-आप टाइमस्टैंप जुड़ जाता है.

ध्यान दें: टेस्ट के नतीजे की मेट्रिक (नतीजे मिलने में लगने वाला समय और ऑटोमेशन का पता लगाना) को सेव की गई रिपोर्ट से इकट्ठा किया जाता है. इसका इस्तेमाल सिर्फ़ टेस्ट सुइट को बेहतर बनाने के लिए किया जाता है.

1. जांच के नतीजे सेव करने के लिए, जांच की कैटगरी की सूची में सबसे ऊपर मौजूद, सेव करें (डिस्क) आइकॉन पर टैप करें.

   ध्यान दें: Android 7.0 और इसके बाद के वर्शन में, झलक देखने की सुविधा शामिल नहीं है.

2. सेव की गई रिपोर्ट का फ़ाइल पाथ दिखाने वाले पॉप-अप मैसेज का इंतज़ार करें. उदाहरण के लिए, /sdcard/verifierReports/ctsVerifierReport-date-time.zip. इसके बाद, पाथ रिकॉर्ड करें.

3. DUT को Linux कंप्यूटर से कनेक्ट करें.

4. 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
     

     ध्यान दें: CURRENT_USER आईडी पाने के लिए, adb shell am get-current-user का इस्तेमाल करें.

     कनेक्ट किए गए डिवाइस में उपलब्ध सभी रिपोर्ट को सूची में दिखाने के लिए:

     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
     

5. पास/फ़ेल के नतीजे मिटाने के लिए, CTS Verifier ऐप्लिकेशन में नतीजे चुनें और मेन्यू > मिटाएं को चुनें.