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

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. बटन पर आधारित कोई भी नेविगेशन मोड चुनें. अगर उपलब्ध हो, तो तीन बटन वाला मोड चुनें.

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

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

    • CTS Verifier इंस्टॉल करने से पहले, यह कमांड चलाएं, ताकि नॉन-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 Verifier आइकॉन पर टैप करके, CTS Verifier ऐप्लिकेशन लॉन्च करें.

लॉन्चर में CTS Verifier का आइकॉन

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

ऐप्लिकेशन, मैन्युअल तरीके से पुष्टि करने के लिए कई टेस्ट सेट दिखाता है.

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

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

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

स्ट्रीमिंग वीडियो की क्वालिटी की पुष्टि करने वाला टूल

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

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

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

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

CTS Verifier usb accessory test

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

CTS Verifier usb accessory test

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

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

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

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

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

    ./cts-usb-accessory

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

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

  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 cm).
    5. कैलिब्रेशन की झलक देखने के लिए, 'वापस जाएं' बटन दबाएं.

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

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

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

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

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

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

CTS-V टॉगल स्विच

आठवीं इमेज. सीटीएस की पुष्टि करने वाले टूल का टॉगल स्विच

फ़ोल्ड किए गए टेस्ट के नतीजे, अनफ़ोल्ड किए गए टेस्ट के साथ एक ही रिपोर्ट में रिकॉर्ड किए जाएंगे. फ़ोल्ड किए गए मोड में, हर टेस्ट के नाम के बाद एक सफ़िक्स जोड़ा जाता है, ताकि यह पता चल सके कि टेस्ट का सेट किस टेस्ट के नतीजे से है.

<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. जांच के नतीजे सेव करने के लिए, जांच की कैटगरी की सूची में सबसे ऊपर मौजूद, सेव करें (डिस्क) आइकॉन पर टैप करें.

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

  3. डीयूटी को 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

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

      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 ऐप्लिकेशन में नतीजे चुनें और मेन्यू > मिटाएं को चुनें.