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

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

आवश्यकताएं

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

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

एनएफसी टेस्ट के लिए यूआईसीसी आवश्यकताएँ

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

  • फ़ील्ड-ऑफ़ (0x54 से लेन-देन डेटा का उपयोग करता है)
  • डी-सेलेक्ट (0x52 से लेनदेन डेटा का उपयोग करता है)
  • एचसीआई कमांड (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. खुली सेटिंग।
  2. सिस्टम > जेस्चर > सिस्टम नेविगेशन पर नेविगेट करें।
  3. किसी भी बटन-आधारित नेविगेशन मोड का चयन करें, यदि उपलब्ध हो तो तीन-बटन मोड को प्राथमिकता दी जाती है।

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

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

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

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

    • परीक्षण के लिए Android के संस्करण के लिए CTS सत्यापनकर्ता APK डाउनलोड करें।

  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. Android 11 और उच्चतर के लिए, डिवाइस की बाहरी शीर्ष-स्तरीय निर्देशिका के अंतर्गत रिपोर्ट को स्व-परिभाषित निर्देशिका में सहेजने की अनुमति देने के लिए निम्न आदेश चलाएँ।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

सीटीएस सत्यापनकर्ता यूएसबी एक्सेसरी टेस्ट

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

सीटीएस सत्यापनकर्ता यूएसबी एक्सेसरी टेस्ट

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

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

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

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

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

    चित्रा 6. यूएसबी एक्सेसरी टेस्ट

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

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

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

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

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

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

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

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

  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
      

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

      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. पास/असफल परिणाम साफ़ करने के लिए, सीटीएस सत्यापनकर्ता ऐप में परिणामों का चयन करें और मेनू > साफ़ करें चुनें।