Android Gradle প্লাগ-ইনে টেস্ট স্যুট

Android Gradle প্লাগ-ইন (AGP) আপনাকে আপনার মডিউলের testOptions ব্লকে নামযুক্ত টেস্ট স্যুটে টেস্টগুলি সাজাতে দেয়। প্রতিটি স্যুট তার নিজস্ব সোর্স সেট, ডিপেন্ডেন্সি, JUnit প্ল্যাটফর্ম টেস্ট ইঞ্জিন এবং টার্গেট বিল্ড ভেরিয়েন্ট নির্ধারণ করে।

টেস্ট স্যুট কেন ব্যবহার করবেন

সাধারণত, একটি Android মডিউল লোকাল ইউনিট টেস্টের জন্য একটি test সোর্স সেট এবং ইনস্ট্রুমেন্টেড টেস্টের জন্য একটি androidTest সোর্স সেট প্রদান করে। টেস্ট স্যুট এই দুটি সোর্স সেট থেকে টেস্ট অর্গানাইজেশন ডিকাপল করুন যাতে আপনি নিম্নলিখিত কাজগুলি করতে পারেন:

  • উদ্দেশ্য অনুযায়ী আলাদা আলাদা পরীক্ষা: ইউনিট, Robolectric, UI, স্ক্রিনশট এবং ব্যাক-আপ পরীক্ষা src/test/ বা src/androidTest/ ডিরেক্টরিতে একসাথে না রেখে নির্দিষ্ট src/{suiteName}/ ডিরেক্টরিতে রাখুন।
  • ডিপেন্ডেন্সি ও ইঞ্জিন আইসোলেট করা: আপনার অ্যাপ বা testImplementation ও androidTestImplementation কনফিগারেশনে ডিপেন্ডেন্সি যোগ না করেই প্রতিটি স্যুটের ক্লাসপাথ ও JUnit প্ল্যাটফর্ম টেস্ট ইঞ্জিন কনফিগার করুন।
  • নির্দিষ্ট ভেরিয়েন্ট ও ডিভাইস টার্গেট করুন: প্রতিটি স্যুটের জন্য বিল্ড ভেরিয়েন্ট ও ডিভাইস বেছে নিন যাতে দ্রুত চেক স্থানীয়ভাবে রান করে এবং দীর্ঘ স্যুটগুলি ক্রমাগত ইন্টিগ্রেশনে রান করে।

স্যুটের ধরন

AGP-তে বিশেষ ওয়ার্কফ্লোর জন্য বিল্ট-ইন টেস্ট স্যুট এবং কাস্টম স্যুটের জন্য AgpTestSuite ইন্টারফেস অন্তর্ভুক্ত থাকে। নিম্নলিখিত টেবিলে উপলভ্য সুইটের ধরন তালিকাভুক্ত করা হয়েছে:

স্যুটের ধরন DSL কন্টেনার উদ্দেশ্য
ইউনিট টেস্ট স্যুট testOptions.customSuites hostJar ব্লকের সাহায্যে লোকাল JVM-এ JUnit 5, JUnit 4 বা Robolectric টেস্ট রান করুন।
ইনস্ট্রুমেন্টেড টেস্ট স্যুট testOptions.customSuites testApk ব্লক এবং android-test-engine টেস্ট ইঞ্জিনের সাহায্যে কানেক্ট করা বা বিল্ড-ম্যানেজ করা ডিভাইসে ডিভাইস টেস্ট রান করুন।
টেস্ট স্যুটের মাধ্যমে স্ক্রিনশট পরীক্ষা করা testOptions.screenshotTests হোস্টে @PreviewTest Compose প্রিভিউ রেন্ডার ও তুলনা করুন।
অটোমেটেড ব্যাক-আপ ও রিস্টোর টেস্টিং testOptions.backupTests লোকাল, ক্লাউড এবং ডিভাইস-টু-ডিভাইস ট্রান্সফার জুড়ে অ্যাপ ডেটা যাচাই করুন।
Android Studio-র জন্য Journeys testOptions.customSuites কানেক্ট করা ডিভাইসে AI-চালিত XML ব্যবহারকারীর অভিজ্ঞতা রান করুন।
কাস্টম অ্যাসেট বা মিক্সড স্যুট testOptions.customSuites কাস্টম ইঞ্জিনের সাহায্যে স্ট্যাটিক টেস্ট ডেফিনেশন রান করুন অথবা hostJar, testApk এবং assets ব্লকগুলিকে একটি স্যুটে একত্রিত করুন।

প্রয়োজনীয়তা

কাস্টম টেস্ট স্যুট ব্যবহার করতে, আপনার প্রোজেক্ট নিম্নলিখিত প্রয়োজনীয়তা পূরণ করছে কিনা তা নিশ্চিত করুন:

  • Android Studio Rabbit 3 Canary 3 বা তার পরবর্তী যেকোনও ভার্সন
  • AGP 9.6.0-alpha03 বা তার পরবর্তী যেকোনও ভার্সন
  • Gradle 9.7.1 বা তার পরের যেকোনও ভার্সন এবং JDK 17 বা তার পরের যেকোনও ভার্সন
  • com.android.application বা com.android.library মডিউল

com.android.kotlin.multiplatform.library বা com.android.test মডিউলে টেস্ট স্যুট কাজ করে না। প্রিভিউ ভার্সন ম্যাচিং সম্পর্কে আরও তথ্যের জন্য, Android Gradle প্লাগ-ইন প্রিভিউয়ের সাথে কম্প্যাটিবিলিটি দেখুন।

কাস্টম টেস্ট স্যুট সেট-আপ করুন

ধাপে ধাপে সেট-আপ করার নির্দেশিকা পেতে, ইউনিট টেস্ট স্যুট এবং ইনস্ট্রুমেন্টেড টেস্ট স্যুট দেখুন। আপনার নিজস্ব কাস্টম স্যুট সংজ্ঞায়িত করতে, প্রথমে আপনার প্রোজেক্টের gradle.properties ফাইলে টেস্ট স্যুট চালু করুন:

android.experimental.testSuiteSupport=true

এরপর, আপনার মডিউলের build.gradle.kts ফাইলের testOptions.customSuites ব্লকে একটি স্যুট ঘোষণা করুন। targetVariants প্রপার্টি, এক বা একাধিক সোর্স ব্লক, useJunitEngine ব্লক এবং targets ব্লকে অন্তত একটি টার্গেট নির্দিষ্ট করুন:

import com.android.build.api.dsl.AgpTestSuiteInputParameters

android {
    testOptions {
        customSuites {
            create("mySuite") {
                // Exact variant names to test, such as "debug" or "demoDebug".
                targetVariants += listOf("debug")

                // Add one or more blocks: hostJar {}, testApk {}, or assets {}.
                assets {}

                useJunitEngine {
                    includeEngines += listOf("my-custom-engine")
                    enginesDependencies.add(
                        "com.example:my-custom-junit-engine:1.0.0"
                    )
                    enginesDependencies.add(
                        "org.junit.platform:junit-platform-launcher:1.10.2"
                    )

                    // Request build and SDK artifacts read by your engine.
                    inputs += listOf(
                        AgpTestSuiteInputParameters.STATIC_FILES,
                        // Omit TESTED_APKS in com.android.library modules.
                        AgpTestSuiteInputParameters.TESTED_APKS,
                        AgpTestSuiteInputParameters.ADB_EXECUTABLE,
                    )
                }

                targets {
                    create("default")
                }
            }
        }
    }
}

কাস্টম TestEngine ইমপ্লিমেন্টেশনের মধ্যে, TestSuiteExecutionClient.default প্রপার্টি ব্যবহার করে AgpTestSuiteInputParameters enum ভ্যালু এবং স্ট্যান্ডার্ড TestEngineInputProperty কনস্ট্যান্ট যেমন SERIAL_IDS এবং RESULTS_DIR পড়ুন।

সোর্স সেট ডিরেক্টরি

প্রতিটি সুইটের ডিরেক্টরি লেআউট নির্ভর করে এটি একটি সোর্স ব্লক ঘোষণা করে নাকি একাধিক সোর্স ব্লক একত্রিত করে তার উপর। নিচের সারণীতে {module}/src/{suiteName}/ ডিরেক্টরির অধীনে ডিফল্ট পাথ তালিকাভুক্ত করা হয়েছে:

সোর্স ব্লক সিঙ্গেল-সোর্স স্যুট মিক্সড স্যুট
hostJar kotlin/, java/, resources/ test/kotlin/, test/java/, test/resources/
testApk kotlin/, java/, res/, assets/, AndroidManifest.xml androidTest/kotlin/, androidTest/java/, androidTest/res/, androidTest/assets/, androidTest/AndroidManifest.xml
assets স্যুট রুট ডিরেক্টরি assetsTest/

সুইটের নাম হিসেবে বিল্ট-ইন সোর্স সেট, ফ্লেভার, বিল্ডের ধরন বা ভ্যারিয়েন্টের নাম যেমন main, androidTest বা debug আবার ব্যবহার করবেন না।

প্রতিটি ভ্যারিয়েন্টের জন্য টার্গেট নিয়ন্ত্রণ করুন

নির্দিষ্ট ভেরিয়েন্টের জন্য স্যুট টার্গেট চালু বা বন্ধ করতে, beforeVariants ব্লকে HasTestSuitesBuilder.suites প্রপার্টির মাধ্যমে TestSuiteTargetBuilder ইন্টারফেস কনফিগার করুন:

androidComponents {
    beforeVariants { variantBuilder ->
        if (variantBuilder.buildType == "release") {
            variantBuilder.suites["mySuite"]
                ?.targets
                ?.get("default")
                ?.enable = false
        }
    }
}

সুইট রান করুন এবং রিপোর্ট দেখুন

AGP, ভেরিয়েন্ট, স্যুট ও টার্গেটের প্রতিটি কম্বিনেশনের জন্য একটি Gradle টাস্ক তৈরি করে। নিচের সারণীতে টাস্ক প্যাটার্নের তালিকা দেওয়া হল:

টাস্কের ধরন নামকরণের প্যাটার্ন কমান্ডের উদাহরণ
স্ট্যান্ডার্ড স্যুট টার্গেট test{Variant}{SuiteName}{Target}TestSuite ./gradlew :app:testDebugMySuiteDefaultTestSuite
targetDevices প্রপার্টি সহ টার্গেট করুন test{Variant}{SuiteName}{Target}{Devices}TestSuite ./gradlew :app:testDebugAndroidSuiteManagedCiPhonesTestSuite
বেসলাইন আপডেট (requiresUpdateTask = true) update{Variant}{SuiteName}{Target}TestSuite ./gradlew :app:updateDebugScreenshotTestDefaultTestSuite
মডিউল রিপোর্ট অ্যাগ্রিগেশন testAllSuites ./gradlew :app:testAllSuites
মডিউল ও ডিপেন্ডেন্সি এগ্রিগেশন testAllSuitesWithDependencies ./gradlew :app:testAllSuitesWithDependencies

test, connectedCheck এবং check টাস্ক কাস্টম স্যুট রান করে না, যদি না আপনি সেগুলিকে withTestTaskProviders পদ্ধতির সাথে যুক্ত করেন। testAllSuites এবং testAllSuitesWithDependencies টাস্ক চালু করতে, আপনার gradle.properties ফাইলে android.experimental.reportAggregationSupport=true প্রপার্টি সেট করুন।

প্রতিটি স্যুট রান নিম্নলিখিত লোকেশনে আউটপুট লেখে:

  • HTML টেস্ট রিপোর্ট: {module}/build/reports/tests/{taskName}/index.html
  • JUnit XML ফলাফল: {module}/build/test-results/{taskName}/
  • কোড কভারেজ রিপোর্ট: {module}/build/reports/coverage/{suiteName}/index.html
  • একত্রিত রিপোর্ট: {module}/build/reports/{aggregationTask}/test-report/index.html এবং coverage-report/index.html

কোড কভারেজ রিপোর্ট তৈরি করতে, সুইটে codeCoverage প্রপার্টি true-এ সেট করুন। Compose স্ক্রিনশট স্যুটের জন্য, testOptions.customSuites.named("{suiteName}") { codeCoverage = true } সহ আপনার build.gradle.kts ফাইলে স্যুট কনফিগার করুন।

পরিচিত সমস্যা ও সীমাবদ্ধতা

টেস্ট স্যুটের নিম্নলিখিত সীমাবদ্ধতা আছে:

  • IDE ইন্টিগ্রেশন: কাস্টম টেস্ট স্যুটের জন্য Android Studio সাপোর্ট উপলভ্য নেই। আপনার বিল্ড সঠিকভাবে কনফিগার করা থাকলেও, কোড এডিটর স্যুট সোর্স ফাইলে সমাধান না হওয়া রেফারেন্স সংক্রান্ত সমস্যা দেখাতে পারে। পরিবর্তে, Gradle ব্যবহার করে কমান্ড লাইন থেকে টেস্ট স্যুট তৈরি করুন ও চালান।
  • টাস্ক ক্যাশিং: টেস্ট স্যুট টাস্ক কল করা হলে সবসময় আবার রান করে এবং Gradle বিল্ড ক্যাশে থেকে লোড হয় না। টেস্ট ফাইল নেই এমন স্যুট NO-SOURCE স্ট্যাটাস সহ এড়িয়ে যাওয়া হয়।