Robolectric — τι είναι, αρχές λειτουργίας και unit testing Android

Τι είναι το Robolectric

Robolectric είναι ένα open-source framework, που δημιουργήθηκε το 2010 για την επιτάχυνση του testing εφαρμογών Android. Αντί να εκτελείται σε εξομοιωτή ή συσκευή, το Robolectric παρέχει shadow-υλοποιήσεις κλάσεων Android SDK που λειτουργούν απευθείας στην Java Virtual Machine (JVM). Αυτό επιτρέπει την εκτέλεση χιλιάδων tests σε δευτερόλεπτα.

Το πρόβλημα που λύνει το Robolectric

Το παραδοσιακό Android testing απαιτεί εκτέλεση της εφαρμογής σε εξομοιωτή, που διαρκεί 3–10 λεπτά για τη δημιουργία APK, εγκατάσταση και εκκίνηση. Το Robolectric εξαλείφει αυτό το βήμα: τα tests μεταγλωττίζονται ως συνηθισμένα Java/Kotlin tests και εκτελούνται μέσω JUnit. Αυτό δίνει έναν κύκλο ανάδρασης λίγων δευτερολέπτων αντί για λεπτά.

Υποστηριζόμενες εκδόσεις Android

Το Robolectric υποστηρίζει όλες τις εκδόσεις Android από API 16 (Android 4.1) έως την τελευταία σταθερή έκδοση. Για κάθε έκδοση παρέχεται ένα αντίστοιχο σύνολο shadow-αντικειμένων που εξομοιώνουν τη συμπεριφορά ακριβώς εκείνης της έκδοσης πλατφόρμας στην οποία δοκιμάζεται η εφαρμογή.

Αρχιτεκτονική και shadow-αντικείμενα

Η αρχιτεκτονική του Robolectric βασίζεται στον μηχανισμό παρεμπόδισης κλήσεων μέσω αντικατάστασης του classloader. Όταν ένα test καλεί μια μέθοδο του Android SDK, το Robolectric παρεμποδίζει την κλήση και την κατευθύνει στο shadow-αντικείμενο. Shadow-αντικείμενο είναι μια κλάση Java που μιμείται την πραγματική συμπεριφορά ενός στοιχείου Android, αλλά λειτουργεί χωρίς native πλατφόρμα.

Πώς λειτουργούν τα shadows

Τα shadow-αντικείμενα υλοποιούν βασικές μεθόδους των αρχικών κλάσεων Android. Για παράδειγμα, το ShadowTextView μιμείται τις μεθόδους getText(), setText(), getCurrentTextColor() και άλλες. Κατά την κλήση textView.setText(“Hello”) το shadow αποθηκεύει το string και το επιστρέφει κατά την κλήση getText(). Αυτό απομονώνει τα tests από την πραγματική απόδοση και τις υπηρεσίες συστήματος.

Shadow-ιεραρχία

Το Robolectric υποστηρίζει πάνω από 200 shadow-κλάσεις που καλύπτουν τα κύρια στοιχεία του Android SDK: Activity, Fragment, TextView, Button, RecyclerView, WebView, LocationManager, ConnectivityManager και πολλά άλλα. Τα shadow-αντικείμενα ακολουθούν την ίδια ιεραρχία κληρονομικότητας με τις αρχικές κλάσεις Android.

Εγκατάσταση και ρύθμιση Robolectric

Η εγκατάσταση του Robolectric σε ένα έργο Gradle απαιτεί την προσθήκη της εξάρτησης testImplementation “org.robolectric:robolectric:4.x”. Επίσης, πρέπει να καθοριστεί η ρύθμιση android:sdk στο αρχείο build.gradle και να προστεθεί το android:testInstrumentationRunner. Για τη λειτουργία με Robolectric δεν απαιτείται το πρόσθετο android-test.

Βασική ρύθμιση Gradle

Μετά την προσθήκη της εξάρτησης, πρέπει να ρυθμιστεί ο κατάλογος για το manifest, τους πόρους και τα assets. Το 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 σχολιασμός επιτρέπει την παράκαμψη παραμέτρων test: sdk (έκδοση API), manifest (διαδρομή προς το manifest), qualifiers (ρύθμιση οθόνης, γλώσσα). Αυτό είναι χρήσιμο για τη δοκιμή συμπεριφοράς της εφαρμογής σε διαφορετικές εκδόσεις Android, προσανατολισμούς οθόνης και τοπικές ρυθμίσεις.

Σύνταξη tests με Robolectric

Τα Robolectric tests γράφονται ως συνηθισμένα unit tests με @RunWith(RobolectricTestRunner.class) για JUnit 4 ή μέσω RobolectricExtension για JUnit 5. ActivityController διαχειρίζεται τον κύκλο ζωής Activity: create(), start(), resume(), pause(), stop(), destroy(). Αυτό επιτρέπει λεπτομερή δοκιμή κάθε μετάβασης κατάστασης.

Δοκιμή Activity

Για τη δοκιμή Activity χρησιμοποιείται το ActivityController που διέρχεται διαδοχικά από τα στάδια του κύκλου ζωής. Η πρόσβαση στο Activity γίνεται μέσω controller.get(). Όλα τα στοιχεία προβολής είναι προσβάσιμα μέσω findViewById, όπως σε μια πραγματική εφαρμογή. Τα shadow-αντικείμενα επιτρέπουν τον έλεγχο κειμένων, ορατότητας, χρωμάτων και άλλων χαρακτηριστικών προβολής.

@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());
    }
}

Δοκιμή intents και πλοήγησης

Το Robolectric παρεμποδίζει κλήσεις startActivity() και επιτρέπει τον έλεγχο των σταλμένων intent μέσω ShadowActivity. Αυτό δίνει τη δυνατότητα δοκιμής πλοήγησης: έλεγχος ότι όταν πατιέται ένα κουμπί, στέλνεται ένα Intent με σωστό Action, Data και Extra παραμέτρους.

@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 είναι ιδανικό για γρήγορα unit tests, έλεγχο λογικής UI, επιχειρηματικών στοιχείων και αποθετηρίων. Ο εξομοιωτής είναι απαραίτητος για instrumental tests, έλεγχο ενσωμάτωσης με API, δοκιμή κάμερας, αισθητήρων και απόδοσης.

Δοκιμή ViewModel και Repository

Το Robolectric είναι εξαιρετικό για δοκιμή ViewModel, Repository και UseCase — στοιχεία που χρησιμοποιούν Android SDK αλλά δεν απαιτούν πραγματικό UI. ViewModel δοκιμάζεται μέσω συνηθισμένου JUnit test με RobolectricExtension, ενώ τα στοιχεία κύκλου ζωής (LiveData, StateFlow) λειτουργούν σε shadow-περιβάλλον χωρίς mock.

Δοκιμή LiveData

Το Robolectric υποστηρίζει LiveData out of the box: μπορεί κανείς να εγγραφεί στο LiveData στο test, να αλλάξει κατάσταση μέσω ViewModel και να ελέγξει την εκπεμπόμενη τιμή. Για ασύγχρονες λειτουργίες χρησιμοποιείται InstantTaskExecutorRule ή runBlocking για coroutines. Αυτό εξαλείφει την ανάγκη δημιουργίας mock για αρχιτεκτονικά στοιχεία.

@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)
    }
}

Προσαρμοσμένα shadow-αντικείμενα

Εάν τα τυπικά shadow-αντικείμενα του Robolectric δεν καλύπτουν την απαιτούμενη κλάση Android SDK, μπορεί να δημιουργηθεί προσαρμοσμένο Shadow. Γι’ αυτό δημιουργείται μια κλάση με @Implements(ClassName.class) και υλοποιούνται οι απαραίτητες μέθοδοι με @Implementation. Τα προσαρμοσμένα shadows καταχωρούνται μέσω @Config(shadows = [CustomShadow::class]).

Δοκιμή ContentProvider και Resources

Το Robolectric υποστηρίζει δοκιμή ContentProvider μέσω Robolectric.buildContentProvider(). Μπορούν να ελεγχθούν λειτουργίες CRUD, query με αντιστοίχιση URI και διαχείριση δικαιωμάτων πρόσβασης. Οι πόροι (strings, χρώματα, μεγέθη) είναι επίσης προσβάσιμοι μέσω RuntimeEnvironment.application.resources, επιτρέποντας τη δοκιμή κώδικα που εξαρτάται από πόρους.

Μετάβαση από εξομοιωτή σε Robolectric

Η μετάβαση από instrumental tests σε Robolectric απαιτεί αλλαγή προσέγγισης. Instrumental tests (AndroidJUnit4) ελέγχουν πραγματική συμπεριφορά στον εξομοιωτή, Robolectric — απομονωμένη λογική σε shadow-περιβάλλον. Συνιστάται η κάλυψη επιχειρηματικής λογικής με Robolectric tests, και τα instrumental tests να διατηρούνται για σενάρια ενσωμάτωσης.

Προσαρμογή υπαρχόντων tests

Κατά τη μετάβαση πρέπει: αντικατάσταση AndroidJUnit4 με RobolectricTestRunner, προσθήκη @Config με την έκδοση SDK-στόχο, αντικατάσταση ActivityTestRule με ActivityController, και μεταφορά εξαρτήσεων από androidTestImplementation σε testImplementation. Τα Mock (MockK, Mockito) λειτουργούν με Robolectric χωρίς αλλαγές — δεν εξαρτώνται από την πλατφόρμα.

Περιορισμοί κατά τη μετάβαση

Το Robolectric δεν υποστηρίζει: δοκιμή κάμερας (CameraX), NFC, Bluetooth, βιομετρικών, εργασία με πραγματικά αρχεία και native βιβλιοθήκες. Γι’ αυτά τα σενάρια απαιτούνται instrumental tests στον εξομοιωτή. Το Robolectric επίσης δεν αναπαράγει πραγματική απόδοση — τα tests διάταξης είναι καλύτερο να εκτελούνται μέσω Compose Test Rule ή Espresso. Ωστόσο, για έλεγχο επιχειρηματικής λογικής, πλοήγησης και καταστάσεων ViewModel, το Robolectric αντικαθιστά πλήρως τον εξομοιωτή με 10πλάσια επιτάχυνση.

Συμβατότητα με εκδόσεις Java και Kotlin

Το Robolectric απαιτεί JDK 11 ή νεότερο και είναι συμβατό με AGP (Android Gradle Plugin) από 7.0 έως την τελευταία σταθερή έκδοση. SDK manager του Robolectric κατεβάζει αυτόματα τις απαραίτητες εκδόσεις Android API κατά την πρώτη εκκίνηση — αυτή είναι μια εφάπαξ λειτουργία. Για διακομιστές CI συνιστάται προηγούμενη λήψη του SDK μέσω sdkmanager για αποφυγή καθυστερήσεων κατά την πρώτη εκτέλεση tests. Η ενημέρωση του Robolectric σε νέα έκδοση συνήθως δεν απαιτεί αλλαγές στον κώδικα tests, μόνο ενημέρωση του αριθμού εξάρτησης στο build.gradle.

Ενσωμάτωση με MockK και Mockito

Το Robolectric είναι συμβατό με δημοφιλή mocking frameworks: MockK για Kotlin και Mockito για Java. Τα Mock χρησιμοποιούνται για απομόνωση εξαρτήσεων: αποθετήρια, API clients, SharedPreferences. Βασικός κανόνας — μην κάνετε mock κλάσεις Android SDK, γι’ αυτό υπάρχουν shadow-αντικείμενα. Κάνετε mock μόνο επίπεδα εφαρμογής: UseCase, Repository, DataSource και άλλα στοιχεία επιχειρηματικής λογικής. Τέτοιος συνδυασμός shadow-αντικειμένων και mock δίνει μέγιστη ευελιξία με ελάχιστο κόστος σύνταξης tests.