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

कैमरा एक्सटेंशन की पुष्टि करने वाले टूल की मदद से, डिवाइस बनाने वाली कंपनियां पुष्टि करें कि कैमरा एक्सटेंशन के लिए, OEM वेंडर लाइब्रेरी सही तरीके से लागू किया गया हो. इस टूल में ऑटोमेटेड और मैन्युअल तरीके से पुष्टि करने की सुविधा शामिल है टेस्ट.

  • अपने-आप होने वाली पुष्टि की जांच: इस बात की पुष्टि करें कि वेंडर लाइब्रेरी इंटरफ़ेस सही ढंग से लागू किया गया है. उदाहरण के लिए, अगर CaptureProcessor के लिए ज़रूरी है, तो परीक्षण पुष्टि करते हैं कि ImageCaptureExtenderImpl#getCaptureStages() ज़रूरी जानकारी दिखाता है इमेज कैप्चर करने के लिए CaptureStage इंस्टेंस.

  • मैन्युअल तरीके से पुष्टि करना: इससे इमेज के असर और क्वालिटी की पुष्टि करने में मदद मिलती है कैप्चर की गई इमेज और झलक देखी जा सकती हैं. उदाहरण के लिए, जांच में डिवाइस चेहरे की फ़ोटो क्वालिटी में सुधार करने की सुविधा की पुष्टि मैन्युअल तौर पर करती है या नहीं सही तरीके से लागू किया जाता है या बोकेह स्ट्रेंथ काफ़ी है या नहीं.

पुष्टि करने वाले टूल का सोर्स कोड, एक्सटेंशन टेस्ट ऐप्लिकेशन में Android Jetpack डेटा स्टोर करने की जगह.

कैमरा एक्सटेंशन की पुष्टि करने वाला टूल बनाएं

एक्सटेंशन की पुष्टि करने वाला टूल बनाने के लिए, यह तरीका अपनाएं:

  1. Android Jetpack लाइब्रेरी का सोर्स कोड डाउनलोड करें. जानकारी के लिए, यह देखें कोड देखें सेक्शन में Android Jetpack README.

  2. गेम की दुनिया extensionstestapp APK के साथ दिखेगा. इससे, मैन्युअल तरीके से पुष्टि करने वाले टेस्ट चलाए जा सकते हैं.

      cd path/to/checkout/frameworks/support/
      ./gradlew camera:integration-tests:camera-testapp-extensions:assembleDebug
    

    APK का आउटपुट इस पाथ पर उपलब्ध होता है:

      path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
    
  3. गेम की दुनिया androidTest APK के साथ दिखेगा. यह APK, अपने-आप पुष्टि करने वाले टेस्ट चलाने की अनुमति देता है.

      cd path/to/checkout/frameworks/support/
      ./gradlew camera:integration-tests:camera-testapp-extensions:assembleAndroidTest
    

    APK का आउटपुट इस पाथ पर उपलब्ध होता है:

      path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
    

अपने-आप पुष्टि होने की सुविधा की जांच करना

अपने-आप होने वाली पुष्टि की जांच करने के लिए, extensionstestapp इंस्टॉल करें और androidTest APK.

  • extensionstestapp APK

      adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
    
  • androidTest APK

      adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
    

सभी ऑटोमेटेड टेस्ट चलाना

APK इंस्टॉल करने के बाद, वेंडर की पुष्टि करने वाले सभी ऑटोमेटेड टेस्ट चलाने के लिए लाइब्रेरी लागू करने के लिए, इन कमांड को चलाएं:

adb shell am instrument -w -r androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

अगर सभी जांच में पास हो जाते हैं, तो OK नतीजा मिलता है. अगर ऐसा नहीं किया जाता है, तो फ़ाइनल टेस्ट रिपोर्ट को सभी जांच पूरी होने के बाद, टर्मिनल में हुई गड़बड़ियों को दिखाता है.

ऑटोमेटेड_वैलिडेशन_नतीजे-पास

पहला डायग्राम. अपने-आप होने वाली जांच के नतीजे ठीक हैं

ऑटोमेटेड_वैलिडेशन_result-fail

दूसरा डायग्राम. अपने-आप होने वाली जांच के नतीजे नहीं मिले

किसी खास क्लास के लिए अपने-आप होने वाले टेस्ट चलाना

किसी खास क्लास के ऑटोमेटेड टेस्ट चलाने के लिए, टारगेट क्लास के साथ करना शामिल है. नीचे दिए गए उदाहरण में ImageCaptureTest क्लास:

adb shell am instrument -w -r -e class **androidx.camera.integration.extensions.ImageCaptureTest** androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

मैन्युअल तरीके से पुष्टि करने की जांच करना

मैन्युअल तरीके से पुष्टि करने वाले टेस्ट इसमें मिलते हैं एक्सटेंशन टेस्ट ऐप्लिकेशन भी डाउनलोड कर सकते हैं. एक्सटेंशन परीक्षण ऐप्लिकेशन को इंस्टॉल और लॉन्च करने के बाद, पुष्टि करने वाले टूल मोड में, सबसे ऊपर दाईं ओर मौजूद मेन्यू आइटम पर टैप करें.

पुष्टि करने वाले टूल मोड पर स्विच करने के बाद, पहले पेज पर सभी कैमरों की सूची दिखती है जिनमें यह शामिल है REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE क्षमता. अगर कोई कैमरा किसी भी एक्सटेंशन मोड के साथ काम नहीं करता है, तो उससे जुड़े सूची में मौजूद आइटम का रंग स्लेटी है.

Camera_validation_result-initial

तीसरी इमेज. पुष्टि करने वाला टूल मोड

टेस्टिंग के लिए एक्सटेंशन मोड देखने के लिए, किसी एक कैमरे पर टैप करें. एक्सटेंशन वे मोड जो चुने गए कैमरे पर काम नहीं करते, उन्हें स्लेटी रंग में दिखाया गया है.

एक्सटेंशन_mode_validation_result-initial

चौथी इमेज. कैमरे के लिए एक्सटेंशन मोड उपलब्ध हैं

झलक के नतीजों की पुष्टि करना

झलक के नतीजों की पुष्टि करने के लिए, चुने गए कैमरे के लिए एक्सटेंशन मोड. इमेज कैप्चर करने वाली किसी गतिविधि में शामिल हो उसके बाद पूर्वावलोकन दिखाया जाता है.

झलक-bokeh_enabled

पांचवी इमेज. बोकेह मोड की मदद से इमेज की झलक देखें

इमेज कैप्चर करने की गतिविधि से, इन फ़ंक्शन का इस्तेमाल किया जा सकता है:

  • ज़ूम इन करें/आउट करें
  • टैप-टू-फ़ोकस
  • फ़्लैश मोड बदलने का बटन
  • ईवी +/-
  • एक्सटेंशन की सुविधा चालू है/बंद करने के लिए स्विच बटन

पुष्टि करें कि ज़ूम इन/आउट, टैप-टू-फ़ोकस, फ़्लैश मोड, और EV +/- फ़ंक्शन, झलक में उम्मीद के मुताबिक काम करते हैं.

कैप्चर की गई इमेज के नतीजों की पुष्टि करें

इमेज कैप्चर करने के लिए, इमेज में मौजूद कैप्चर करें बटन (गोल बटन) पर टैप करें कैप्चर करने की गतिविधि. यह इमेज की पुष्टि करने से जुड़ी गतिविधि लॉन्च करता है, जिसमें कैप्चर की गई इमेज दिखती है.

फ़ोटो_व्यूअर-बोकेह_चालू

छठी इमेज. बोकेह मोड की मदद से कैप्चर की गई इमेज

इमेज की पुष्टि करने से जुड़ी गतिविधि में ये फ़ंक्शन शामिल हैं:

  • इमेज का साइज़ बदलने के लिए, पिंच इन/आउट करें
  • कैप्चर की गई इमेज को स्विच करने के लिए बाईं/दाईं स्लाइड करें
  • रीकैप
  • इमेज मेन्यू आइटम सेव करें

पुष्टि करें कि कैप्चर की गई इमेज सही है और ज़ूम से मेल खाती है इन/आउट, टैप-टू-फ़ोकस, फ़्लैश मोड, और EV +/- सेटिंग जो तब सेट की गई थीं कैप्चर करना.

अगर कैप्चर किए गए नतीजे सही हैं, तो कार्ड के नीचे मौजूद पास बटन (चेकमार्क) पर टैप करें स्क्रीन पर सबसे नीचे दाईं ओर. अगर ऐसा नहीं है, तो 'पुष्टि नहीं हुई है' बटन (विस्मयादिबोधक चिह्न) पर टैप करें स्क्रीन पर सबसे नीचे बाईं ओर.

परीक्षण के नतीजे देखें

एक्सटेंशन मोड की पुष्टि पास या फ़ेल के तौर पर हो जाने पर, एक्सटेंशन मोड अलग-अलग बैकग्राउंड रंग और इंंडिकेटर को दिखाता है. सूची में देखते हैं, तो आइटम निम्न रंगों में प्रदर्शित होते हैं:

  • सफ़ेद बैकग्राउंड: कैमरे पर कम से कम एक एक्सटेंशन मोड काम करता है और इस्तेमाल किए जा सकने वाले एक्सटेंशन मोड की पूरी तरह से पुष्टि नहीं की गई है.
  • हरा बैकग्राउंड: कैमरे में कम से कम एक एक्सटेंशन मोड काम करता है. सभी जांच के साथ काम करने वाले एक्सटेंशन मोड की पुष्टि तब की जाती है, जब सभी नतीजे पास हो जाते हैं.
  • लाल बैकग्राउंड: कैमरे में कम से कम एक एक्सटेंशन मोड काम करता है. सभी इस्तेमाल किए जा सकने वाले एक्सटेंशन मोड की पुष्टि, एक्सटेंशन के कम से कम एक मोड से की जाती है नतीजा नहीं मिला.
  • स्लेटी बैकग्राउंड: यह सुविधा उपलब्ध नहीं है.

Camera_validation_result एक्सटेंशन_mode_validation_result

सातवीं इमेज. कैमरे और एक्सटेंशन मोड की जांच के नतीजों को दिखाने वाले रंग

पुष्टि करने वाले टूल के अन्य फ़ंक्शन

सभी जांच पूरी होने के बाद, कैमरे की सूची की गतिविधि से आपको ये फ़ंक्शन इस्तेमाल करें:

  • टेस्ट के नतीजे एक्सपोर्ट करें: टेस्ट के नतीजों को CSV फ़ाइल के तौर पर Documents/ExtensionsValidation फ़ोल्डर.
  • रीसेट करें: इससे, कैश मेमोरी में सेव किए गए, जांच के सभी नतीजे मिट जाते हैं.
  • एक्सटेंशन सैंपल ऐप्लिकेशन: एक्सटेंशन सैंपल ऐप्लिकेशन पर स्विच करता है मोड.

जांच पूरी होने के बाद, जांच के नतीजों को एक्सपोर्ट किया जा सकता है. अगर आपको समस्या हो सकती है और वेंडर लाइब्रेरी को लागू करने के नए वर्शन का इस्तेमाल करके, समाधानों की फिर से पुष्टि करनी होगी, पिछले टेस्ट के नतीजों को रीसेट करना होगा, और फिर से चलाना होगा समस्याओं की पुष्टि करने के लिए, सभी कैमरों पर एक्सटेंशन के साथ काम करने वाले सभी मोड इस्तेमाल करने होंगे समस्याएं ठीक कर दी गई हैं.