Robolectric — এটি কী, কাজের নীতি এবং Android ইউনিট টেস্টিং

Robolectric কী

Robolectric একটি ওপেন-সোর্স ফ্রেমওয়ার্ক যা 2010 সালে Android অ্যাপ্লিকেশন টেস্টিং দ্রুত করার জন্য তৈরি করা হয়েছিল। এমুলেটর বা ডিভাইসে চালানোর পরিবর্তে, Robolectric Android SDK ক্লাসের শ্যাডো ইমপ্লিমেন্টেশন সরবরাহ করে যা সরাসরি জাভা ভার্চুয়াল মেশিনে (JVM) চলে। এটি সেকেন্ডের মধ্যে হাজার হাজার টেস্ট চালানোর অনুমতি দেয়।

Robolectric যে সমস্যার সমাধান করে

প্রথাগত Android টেস্টিংয়ের জন্য এমুলেটরে অ্যাপ্লিকেশন চালানো প্রয়োজন, যা APK বানাতে, ইনস্টল করতে এবং চালাতে 3–10 মিনিট সময় নেয়। Robolectric এই ধাপটি বাদ দেয়: টেস্টগুলি সাধারণ Java/Kotlin টেস্টের মতো কম্পাইল হয় এবং JUnit-এর মাধ্যমে চলে। এটি মিনিটের পরিবর্তে সেকেন্ডে ফিডব্যাক লুপ প্রদান করে।

সমর্থিত Android ভার্সন

Robolectric API 16 (Android 4.1) থেকে সর্বশেষ স্টেবল রিলিজ পর্যন্ত সব Android ভার্সন সমর্থন করে। প্রতিটি ভার্সনের জন্য শ্যাডো অবজেক্টের সংশ্লিষ্ট সেট সরবরাহ করা হয় যা সেই প্ল্যাটফর্ম ভার্সনের আচরণ অনুকরণ করে যাতে অ্যাপ্লিকেশনটি পরীক্ষা করা হচ্ছে।

আর্কিটেকচার এবং শ্যাডো অবজেক্ট

Robolectric আর্কিটেকচার ক্লাসলোডার প্রতিস্থাপনের মাধ্যমে কল আটকানোর প্রক্রিয়ার উপর ভিত্তি করে তৈরি। যখন একটি টেস্ট Android SDK মেথড কল করে, Robolectric কলটি আটকায় এবং শ্যাডো অবজেক্টে পাঠায়। একটি শ্যাডো অবজেক্ট হল Java ক্লাস যা Android কম্পোনেন্টের বাস্তব আচরণ অনুকরণ করে কিন্তু নেটিভ প্ল্যাটফর্ম ছাড়া কাজ করে।

শ্যাডো কীভাবে কাজ করে

শ্যাডো অবজেক্ট মূল Android ক্লাসের মূল মেথডগুলি বাস্তবায়ন করে। উদাহরণস্বরূপ, ShadowTextView getText(), setText(), getCurrentTextColor() এবং অন্যান্য মেথড অনুকরণ করে। যখন textView.setText("হ্যালো") কল করা হয়, শ্যাডো স্ট্রিংটি সংরক্ষণ করে এবং getText() কল করলে তা ফেরত দেয়। এটি টেস্টকে বাস্তব রেন্ডারিং এবং সিস্টেম সার্ভিস থেকে আলাদা করে।

শ্যাডো শ্রেণিবিন্যাস

Robolectric 200টিরও বেশি শ্যাডো ক্লাস সমর্থন করে যা Android SDK-র প্রধান কম্পোনেন্ট কভার করে: Activity, Fragment, TextView, Button, RecyclerView, WebView, LocationManager, ConnectivityManager এবং আরও অনেক। শ্যাডো অবজেক্ট মূল Android ক্লাসের মতোই বংশগতি শ্রেণিবিন্যাস অনুসরণ করে।

Robolectric ইনস্টল ও কনফিগারেশন

Gradle প্রকল্পে Robolectric ইনস্টল করতে testImplementation "org.robolectric:robolectric:4.x" ডিপেন্ডেন্সি যোগ করা প্রয়োজন। build.gradle ফাইলে androidsdk কনফিগারেশন নির্দিষ্ট করা এবং android:testInstrumentationRunner রেজোলিউশন যোগ করাও প্রয়োজন। Robolectric-এর সাথে কাজ করতে Android-টেস্ট প্লাগইনের দরকার নেই।

মৌলিক Gradle কনফিগারেশন

ডিপেন্ডেন্সি যোগ করার পর, ম্যানিফেস্ট, রিসোর্স এবং অ্যাসেটের জন্য ডিরেক্টরি কনফিগার করতে হবে। Robolectric স্বয়ংক্রিয়ভাবে AndroidManifest.xml খুঁজে পায়, কিন্তু @Config অ্যানোটেশন বা সিস্টেম প্রপার্টিজের মাধ্যমে পথ ম্যানুয়ালি নির্দিষ্ট করার প্রয়োজন হতে পারে। মাল্টি-মডিউল প্রকল্পের জন্য, প্রতিটি মডিউলের জন্য আলাদাভাবে কনফিগারেশন সেট করা হয়।

// build.gradle — Robolectric কনফিগারেশন
android {
    testOptions {
        unitTests.includeAndroidResources = true
        unitTests.all {
            systemProperty 'robolectric.dependency.dir',
                project.rootDir.absolutePath + '/build/intermediates'
        }
    }
}

dependencies {
    testImplementation 'org.robolectric:robolectric:4.13'
    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
}

@Config অ্যানোটেশন

@Config অ্যানোটেশন টেস্ট প্যারামিটার ওভাররাইড করার অনুমতি দেয়: sdk (API ভার্সন), manifest (ম্যানিফেস্টের পথ), qualifiers (স্ক্রিন কনফিগারেশন, ভাষা)। এটি বিভিন্ন Android ভার্সন, স্ক্রিন ওরিয়েন্টেশন এবং লোকালাইজেশনে অ্যাপ্লিকেশনের আচরণ পরীক্ষার জন্য উপযোগী।

Robolectric দিয়ে টেস্ট লেখা

Robolectric টেস্ট JUnit 4-এর জন্য @RunWith(RobolectricTestRunner.class) বা JUnit 5-এর জন্য RobolectricExtension দিয়ে সাধারণ ইউনিট টেস্টের মতো লেখা হয়। ActivityController Activity-র লাইফসাইকেল পরিচালনা করে: create(), start(), resume(), pause(), stop(), destroy()। এটি প্রতিটি অবস্থা পরিবর্তন বিস্তারিতভাবে পরীক্ষা করতে দেয়।

Activity টেস্টিং

Activity পরীক্ষার জন্য ActivityController ব্যবহার করা হয়, যা ক্রমিকভাবে লাইফসাইকেল ধাপগুলির মধ্য দিয়ে যায়। Activity-তে অ্যাক্সেস controller.get()-এর মাধ্যমে হয়। সব ভিউ কম্পোনেন্ট findViewById-এর মাধ্যমে সুলভ, বাস্তব অ্যাপ্লিকেশনের মতো। শ্যাডো অবজেক্ট টেক্সট, দৃশ্যমানতা, রং এবং অন্যান্য ভিউ অ্যাট্রিবিউট পরীক্ষা করতে দেয়।

@RunWith(RobolectricTestRunner.class)
@Config(sdk = BuildConfig.SDK_INT)
public class MainActivityTest {

    @Test
    public void testActivityDisplaysGreeting() {
        ActivityController<MainActivity> controller =
            Robolectric.buildActivity(MainActivity.class);
        controller.create().start().resume();

        MainActivity activity = controller.get();
        TextView greeting = activity.findViewById(R.id.greeting);
        ShadowTextView shadow = Shadows.shadowOf(greeting);

        assertEquals("Welcome!", shadow.getText());
    }
}

ইনটেন্ট এবং নেভিগেশন টেস্টিং

Robolectric startActivity() কল আটকায় এবং ShadowActivity-র মাধ্যমে পাঠানো ইনটেন্ট পরীক্ষা করতে দেয়। এটি নেভিগেশন পরীক্ষা সম্ভব করে: বাটন ক্লিক করলে সঠিক Action, Data এবং Extra প্যারামিটারসহ Intent পাঠানো হচ্ছে কিনা তা যাচাই করা।

@Test
public void testNavigationToDetails() {
    controller.create().start().resume();
    MainActivity activity = controller.get();

    activity.findViewById(R.id.detailsButton).performClick();

    ShadowActivity shadowActivity = Shadows.shadowOf(activity);
    Intent intent = shadowActivity.getNextStartedActivity();
    assertEquals(
        DetailsActivity.class.getName(),
        intent.getComponent().getClassName()
    );
}

Robolectric বনাম এমুলেটর

Robolectric এবং এমুলেটর ভিন্ন কাজ সমাধান করে। Robolectric দ্রুত ইউনিট টেস্ট, UI লজিক, বিজনেস কম্পোনেন্ট এবং রিপজিটরি পরীক্ষার জন্য আদর্শ। এমুলেটর ইন্সট্রুমেন্টেশন টেস্ট, API-র সাথে ইন্টিগ্রেশন, ক্যামেরা, সেন্সর এবং পারফরম্যান্স পরীক্ষার জন্য প্রয়োজন।

ViewModel এবং Repository টেস্টিং

Robolectric ViewModel, Repository এবং UseCase — যেসব কম্পোনেন্ট Android SDK ব্যবহার করে কিন্তু বাস্তব UI প্রয়োজন হয় না — সেগুলি পরীক্ষার জন্য উপযুক্ত। ViewModel RobolectricExtension-সহ সাধারণ JUnit টেস্টের মাধ্যমে পরীক্ষা করা হয়, যখন লাইফসাইকেল কম্পোনেন্ট (LiveData, StateFlow) মক ছাড়া শ্যাডো পরিবেশে কাজ করে।

LiveData টেস্টিং

Robolectric LiveData সরাসরি সমর্থন করে: আপনি টেস্টে LiveData সাবস্ক্রাইব করতে পারেন, ViewModel-এর মাধ্যমে অবস্থা পরিবর্তন করতে পারেন এবং নির্গত মান পরীক্ষা করতে পারেন। অ্যাসিঙ্ক্রোনাস অপারেশনের জন্য InstantTaskExecutorRule বা করুটিনের জন্য runBlocking ব্যবহার করা হয়। এটি আর্কিটেকচারাল কম্পোনেন্ট মক করার প্রয়োজন দূর করে।

@RunWith(RobolectricTestRunner::class)
@Config(sdk = [BuildConfig.SDK_INT])
class ProfileViewModelTest {

    private val repository = FakeUserRepository()
    private val viewModel = ProfileViewModel(repository)

    @Test
    fun `loading profile sets state to success`() = runBlocking {
        viewModel.loadProfile("user123")
        val state = viewModel.profileState.getOrAwaitValue()
        Assertions.assertTrue(state is UiState.Success)
    }
}

কাস্টম শ্যাডো অবজেক্ট

যদি স্ট্যান্ডার্ড Robolectric শ্যাডো অবজেক্ট কোনো প্রয়োজনীয় Android SDK ক্লাস কভার না করে, আপনি একটি কাস্টম শ্যাডো তৈরি করতে পারেন। এর জন্য @Implements(ClassName.class) অ্যানোটেশনসহ একটি ক্লাস তৈরি করুন এবং @Implementation-সহ প্রয়োজনীয় মেথডগুলি বাস্তবায়ন করুন। কাস্টম শ্যাডো @Config(shadows = [CustomShadow::class])-এর মাধ্যমে নিবন্ধিত হয়।

ContentProvider এবং রিসোর্স টেস্টিং

Robolectric Robolectric.buildContentProvider()-এর মাধ্যমে ContentProvider টেস্টিং সমর্থন করে। আপনি CRUD অপারেশন, URI ম্যাচিংসহ কোয়েরি এবং অ্যাক্সেস অনুমতি ব্যবস্থাপনা পরীক্ষা করতে পারেন। রিসোর্স (স্ট্রিং, রং, ডাইমেনশন) RuntimeEnvironment.application.resources-এর মাধ্যমেও সুলভ, যা রিসোর্সের উপর নির্ভরশীল কোড পরীক্ষা করতে দেয়।

এমুলেটর থেকে Robolectric-এ স্থানান্তর

ইন্সট্রুমেন্টেশন টেস্ট থেকে Robolectric-এ স্থানান্তরের জন্য পদ্ধতির পরিবর্তন প্রয়োজন। ইন্সট্রুমেন্টেশন টেস্ট (AndroidJUnit4) এমুলেটরে বাস্তব আচরণ পরীক্ষা করে, যেখানে Robolectric শ্যাডো পরিবেশে বিচ্ছিন্ন লজিক পরীক্ষা করে। বিজনেস লজিক Robolectric টেস্ট দিয়ে কভার করার এবং ইন্সট্রুমেন্টেশন টেস্ট ইন্টিগ্রেশন দৃশ্যের জন্য রাখার সুপারিশ করা হয়।

বিদ্যমান টেস্ট অভিযোজন

স্থানান্তরের সময়: AndroidJUnit4-কে RobolectricTestRunner দিয়ে প্রতিস্থাপন করুন, লক্ষ্য SDK ভার্সনসহ @Config যোগ করুন, ActivityTestRule-কে ActivityController দিয়ে প্রতিস্থাপন করুন এবং androidTestImplementation থেকে testImplementation-এ ডিপেন্ডেন্সি সরান। মক (MockK, Mockito) পরিবর্তন ছাড়া Robolectric-এর সাথে কাজ করে — এগুলি প্ল্যাটফর্ম-স্বাধীন।

স্থানান্তরের সীমাবদ্ধতা

Robolectric সমর্থন করে না: ক্যামেরা (CameraX), NFC, ব্লুটুথ, বায়োমেট্রিক্স, বাস্তব ফাইল এবং নেটিভ লাইব্রেরির সাথে কাজ। এই দৃশ্যগুলির জন্য এমুলেটরে ইন্সট্রুমেন্টেশন টেস্ট প্রয়োজন। Robolectric বাস্তব রেন্ডারিংও পুনরুৎপাদন করে না — লেআউট টেস্টিং Compose Test Rule বা Espresso-র মাধ্যমে ভালো করা হয়। তবে, বিজনেস লজিক, নেভিগেশন এবং ViewModel অবস্থা পরীক্ষার জন্য, Robolectric 10x দ্রুত নির্বাহে এমুলেটরকে সম্পূর্ণরূপে প্রতিস্থাপন করে।

Java এবং Kotlin ভার্সনের সাথে সামঞ্জস্য

Robolectric-এর JDK 11 বা উচ্চতর প্রয়োজন এবং এটি AGP (Android Gradle Plugin) 7.0 থেকে সর্বশেষ স্টেবল ভার্সন পর্যন্ত সামঞ্জস্যপূর্ণ। Robolectric-এর SDK ম্যানেজার প্রথম রানে স্বয়ংক্রিয়ভাবে প্রয়োজনীয় Android API ভার্সন ডাউনলোড করে — এটি একবারের অপারেশন। CI সার্ভারের জন্য, প্রথম টেস্ট রানে বিলম্ব এড়াতে sdkmanager-এর মাধ্যমে SDK প্রি-লোড করার সুপারিশ করা হয়। Robolectric নতুন ভার্সনে আপডেট করার জন্য সাধারণত টেস্ট কোডে পরিবর্তনের প্রয়োজন হয় না, শুধু build.gradle-এ ডিপেন্ডেন্সি নম্বর আপডেট করা হয়।

MockK এবং Mockito-র সাথে ইন্টিগ্রেশন

Robolectric জনপ্রিয় মকিং ফ্রেমওয়ার্কের সাথে সামঞ্জস্যপূর্ণ: Kotlin-এর জন্য MockK এবং Java-র জন্য Mockito। মক নির্ভরতা বিচ্ছিন্ন করতে ব্যবহৃত হয়: রিপজিটরি, API ক্লায়েন্ট, SharedPreferences। মূল নিয়ম হল Android SDK ক্লাস মক না করা — এর জন্য শ্যাডো অবজেক্ট বিদ্যমান। শুধু অ্যাপ্লিকেশন লেয়ার মক করুন: UseCase, Repository, DataSource এবং অন্যান্য বিজনেস লজিক কম্পোনেন্ট। শ্যাডো অবজেক্ট এবং মকের এই সংমিশ্রণ ন্যূনতম টেস্ট লেখার প্রচেষ্টায় সর্বোচ্চ নমনীয়তা প্রদান করে।