ক্যামেরা এক্সটেনশন যাচাইকরণ টুল

ক্যামেরা এক্সটেনশন যাচাইকরণ টুল ডিভাইস প্রস্তুতকারকদের যাচাই করতে দেয় যে ক্যামেরা এক্সটেনশন OEM ভেন্ডর লাইব্রেরি সঠিকভাবে প্রয়োগ করা হয়েছে কিনা। টুলে অটোমেটিক ও ম্যানুয়াল যাচাইকরণ পরীক্ষা অন্তর্ভুক্ত থাকে।

  • অটোমেটিক যাচাইকরণ পরীক্ষা: যাচাই করে যে ভেন্ডর লাইব্রেরি ইন্টারফেস সঠিকভাবে প্রয়োগ করা হয়েছে। যেমন, ছবি তোলার জন্য CaptureProcessor is প্রয়োজনীয় হলে, পরীক্ষা করে দেখা হয় যে 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

সব টেস্ট পাস করলে, ঠিক আছে ফলাফল রিটার্ন করা হয়। অন্যথায়, সব পরীক্ষা সম্পূর্ণ হওয়ার পরে, চূড়ান্ত পরীক্ষার রিপোর্টে টার্মিনালে ব্যর্থতা দেখায়।

automated_validation_result-pass

ছবি ১. অটোমেটেড টেস্টের ফলাফল 'ঠিক আছে'

automated_validation_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

ছবি ৩. যাচাইকরণ টুলের মোড

পরীক্ষার জন্য এক্সটেনশন মোড দেখতে যেকোনও একটি ক্যামেরায় ট্যাপ করুন। বেছে নেওয়া ক্যামেরায় কাজ করে না এমন এক্সটেনশন মোড ধূসর রঙে দেখানো হয়।

extension_mode_validation_result-initial

ছবি ৪. ক্যামেরার জন্য উপলভ্য এক্সটেনশন মোড

প্রিভিউ ফলাফল যাচাই করা

প্রিভিউ ফলাফল যাচাই করতে, বেছে নেওয়া ক্যামেরার জন্য এক্সটেনশন মোডে ট্যাপ করে ম্যানুয়াল টেস্ট শুরু করুন। তারপরে, প্রিভিউ সহ ইমেজ ক্যাপচার করার অ্যাক্টিভিটি দেখানো হয়।

preview-bokeh_enabled

ছবি ৫. বোকেহ চালু থাকা অবস্থায় ছবির প্রিভিউ দেখুন

ছবি ক্যাপচার করার অ্যাক্টিভিটি নিম্নলিখিত ফাংশন সমর্থন করে:

  • বড়/ছোট করুন
  • ট্যাপ-টু-ফোকাস
  • ফ্ল্যাশ মোড পাল্টানোর বোতাম
  • EV +/-
  • এক্সটেনশন চালু/বন্ধ করার সুইচ বোতাম

প্রিভিউতে জুম ইন/আউট, ট্যাপ-টু-ফোকাস, ফ্ল্যাশ মোড এবং EV +/- ফাংশন প্রত্যাশিতভাবে কাজ করছে কিনা তা যাচাই করুন।

ক্যাপচার করা ছবির ফলাফল যাচাই করা

ছবি ক্যাপচার করতে, ছবি ক্যাপচার করার অ্যাক্টিভিটিতে ক্যাপচার করুন বোতামে (গোল বোতাম) ট্যাপ করুন। এটি একটি ছবি যাচাইকরণ অ্যাক্টিভিটি চালু করে যা ক্যাপচার করা ছবি দেখায়।

photo_viewer-bokeh_enabled

ছবি ৬. বোকেহ চালু করে ক্যাপচার করা ছবি

ছবি যাচাইকরণ অ্যাক্টিভিটিতে নিম্নলিখিত ফাংশন অন্তর্ভুক্ত থাকে:

  • ছবি স্কেল করতে পিঞ্চ ইন/আউট করুন
  • ক্যাপচার করা ছবি পরিবর্তন করতে বাঁদিকে/ডানদিকে স্লাইড করুন
  • আবার ক্যাপচার করা
  • ছবি সেভ করার মেনু আইটেম

ক্যাপচার করা ছবি সঠিক কিনা এবং ছবি ক্যাপচার করার সময় সেট করা জুম ইন/আউট, ট্যাপ-টু-ফোকাস, ফ্ল্যাশ মোড ও EV +/- সেটিংসের সাথে মিলছে কিনা তা যাচাই করুন।

ক্যাপচার করা ফলাফল সঠিক হলে, স্ক্রিনের নিচে ডানদিকের কোণে পাস বোতামে (টিকচিহ্ন) ট্যাপ করুন। অন্যথায়, নিচে বাঁদিকের কোণে ব্যর্থ বোতামে (বিস্ময়সূচক চিহ্ন) ট্যাপ করুন।

পরীক্ষার ফলাফল দেখুন

এক্সটেনশন মোড পাস বা ফেল হিসেবে যাচাই করার পরে, এক্সটেনশন মোডের তালিকা আইটেমটি একটি আলাদা ব্যাকগ্রাউন্ড কালার ও ইন্ডিকেটর দেখায়। সব ক্যামেরার তালিকা ভিউতে, আইটেমগুলি নিম্নলিখিত রঙে দেখানো হয়:

  • সাদা ব্যাকগ্রাউন্ড: ক্যামেরায় কমপক্ষে একটি এক্সটেনশন মোড কাজ করে এবং যেসব এক্সটেনশন মোড কাজ করে সেগুলি সম্পূর্ণভাবে যাচাই করা হয়নি।
  • সবুজ ব্যাকগ্রাউন্ড: ক্যামেরা কমপক্ষে একটি এক্সটেনশন মোডে কাজ করে। সব সাপোর্ট করা এক্সটেনশন মোড সব ফলাফল পাস করার মাধ্যমে যাচাই করা হয়।
  • লাল ব্যাকগ্রাউন্ড: ক্যামেরা অন্তত একটি এক্সটেনশন মোডে কাজ করে। সব কাজ করে এমন এক্সটেনশন মোড অন্তত একটি এক্সটেনশন মোড ফলাফলের সাথে যাচাই করা হয় যা কাজ করে না।
  • ধূসর ব্যাকগ্রাউন্ড: এই ফিচার উপলভ্য নয়।

camera_validation_result extension_mode_validation_result

ছবি ৭. ক্যামেরা ও এক্সটেনশন মোডের জন্য পরীক্ষার ফলাফল নির্দেশ করে এমন রঙ

যাচাইকরণ টুলের অন্যান্য ফাংশন

সব টেস্ট সম্পূর্ণ হওয়ার পরে, ক্যামেরা তালিকা অ্যাক্টিভিটি নিম্নলিখিত ফাংশন প্রদান করে:

  • পরীক্ষার ফলাফল এক্সপোর্ট করুন: পরীক্ষার ফলাফল CSV ফাইল হিসেবে Documents/ExtensionsValidation ফোল্ডারে এক্সপোর্ট করে।
  • রিসেট করুন: ক্যাশে থাকা সব টেস্টের ফলাফল মুছে দেয়।
  • এক্সটেনশন স্যাম্পেল অ্যাপ: এক্সটেনশন স্যাম্পেল অ্যাপ মোডে পাল্টে যায়।

পরীক্ষা সম্পূর্ণ করার পরে, আপনি পরীক্ষার ফলাফল এক্সপোর্ট করতে পারবেন। আপনি যদি কোনও সমস্যা খুঁজে পান এবং সেটির সমাধান সহ ভেন্ডর লাইব্রেরি ইমপ্লিমেন্টেশনের একটি নতুন ভার্সন আবার যাচাই করতে হয়, তাহলে আগের পরীক্ষার ফলাফল রিসেট করুন এবং সমস্যাগুলি সমাধান করা হয়েছে কিনা তা যাচাই করতে সব ক্যামেরায় কাজ করে এমন সব এক্সটেনশন মোড আবার চালান।