ইউনিট টেস্ট স্যুট

ইউনিট টেস্ট স্যুট আপনার মডিউলের ডিফল্ট src/test/ ডিরেক্টরির বাইরে আইসোলেটেড hostJar সোর্স সেটে লোকাল JVM টেস্ট রান করে। প্রতিটি ভেরিয়েন্টের জন্য JUnit 5, JUnit 4 বা Robolectric টেস্ট আলাদা করতে, Android Gradle প্লাগ-ইন (AGP) টেস্ট স্যুট DSL-এর মাধ্যমে সেগুলি কনফিগার করুন।

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

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

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

প্রিভিউ ভার্সন ম্যাচিং সম্পর্কে আরও জানতে, Android Gradle প্লাগ-ইন প্রিভিউয়ের সাথে মানানসই দেখুন।

ইউনিট টেস্ট স্যুট সেট-আপ করা

অ্যাপ বা লাইব্রেরি মডিউলে ইউনিট টেস্ট স্যুট যোগ করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

টেস্ট স্যুট চালু করুন

আপনার প্রোজেক্টের gradle.properties ফাইলে, টেস্ট স্যুট সাপোর্ট চালু করুন:

android.experimental.testSuiteSupport=true

স্যুট কনফিগার করুন

আপনার মডিউলের build.gradle.kts ফাইলে, testOptions.customSuites ব্লকের মধ্যে hostJar এবং useJunitEngine ব্লক সহ একটি স্যুট তৈরি করুন:

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

                hostJar {
                    dependencies {
                        // JUnit 5 API for @org.junit.jupiter.api.Test.
                        implementation(
                            "org.junit.jupiter:junit-jupiter-api:5.10.2"
                        )
                        // Optional: JUnit 4 API for @org.junit.Test.
                        implementation("junit:junit:4.13.2")
                    }
                }

                useJunitEngine {
                    // Add "junit-jupiter" (JUnit 5), "junit-vintage" (JUnit 4),
                    // or both.
                    includeEngines += listOf("junit-jupiter", "junit-vintage")
                    enginesDependencies.add(
                        "org.junit.jupiter:junit-jupiter-engine:5.10.2"
                    )
                    enginesDependencies.add(
                        "org.junit.vintage:junit-vintage-engine:5.10.2"
                    )
                    enginesDependencies.add(
                        "org.junit.platform:junit-platform-launcher:1.10.2"
                    )
                }

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

আপনার স্যুট, testImplementation কনফিগারেশন থেকে ডিপেন্ডেন্সি ইনহেরিট না করেই টার্গেট ভেরিয়েন্টের ক্লাস ও ডিপেন্ডেন্সি অটোমেটিক অ্যাক্সেস করে

পরীক্ষা তৈরি করুন

আপনার ইউনিট টেস্ট {module}/src/{suiteName}/kotlin/ বা java/ ডিরেক্টরিতে এবং Java টেস্ট রিসোর্স {module}/src/{suiteName}/resources/ ডিরেক্টরিতে রাখুন। যেমন, app/src/unitSuite/kotlin/com/example/myapp/CalculatorSuiteTest.kt ফাইল তৈরি করুন:

package com.example.myapp

import org.junit.jupiter.api.Assertions.assertEquals
import org.junit.jupiter.api.Test

class CalculatorSuiteTest {
    @Test
    fun addition_isCorrect() {
        assertEquals(4, 2 + 2)
    }
}

Android রিসোর্স এবং Robolectric অন্তর্ভুক্ত করুন

মার্জ করা Android রিসোর্স, অ্যাসেট, ম্যানিফেস্ট এবং R ক্লাস অ্যাক্সেস করতে, যেমন Robolectric টেস্টের জন্য, TestSuiteHostJarSpec ইন্টারফেসের enableAndroidResources প্রপার্টি true-এ সেট করুন:

android {
    testOptions {
        customSuites {
            create("roboSuite") {
                targetVariants += listOf("debug")

                hostJar {
                    enableAndroidResources = true
                    dependencies {
                        implementation("junit:junit:4.13.2")
                        implementation("org.robolectric:robolectric:4.14.1")
                        implementation("androidx.test:core-ktx:1.6.1")
                    }
                }

                useJunitEngine {
                    includeEngines += listOf("junit-vintage")
                    enginesDependencies.add(
                        "org.junit.vintage:junit-vintage-engine:5.10.2"
                    )
                    enginesDependencies.add(
                        "org.junit.platform:junit-platform-launcher:1.10.2"
                    )
                }

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

টাস্ক ও কভারেজ কাস্টমাইজ করুন

codeCoverage প্রপার্টি সহ কোনও স্যুটে JaCoCo কভারেজ চালু করুন। প্রতিটি টার্গেটের জন্য Gradle Test বিকল্প কাস্টমাইজ করতে, AgpTestSuiteTarget.configureTestTasks পদ্ধতিতে একটি কনফিগারেশন ল্যাম্বডা পাস করুন, যা একটি TestTaskContext ইনস্ট্যান্স প্রদান করে। check টাস্কে যাচাইকরণ টাস্ক অ্যাটাচ করতে, withTestTaskProviders পদ্ধতি ব্যবহার করুন:

android {
    testOptions {
        customSuites {
            named("unitSuite") {
                // Generates JaCoCo HTML and XML coverage reports.
                codeCoverage = true

                targets.named("default") {
                    configureTestTasks { context ->
                        systemProperty("suite.variant", context.targetedVariant)
                        maxParallelForks = 2
                    }
                }

                withTestTaskProviders { context ->
                    if (!context.isUpdateTask) {
                        tasks.named("check") {
                            dependsOn(this@withTestTaskProviders)
                        }
                    }
                }
            }
        }
    }
}

সুইটের প্রতিটি টার্গেটে Test টাস্ক সেটিংস প্রয়োগ করতে, পরিবর্তে সুইটে AgpTestSuite.configureTestTasks পদ্ধতি কল করুন।

টেস্ট রান করা ও রিপোর্ট পরীক্ষা করা

জেনারেট করা test{Variant}{SuiteName}{Target}TestSuite টাস্কের মাধ্যমে কমান্ড লাইন থেকে আপনার স্যুট রান করুন:

./gradlew :app:testDebugUnitSuiteDefaultTestSuite

একটি টেস্ট ক্লাস বা পদ্ধতি রান করতে, Gradle-এর --tests বিকল্প পাস করুন:

./gradlew :app:testDebugUnitSuiteDefaultTestSuite \
    --tests "com.example.myapp.CalculatorSuiteTest.addition_isCorrect"

টেস্ট রান সম্পূর্ণ হওয়ার পরে, AGP নিম্নলিখিত পাথে রিপোর্ট জেনারেট করে:

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