ইনস্ট্রুমেন্টেড টেস্ট স্যুট আপনার মডিউলের ডিফল্ট 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 লেভেল ২৮) বা তার পরবর্তী যেকোনও ভার্সনে চলে এমন ডিভাইস প্রয়োজন। ইন্সট্রুমেন্টেড বা মিক্সড সুইটের জন্য কভারেজ সংগ্রহ করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
- আপনার
gradle.propertiesফাইলেandroid.experimental.androidTest.coverage.useOnDeviceAgent=trueপ্রপার্টি সেট করুন। - সুইটে
codeCoverageপ্রপার্টিtrue-এ সেট করুন। - একাধিক ডিভাইস কানেক্ট করা থাকলে,
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