আপনি সুপ্রতিষ্ঠিত পদ্ধতি এবং প্যাটার্ন সহ আপনার Compose অ্যাপ পরীক্ষা করতে পারেন।
আইসোলেশনে টেস্ট করুন
ComposeTestRule আপনাকে যেকোনও কম্পোজেবল দেখানোর অ্যাক্টিভিটি শুরু করতে দেয়:
আপনার সম্পূর্ণ অ্যাপ্লিকেশন, একটি স্ক্রিন বা ছোট এলিমেন্ট। এছাড়াও, আপনার কম্পোজেবল সঠিকভাবে এনক্যাপসুলেট করা হয়েছে এবং সেগুলি স্বাধীনভাবে কাজ করে কিনা তা পরীক্ষা করা একটি ভাল অভ্যাস, যা আরও সহজ এবং আরও ফোকাসড UI পরীক্ষার অনুমতি দেয়।
এর অর্থ এই নয় যে আপনাকে শুধুমাত্র ইউনিট UI টেস্ট তৈরি করতে হবে। UI টেস্টের মাধ্যমে আপনার UI-এর আরও বড় অংশ স্কোপ করাও খুব গুরুত্বপূর্ণ।
আপনার নিজস্ব কন্টেন্ট সেট করার পরে অ্যাক্টিভিটি ও রিসোর্স অ্যাক্সেস করুন
প্রায়শই আপনাকে composeTestRule.setContent ব্যবহার করে টেস্টের অধীনে কন্টেন্ট সেট করতে হয়
এবং আপনাকে অ্যাক্টিভিটি রিসোর্সও অ্যাক্সেস করতে হয়,
যেমন, কোনও দেখানো টেক্সট স্ট্রিং রিসোর্সের সাথে মিলছে কিনা তা নিশ্চিত করা। তবে, অ্যাক্টিভিটি যদি আগে থেকেই
-কে কল করে, তাহলে আপনি setContent-এর মাধ্যমে তৈরি করা কোনও নিয়মে createAndroidComposeRule()-কে কল করতে পারবেন না।
এটি করার একটি সাধারণ উপায় হল ComponentActivity-এর মতো খালি অ্যাক্টিভিটি ব্যবহার করে
AndroidComposeTestRule তৈরি করা।
class MyComposeTest {
@get:Rule
val composeTestRule = createAndroidComposeRule<ComponentActivity>()
@Test
fun myTest() {
// Start the app
composeTestRule.setContent {
MyAppTheme {
MainScreen(uiState = exampleUiState, /*...*/)
}
}
val continueLabel = composeTestRule.activity.getString(R.string.next)
composeTestRule.onNodeWithText(continueLabel).performClick()
}
}
মনে রাখবেন যে আপনার অ্যাপের
AndroidManifest.xml ফাইলে ComponentActivity যোগ করতে হবে। আপনার মডিউলে এই ডিপেন্ডেন্সি যোগ করে সেটি চালু করুন:
debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")
কাস্টম সিম্যান্টিক্স প্রপার্টি
পরীক্ষার জন্য তথ্য প্রকাশ করতে আপনি কাস্টম সিম্যান্টিক্স প্রপার্টি তৈরি করতে পারেন।
এটি করতে, নতুন SemanticsPropertyKey নির্ধারণ করুন এবং SemanticsPropertyReceiver ব্যবহার করে
এটি উপলভ্য করুন।
// Creates a semantics property of type Long.
val PickedDateKey = SemanticsPropertyKey<Long>("PickedDate")
var SemanticsPropertyReceiver.pickedDate by PickedDateKey
এখন semantics মডিফায়ারে সেই প্রপার্টি ব্যবহার করুন:
val datePickerValue by remember { mutableStateOf(0L) }
MyCustomDatePicker(
modifier = Modifier.semantics { pickedDate = datePickerValue }
)
টেস্ট থেকে, প্রপার্টির ভ্যালু অ্যাসার্ট করতে SemanticsMatcher.expectValue ব্যবহার করুন:
composeTestRule
.onNode(SemanticsMatcher.expectValue(PickedDateKey, 1445378400)) // 2015-10-21
.assertExists()
স্টেট রিস্টোরেশন যাচাই করুন
অ্যাক্টিভিটি বা প্রসেস আবার তৈরি করার সময় আপনার কম্পোজ এলিমেন্টের স্ট্যাটাস সঠিকভাবে রিস্টোর করা হয়েছে কিনা তা যাচাই করুন। StateRestorationTester ক্লাসের সাথে অ্যাক্টিভিটি রিক্রিয়েশনের উপর নির্ভর না করে
এই ধরনের চেক পারফর্ম করুন।
এই ক্লাস আপনাকে কম্পোজেবল রিক্রিয়েশন সিমুলেট করতে দেয়। rememberSaveable-এর প্রয়োগ যাচাই করার জন্য
এটি বিশেষভাবে উপযোগী।
class MyStateRestorationTests {
@get:Rule
val composeTestRule = createComposeRule()
@Test
fun onRecreation_stateIsRestored() {
val restorationTester = StateRestorationTester(composeTestRule)
restorationTester.setContent { MainScreen() }
// TODO: Run actions that modify the state
// Trigger a recreation
restorationTester.emulateSavedInstanceStateRestore()
// TODO: Verify that state has been correctly restored.
}
}
বিভিন্ন ডিভাইস কনফিগারেশন পরীক্ষা করা
Android অ্যাপকে অনেক পরিবর্তনশীল পরিস্থিতির সাথে মানিয়ে নিতে হয়: উইন্ডোর সাইজ, লোকেল,
ফন্টের সাইজ, ডার্ক ও লাইট থিম এবং আরও অনেক কিছু। এইসব শর্তের বেশিরভাগই
ব্যবহারকারীর দ্বারা নিয়ন্ত্রিত ডিভাইস-লেভেল ভ্যালু থেকে প্রাপ্ত এবং বর্তমান Configuration ইনস্ট্যান্সের সাথে
প্রকাশিত হয়। সরাসরি টেস্টে বিভিন্ন কনফিগারেশন টেস্ট করা কঠিন, কারণ টেস্টে ডিভাইস-লেভেল প্রপার্টি কনফিগার করতে হয়।
DeviceConfigurationOverride হল শুধুমাত্র পরীক্ষার জন্য API যা আপনাকে পরীক্ষার অধীনে থাকা @Composable কন্টেন্টের জন্য
স্থানীয়ভাবে বিভিন্ন ডিভাইস কনফিগারেশন
সিমুলেট করতে দেয়।
DeviceConfigurationOverride-এর কম্প্যানিয়ন অবজেক্টে নিম্নলিখিত এক্সটেনশন ফাংশন আছে, যা ডিভাইস-লেভেল কনফিগারেশন প্রপার্টি ওভাররাইড করে:
DeviceConfigurationOverride.DarkMode(): সিস্টেমকে ওভাররাইড করে ডার্ক থিম বা লাইট থিম করে।DeviceConfigurationOverride.FontScale(): সিস্টেম ফন্ট স্কেল ওভাররাইড করে।DeviceConfigurationOverride.FontWeightAdjustment(): সিস্টেম ফন্টের ওজন অ্যাডজাস্টমেন্ট ওভাররাইড করে।DeviceConfigurationOverride.ForcedSize(): ডিভাইসের সাইজ যাই হোক না কেন, নির্দিষ্ট পরিমাণ জায়গা ব্যবহার করতে বাধ্য করে।DeviceConfigurationOverride.LayoutDirection(): লেআউট দিকনির্দেশ (বাঁদিক-থেকে-ডানদিক অথবা ডানদিক-থেকে-বাঁদিক) ওভাররাইড করে।DeviceConfigurationOverride.Locales(): লোকেল ওভাররাইড করে।DeviceConfigurationOverride.RoundScreen(): স্ক্রিন গোল হলে ওভাররাইড করে।
নির্দিষ্ট ওভাররাইড প্রয়োগ করতে, টেস্ট করা হচ্ছে এমন কন্টেন্টকে
DeviceConfigurationOverride() টপ-লেভেল ফাংশনে কল করে র্যাপ করুন, প্যারামিটার হিসেবে প্রয়োগ করার জন্য ওভাররাইড
পাস করুন।
যেমন, নিম্নলিখিত কোডটি লোকালি ডেনসিটি পরিবর্তন করতে
DeviceConfigurationOverride.ForcedSize() ওভাররাইড প্রয়োগ করে, MyScreen কম্পোজেবলকে একটি বড় ল্যান্ডস্কেপ উইন্ডোতে রেন্ডার করতে বাধ্য করে, এমনকি যে ডিভাইসে পরীক্ষা চলছে সেটি সরাসরি সেই উইন্ডোর সাইজকে
সমর্থন না করলেও:
composeTestRule.setContent { DeviceConfigurationOverride( DeviceConfigurationOverride.ForcedSize(DpSize(1280.dp, 800.dp)) ) { MyScreen() // Will be rendered in the space for 1280dp by 800dp without clipping. } }
একসাথে একাধিক ওভাররাইড প্রয়োগ করতে, DeviceConfigurationOverride.then() ব্যবহার করুন:
composeTestRule.setContent { DeviceConfigurationOverride( DeviceConfigurationOverride.FontScale(1.5f) then DeviceConfigurationOverride.FontWeightAdjustment(200) ) { Text(text = "text with increased scale and weight") } }
পরীক্ষায় কাস্টম ব্যর্থতা ম্যানেজ করা
UI টেস্ট ডিবাগ করার সময়, কোনও অ্যাসারশন ব্যর্থ হলে, প্রায়শই স্ক্রিনের স্ট্যাটাস ও কম্পোজিশন হায়ারার্কি পরীক্ষা করতে হয়।
ডায়াগনস্টিকস স্ট্রিমলাইন করার জন্য Compose একটি নেটিভ ব্যর্থতা ম্যানেজ করার পাইপলাইন প্রদান করে। ব্যর্থ হলে আপনি অটোমেটিক স্ক্রিনশট ও UI হায়ারার্কি ক্যাপচার করতে পারবেন অথবা এক্সটার্নাল টুলে ক্র্যাশ টেলিমেট্রি ফরওয়ার্ড করার জন্য কাস্টম হ্যান্ডলার রেজিস্টার করতে পারবেন।
ব্যর্থতা ম্যানেজ করার পদ্ধতি কনফিগার করুন
ব্যর্থতা ম্যানেজ করার কনফিগারেশন করতে, ComposeUiTestConfig-এ
TestFailurePolicy অবজেক্ট পাস করুন।
বিল্ট-ইন ব্যর্থতার আর্টিফ্যাক্ট ক্যাপচার করুন
টেস্ট করার সময় সমস্যা হলে স্ক্রিনশট ও UI হায়ারার্কি ক্যাপচার করতে, TestFailurePolicy-এ screenshotCaptureMode ও uiHierarchyCaptureMode প্রপার্টি সেট করুন।
class MyComposeTest { private val customConfig = ComposeUiTestConfig( failurePolicy = TestFailurePolicy( screenshotCaptureMode = TestFailurePolicy.CaptureMode.Enabled, uiHierarchyCaptureMode = TestFailurePolicy.CaptureMode.Enabled ) ) @Test fun myFirstTest() = runComposeUiTest(config = customConfig) { // ... } }
কাস্টম ফেলিয়র হ্যান্ডলার ব্যবহার করুন
টেস্ট করায় সমস্যার জন্য কাস্টম আচরণ নির্ধারণ করতে, failureHandlers তালিকাতে
TestFailureHandler যোগ করুন। প্রতিটি হ্যান্ডলার
একটি FailureContext অবজেক্ট পায় যাতে আসল সমস্যা এবং
পূর্ববর্তী পাইপলাইন হ্যান্ডলারের মাধ্যমে জেনারেট করা আর্টিফ্যাক্টের তালিকা থাকে।
class MyComposeTestWithHandler { private val customConfig = ComposeUiTestConfig( failurePolicy = TestFailurePolicy( screenshotCaptureMode = TestFailurePolicy.CaptureMode.Enabled, failureHandlers = listOf( TestFailureHandler { context -> val screenshot = context.artifacts.firstOrNull { it.type == FailureArtifact.Type.Screenshot } // ... } ) ) ) @get:Rule val rule = createComposeRule(config = customConfig) // ... }
সম্পূর্ণ টেস্ট স্যুটের জন্য ক্যাপচার কনফিগার করুন
আপনার মডিউলের build.gradle ফাইলে ইন্সট্রুমেন্টেশন রানার আর্গুমেন্ট পাস করে আপনি সম্পূর্ণ টেস্ট স্যুটের জন্য ব্যর্থ আর্টিফ্যাক্ট ক্যাপচার চালু করতে পারেন। এর ফলে
আলাদা আলাদা টেস্ট ফাইল আপডেট করার প্রয়োজন হয় না।
// build.gradle.kts
android {
defaultConfig {
// ...
testInstrumentationRunnerArguments["androidx.compose.ui.test.failure.isUiHierarchyCaptureEnabled"] = "true"
testInstrumentationRunnerArguments["androidx.compose.ui.test.failure.isScreenshotCaptureEnabled"] = "true"
}
}
কনফিগারেশনের অগ্রাধিকার
ফ্রেমওয়ার্ক স্থানীয় TestFailurePolicy এবং সুইট-লেভেল রানার আর্গুমেন্ট
উভয়ই মূল্যায়ন করে:
- আপনি যদি আপনার টেস্ট
failurePolicy-এ স্পষ্টভাবেCaptureMode.Enabled/Disabled-এ একটি মোড সেট করেন, তাহলে এটি রানার আর্গুমেন্টকে ওভাররাইড করে। - আপনি কোনও মোড
CaptureMode.Unspecified-এ সেট করলে (অথবাfailurePolicy-কেnullহিসেবে ছেড়ে দিলে), ফ্রেমওয়ার্ক রানার আর্গুমেন্টে ফিরে যায়।
অতিরিক্ত রিসোর্স
- Android-এ অ্যাপ টেস্ট করা: Android-এ টেস্ট করার মূল ল্যান্ডিং পৃষ্ঠা থেকে টেস্টিংয়ের মূল বিষয় ও টেকনিক সম্পর্কে আরও বিস্তারিত তথ্য পাওয়া যায়।
- পরীক্ষা করার মূল বিষয়: Android অ্যাপ পরীক্ষা করার পিছনে থাকা মূল ধারণা সম্পর্কে আরও জানুন।
- লোকাল টেস্ট: আপনি নিজের ওয়ার্কস্টেশনে লোকালি কিছু টেস্ট চালাতে পারবেন।
- ইনস্ট্রুমেন্টেড টেস্ট: ইনস্ট্রুমেন্টেড টেস্ট রান করানোও একটি ভালো অভ্যাস। অর্থাৎ, সরাসরি ডিভাইসে রান করা টেস্ট।
- কন্টিনিউয়াস ইন্টিগ্রেশন: কন্টিনিউয়াস ইন্টিগ্রেশন আপনাকে ডিপ্লয়মেন্ট পাইপলাইনে টেস্ট ইন্টিগ্রেট করতে দেয়।
- বিভিন্ন স্ক্রিন সাইজ টেস্ট করুন: ব্যবহারকারীদের কাছে অনেক ডিভাইস উপলভ্য, তাই আপনাকে বিভিন্ন স্ক্রিন সাইজের জন্য টেস্ট করতে হবে।
- Espresso: View-ভিত্তিক UI-এর জন্য তৈরি করা হলেও, Espresso-এর জ্ঞান Compose টেস্টিংয়ের কিছু ক্ষেত্রে সহায়ক হতে পারে।