ইনস্ট্রুমেন্টেড টেস্ট স্যুট

ইনস্ট্রুমেন্টেড টেস্ট স্যুট আপনার মডিউলের ডিফল্ট src/androidTest/ ডিরেক্টরির বাইরে আইসোলেটেড testApk APK-তে ডিভাইস টেস্ট প্যাকেজ করে। ডেডিকেটেড ডিপেন্ডেন্সি, ভেরিয়েন্ট ও ডিভাইস টার্গেটের মাধ্যমে UI, ইন্টিগ্রেশন বা এন্ড-টু-এন্ড চেক আলাদা করতে, 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 ডিবাগ ব্রিজ (adb) বা বিল্ড-ম্যানেজড ডিভাইস ডেফিনিশনের মাধ্যমে কানেক্ট করা ডিভাইস বা এমুলেটর

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

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

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

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

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

android.experimental.testSuiteSupport=true

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

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

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

android {
    testOptions {
        // Optional: define build-managed virtual devices and device groups.
        managedDevices {
            localDevices {
                create("api34Atd") {
                    // Use a device profile from Android Studio.
                    device = "Pixel 6"
                    apiLevel = 34
                    systemImageSource = "aosp-atd"
                }
            }
            groups {
                create("ciPhones") {
                    targetDevices.add(allDevices.getByName("api34Atd"))
                }
            }
        }

        customSuites {
            create("androidSuite") {
                targetVariants += listOf("debug")

                testApk {
                    dependencies {
                        implementation("junit:junit:4.13.2")
                        implementation("androidx.test.ext:junit:1.2.1")
                        implementation("androidx.test:runner:1.6.2")
                    }
                }

                useJunitEngine {
                    includeEngines += listOf("android-test-engine")
                    // Match the engine and listener versions to your AGP
                    // version.
                    enginesDependencies.add(
                        "com.android.tools.androidtest:" +
                            "android-test-engine:9.6.0-alpha03"
                    )
                    enginesDependencies.add(
                        "com.android.tools.androidtest:" +
                            "android-test-engine-result-listener:9.6.0-alpha03"
                    )
                    enginesDependencies.add(
                        "org.junit.platform:junit-platform-launcher:1.10.2"
                    )

                    inputs += listOf(
                        // Omit TESTED_APKS in com.android.library modules.
                        AgpTestSuiteInputParameters.TESTED_APKS,
                        AgpTestSuiteInputParameters.TEST_APKS,
                        AgpTestSuiteInputParameters.ADB_EXECUTABLE,
                        AgpTestSuiteInputParameters.AAPT2_EXECUTABLE,
                    )
                }

                targets {
                    // Runs on connected adb devices.
                    create("default")
                    // Optional: runs on build-managed devices or groups in
                    // targetDevices.
                    create("managed") {
                        targetDevices += listOf("ciPhones")
                    }
                }
            }
        }
    }
}

AGP AndroidJUnitRunner টেস্ট রানার ও প্যাকেজ আইডি অটোমেটিক কনফিগার করে, androidTestImplementation কনফিগারেশন থেকে ডিপেন্ডেন্সি ইনহেরিট না করেই। কাস্টম রানার ব্যবহার করতে, আপনার src/{suiteName}/AndroidManifest.xml ফাইলের instrumentation এলিমেন্টে android:name অ্যাট্রিবিউট সেট করুন।

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

আপনার ইনস্ট্রুমেন্টেড টেস্ট {module}/src/{suiteName}/kotlin/ বা java/ ডিরেক্টরিতে রাখুন, সাথে যেকোনও ঐচ্ছিক res/ বা assets/ ডিরেক্টরি বা একটি AndroidManifest.xml ফাইল রাখুন। যেমন, app/src/androidSuite/kotlin/com/example/myapp/AppContextSuiteTest.kt ফাইল তৈরি করুন:

package com.example.myapp

import androidx.test.ext.junit.runners.AndroidJUnit4
import androidx.test.platform.app.InstrumentationRegistry
import org.junit.Assert.assertEquals
import org.junit.Test
import org.junit.runner.RunWith

@RunWith(AndroidJUnit4::class)
class AppContextSuiteTest {
    @Test
    fun useAppContext() {
        val appContext =
            InstrumentationRegistry.getInstrumentation().targetContext
        assertEquals("com.example.myapp", appContext.packageName)
    }
}

ইউনিট ও ইনস্ট্রুমেন্টেড টেস্ট একত্রিত করা

একটি Gradle টাস্কে লোকাল JVM টেস্ট ও ইনস্ট্রুমেন্টেড ডিভাইস টেস্ট রান করতে, একটি সুইটে hostJar ও testApk ব্লক দুটিই ঘোষণা করুন। হোস্ট টেস্ট src/{suiteName}/test/ ডিরেক্টরিতে এবং ডিভাইস টেস্ট src/{suiteName}/androidTest/ ডিরেক্টরিতে রাখুন:

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

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

                hostJar {
                    dependencies {
                        implementation(
                            "org.junit.jupiter:junit-jupiter-api:5.10.2"
                        )
                    }
                }

                testApk {
                    dependencies {
                        implementation("junit:junit:4.13.2")
                        implementation("androidx.test.ext:junit:1.2.1")
                        implementation("androidx.test:runner:1.6.2")
                    }
                }

                useJunitEngine {
                    includeEngines += listOf(
                        "junit-jupiter",
                        "android-test-engine",
                    )
                    enginesDependencies.add(
                        "org.junit.jupiter:junit-jupiter-engine:5.10.2"
                    )
                    enginesDependencies.add(
                        "com.android.tools.androidtest:" +
                            "android-test-engine:9.6.0-alpha03"
                    )
                    enginesDependencies.add(
                        "com.android.tools.androidtest:" +
                            "android-test-engine-result-listener:9.6.0-alpha03"
                    )
                    enginesDependencies.add(
                        "org.junit.platform:junit-platform-launcher:1.10.2"
                    )

                    inputs += listOf(
                        // Omit TESTED_APKS in com.android.library modules.
                        AgpTestSuiteInputParameters.TESTED_APKS,
                        AgpTestSuiteInputParameters.TEST_APKS,
                        AgpTestSuiteInputParameters.ADB_EXECUTABLE,
                        AgpTestSuiteInputParameters.AAPT2_EXECUTABLE,
                    )
                }

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

টেস্ট রান করা ও কভারেজ সংগ্রহ করা

ইন্সট্রুমেন্টেড স্যুট রান, টেস্ট কেস ফিল্টার ও কভারেজ রিপোর্ট তৈরি করতে Gradle ব্যবহার করুন।

কানেক্ট করা বা বিল্ড-ম্যানেজড ডিভাইসে রান করুন

প্রতিটি অনলাইন adb ডিভাইসে কানেক্ট করা টার্গেট রান করুন অথবা targetDevices প্রপার্টি দিয়ে কনফিগার করা টার্গেট রান করুন:

# Run on connected adb devices.
./gradlew :app:testDebugAndroidSuiteDefaultTestSuite
# Run on the ciPhones build-managed device group.
./gradlew :app:testDebugAndroidSuiteManagedCiPhonesTestSuite

ইন্সট্রুমেন্টেড টেস্ট ফিল্টার করুন

Gradle-এর --tests বিকল্প বা AndroidJUnitRunner আর্গুমেন্ট ব্যবহার করে টেস্ট ফিল্টার করুন:

./gradlew :app:testDebugAndroidSuiteDefaultTestSuite \
    --tests "com.example.myapp.AppContextSuiteTest.useAppContext"

এছাড়াও, আপনি প্রোজেক্ট প্রপার্টি সহ কমান্ড লাইনে AndroidJUnitRunner আর্গুমেন্ট পাস করতে পারেন, যেমন -Pandroid.testInstrumentationRunnerArguments.size=small। useJunitEngine ব্লকে ডিফল্ট রানার আর্গুমেন্ট সেট করতে, addInputProperty মেথড কল করুন, যেমন addInputProperty("android-test.instrumentation-args", "size=small")।

অন-ডিভাইস কোড কভারেজ সংগ্রহ করুন

অন-ডিভাইস কোড কভারেজের জন্য ডিবাগ করা যায় এমন বিল্ড এবং Android 9 (API লেভেল ২৮) বা তার পরবর্তী যেকোনও ভার্সনে চলে এমন ডিভাইস প্রয়োজন। ইন্সট্রুমেন্টেড বা মিক্সড সুইটের জন্য কভারেজ সংগ্রহ করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. আপনার gradle.properties ফাইলে android.experimental.androidTest.coverage.useOnDeviceAgent=true প্রপার্টি সেট করুন।
  2. সুইটে codeCoverage প্রপার্টি true-এ সেট করুন।
  3. একাধিক ডিভাইস কানেক্ট করা থাকলে, ANDROID_SERIAL এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করে একটি ডিভাইস টার্গেট করুন।

এজেন্ট সংক্রান্ত প্রয়োজনীয়তা সম্পর্কে আরও জানতে, কোড কভারেজ রিপোর্ট দেখুন (অন-ডিভাইস এজেন্টের সাথে)।

রিপোর্ট পরীক্ষা করুন

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

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