सीटीएस सत्यापनकर्ता का उपयोग करना

एंड्रॉइड संगतता परीक्षण सूट सत्यापनकर्ता (सीटीएस सत्यापनकर्ता) संगतता परीक्षण सूट (सीटीएस) का पूरक है। जबकि सीटीएस उन एपीआई और कार्यों की जांच करता है जिन्हें स्वचालित किया जा सकता है, सीटीएस सत्यापनकर्ता उन एपीआई और कार्यों के लिए परीक्षण प्रदान करता है जिन्हें मैन्युअल इनपुट या पोजिशनिंग के बिना स्थिर डिवाइस पर परीक्षण नहीं किया जा सकता है, जैसे ऑडियो गुणवत्ता, टचस्क्रीन, एक्सेलेरोमीटर और कैमरा।

आवश्यकताएं

सीटीएस सत्यापनकर्ता चलाने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित उपकरण हैं:

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

सुनिश्चित करें कि आपने यूडब्ल्यूबी, वाई-फाई एनएएन और ब्लूटूथ आरएसएसआई के लिए दूरी (निकटता) मापने के परीक्षणों के लिए आवश्यक तिपाई, डिवाइस धारक और पूर्व-मापी दूरी भी तैयार की है। विवरण के लिए, उपस्थिति अंशांकन देखें।

एनएफसी परीक्षणों के लिए यूआईसीसी आवश्यकताएँ

सीटीएस सत्यापनकर्ता के पास निम्नलिखित एनएफसी परीक्षण मामले हैं:

  • फ़ील्ड-ऑफ़ (0x54 से लेनदेन डेटा का उपयोग करता है)
  • चयन रद्द करें (0x52 से लेनदेन डेटा का उपयोग करता है)
  • एचसीआई कमांड (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

एमुलेटर पक्ष पर, हम उम्मीद करते हैं कि लेनदेन घटना संबंधित गतिविधि को अग्रभूमि में धकेल देगी।

स्थापित करना

परीक्षण डिवाइस के सिस्टम नेविगेशन मोड को निम्नानुसार तीन-बटन मोड में बदलें:

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

सीटीएस सत्यापनकर्ता परीक्षण वातावरण स्थापित करने के लिए:

  1. लिनक्स कंप्यूटर पर:

    • गैर-एसडीके इंटरफेस तक पहुंच की अनुमति देने के लिए सीटीएस सत्यापनकर्ता स्थापित करने से पहले निम्नलिखित कमांड चलाएँ।

      adb shell settings put global hidden_api_policy 1
      
    • एंड्रॉइड स्टूडियो इंस्टॉल करें।

    • परीक्षण के लिए एंड्रॉइड संस्करण के लिए सीटीएस सत्यापनकर्ता एपीके डाउनलोड करें।

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

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

    adb install -r -g CtsVerifier.apk
    
  4. एंड्रॉइड 10 और उच्चतर के लिए, ऐप को रिपोर्ट बनाने की अनुमति देने के लिए निम्नलिखित कमांड चलाएँ।

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
    
  5. एंड्रॉइड 11 और उच्चतर के लिए, डिवाइस की बाहरी शीर्ष-स्तरीय निर्देशिका के तहत एक स्व-परिभाषित निर्देशिका में रिपोर्ट को सहेजने की अनुमति देने के लिए निम्न कमांड चलाएँ।

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. एंड्रॉइड 13 और उच्चतर के लिए, सीटीएस सत्यापनकर्ता के लिए परीक्षण एपीआई एक्सेस की अनुमति देने के लिए निम्नलिखित कमांड चलाएँ।

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. एंड्रॉइड 14 और उच्चतर के लिए, ऐप को स्क्रीन चालू करने की अनुमति देने के लिए निम्नलिखित कमांड चलाएँ।

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
    
  8. सुनिश्चित करें कि DUT में सिस्टम दिनांक और समय सही ढंग से सेट है।

सीटीएस सत्यापनकर्ता चलाएँ

DUT पर CTS सत्यापनकर्ता आइकन टैप करके CTS सत्यापनकर्ता एप्लिकेशन लॉन्च करें।

लॉन्चर में सीटीएस सत्यापनकर्ता आइकन

चित्र 1. सीटीएस सत्यापनकर्ता आइकन

ऐप मैन्युअल सत्यापन के लिए उपलब्ध कई परीक्षण सेट प्रदर्शित करता है।

परीक्षणों का सीटीएस सत्यापनकर्ता मेनू

चित्र 2. परीक्षणों का सीटीएस सत्यापनकर्ता मेनू

प्रत्येक परीक्षण में स्क्रीन के नीचे सामान्य तत्वों का एक सेट होता है।

स्ट्रीमिंग वीडियो गुणवत्ता सत्यापनकर्ता

चित्र 3. सामान्य परीक्षण तत्वों पर प्रकाश डाला गया परीक्षण स्क्रीन

  • पास (✓). यदि DUT जानकारी निर्देशों के अनुसार परीक्षण आवश्यकताओं को पूरा करता है तो टैप करें।
  • जानकारी (?). परीक्षण निर्देश प्रदर्शित करने के लिए टैप करें। पहली बार कोई परीक्षण खोले जाने पर भी स्वचालित रूप से प्रकट होता है।
  • असफल (!)। यदि DUT जानकारी निर्देशों के अनुसार परीक्षण आवश्यकताओं को पूरा नहीं करता है तो टैप करें।

कुछ परीक्षणों, जैसे कि यूएसबी एक्सेसरी मोड और कैमरा कैलिब्रेशन टेस्ट के लिए अतिरिक्त परीक्षण सेटअप और निर्देशों की आवश्यकता होती है, जैसा कि निम्नलिखित अनुभागों में बताया गया है।

8.0 और उच्चतर के लिए यूएसबी एक्सेसरी मोड का परीक्षण करें

सीटीएस सत्यापनकर्ता यूएसबी सहायक परीक्षण

चित्र 4. 8.0 और उससे ऊपर के लिए यूएसबी सहायक परीक्षण प्रक्रिया

सीटीएस सत्यापनकर्ता यूएसबी सहायक परीक्षण

चित्र 5. 8.0 और उससे ऊपर के लिए यूएसबी एक्सेसरी मोड का परीक्षण

7.x और उससे कम के लिए USB एक्सेसरी मोड का परीक्षण करें

यूएसबी एक्सेसरी परीक्षण के लिए यूएसबी डेस्कटॉप मशीन (होस्ट) प्रोग्राम को चलाने के लिए एक लिनक्स कंप्यूटर की आवश्यकता होती है।

  1. DUT को Linux कंप्यूटर से कनेक्ट करें.
  2. कंप्यूटर पर, CTS सत्यापनकर्ता पैकेज से cts-usb-accessory प्रोग्राम निष्पादित करें:

    ./cts-usb-accessory
  3. DUT पर पॉपअप संदेश आने तक प्रतीक्षा करें, फिर ठीक चुनें।
    सीटीएस सत्यापनकर्ता यूएसबी सहायक परीक्षण

    चित्र 6. USB सहायक परीक्षण

  4. DUT पर CTS सत्यापनकर्ता एप्लिकेशन में 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. कैलिब्रेशन-पैटर्न.पीडीएफ लक्ष्य फ़ाइल को 11" x 17" या ए3 आकार के कागज़ पर प्रिंट करें।
    2. मुद्रित पैटर्न को एक कठोर बैकिंग पर माउंट करें।
    3. कैमरा डिवाइस और मुद्रित लक्ष्य को निम्नलिखित चित्र में दिखाए अनुसार ओरिएंट करें।
      कैमरा मुद्रित लक्ष्य

      चित्र 7. कैमरा मुद्रित लक्ष्य

  2. लक्ष्य चौड़ाई निर्धारित करें:

    1. मुद्रण अशुद्धियों (~38 सेमी) को ध्यान में रखने के लिए लक्ष्य पैटर्न पर ठोस रेखाओं के बीच की दूरी (सेंटीमीटर में) मापें।
    2. अंशांकन अनुप्रयोग प्रारंभ करें.
    3. सेटअप बटन दबाएं और मार्कर दूरी चुनें।
    4. लक्ष्य पैटर्न (~100 सेमी) की दूरी मापें और दर्ज करें।
    5. अंशांकन पूर्वावलोकन पर लौटने के लिए बैक बटन दबाएँ।
  3. सत्यापित करें कि डिवाइस और लक्ष्य को चित्र में दिखाए अनुसार रखा गया है और सेटअप संवाद में सही दूरी दर्ज की गई है। पूर्वावलोकन छवि को उस पर एक लंबवत रेखा के साथ प्रदर्शित करता है; यह रेखा लक्ष्य पैटर्न की केंद्र रेखा के साथ संरेखित होनी चाहिए। पारदर्शी ग्रिड का उपयोग अन्य ऊर्ध्वाधर रेखाओं के साथ किया जा सकता है ताकि यह सुनिश्चित किया जा सके कि ऑप्टिकल अक्ष लक्ष्य के लिए ऑर्थोगोनल है।

  4. अंशांकन परीक्षण चलाएँ:

    1. एक छवि रिज़ॉल्यूशन चुनें (नीचे बाईं ओर चयनकर्ता का उपयोग करके), फिर फ़ोटो लेने के लिए स्क्रीन पर टैप करें। परीक्षण अंशांकन मोड में प्रवेश करता है और छवि पर दो लंबवत रेखाओं के साथ फोटो प्रदर्शित करता है।
    2. सटीकता निर्धारित करें:
      • यदि रेखाएं कुछ सेंटीमीटर के भीतर लक्ष्य पैटर्न पर ऊर्ध्वाधर रेखाओं के साथ संरेखित होती हैं, तो चयनित रिज़ॉल्यूशन के लिए रिपोर्ट किया गया दृश्य क्षेत्र सटीक है।
      • यदि रेखाएँ संरेखित नहीं होती हैं, तो रिपोर्ट किया गया दृश्य क्षेत्र ग़लत है। इसे ठीक करने के लिए, स्क्रीन के नीचे स्लाइडर को तब तक समायोजित करें जब तक कि ओवरले लक्ष्य पैटर्न के साथ यथासंभव निकट से संरेखित न हो जाए। जब ओवरले और लक्ष्य पैटर्न छवि को संरेखित किया जाता है, तो दृश्य का प्रदर्शित क्षेत्र सही मान के करीब होता है। रिपोर्ट किया गया दृश्य क्षेत्र अंशांकन मान के +/-2 डिग्री के भीतर होना चाहिए।
    3. बैक बटन दबाएं और DUT द्वारा समर्थित सभी छवि रिज़ॉल्यूशन के लिए अंशांकन परीक्षण दोहराएं।

वैकल्पिक मोड के लिए CTS सत्यापनकर्ता चलाएँ

सीटीएस 10 आर6 और सीटीएस 11 आर2 रिलीज शुरू करते हुए, सीटीएस सत्यापनकर्ता वैकल्पिक मोड वाले उपकरणों के लिए, या एक से अधिक स्क्रीन मोड वाले उपकरणों के लिए आवश्यक परीक्षणों का समर्थन करता है।

सीटीएस सत्यापनकर्ता में मुख्य सूची दृश्य के शीर्ष पर एक बटन दिखाया गया है जो उपयोगकर्ताओं को अनफोल्डेड और फोल्डेड डिस्प्ले मोड के बीच टॉगल करने में सक्षम बनाता है। सीटीएस सत्यापनकर्ता चयनित डिस्प्ले मोड के लिए आवश्यक परीक्षण दिखाएगा। सीटीएस सत्यापनकर्ता में वैकल्पिक मोड निष्पादित करने के लिए, बटन को उचित डिस्प्ले मोड पर स्विच करना चाहिए और दिखाए गए परीक्षणों की सूची चलानी चाहिए।

सीटीएस-वी टॉगल स्विच

मुड़े हुए परीक्षणों के परिणाम सामने आए परीक्षणों के साथ एक ही रिपोर्ट में दर्ज किए जाएंगे। प्रत्येक परीक्षण परिणाम की पहचान करने के लिए जिसमें से परीक्षण सेट है, फोल्ड मोड के तहत प्रत्येक परीक्षण नाम में एक प्रत्यय जोड़ा जाता है।

<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 सिस्टम समय के आधार पर रिपोर्ट नामों पर स्वचालित रूप से टाइम-स्टैम्प लगा दिया जाता है।

  1. अपने परीक्षण परिणामों को सहेजने के लिए, परीक्षण श्रेणियों की सूची के शीर्ष पर सेव (डिस्क) आइकन पर टैप करें।

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

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

  4. लिनक्स कंप्यूटर पर एंड्रॉइड एसडीके इंस्टॉलेशन से, adb shell content read या adb pull CTSVerifierReportPath का उपयोग करके कनेक्टेड डिवाइस से रिपोर्ट डाउनलोड करें।

    • Android 7.x और उच्चतर के लिए, निम्न आदेश का उपयोग करके सभी रिपोर्ट डाउनलोड करें:

      adb pull /sdcard/verifierReports
      
    • Android 6.0 और उससे पहले के संस्करण के लिए, निम्न आदेश का उपयोग करके सभी रिपोर्ट डाउनलोड करें:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • एंड्रॉइड 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. उत्तीर्ण/असफल परिणामों को साफ़ करने के लिए, सीटीएस सत्यापनकर्ता ऐप में परिणामों का चयन करें और मेनू > साफ़ करें का चयन करें।