Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/caarmen/robolectricinstrumentationworkshop
https://github.com/caarmen/robolectricinstrumentationworkshop
Last synced: 11 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/caarmen/robolectricinstrumentationworkshop
- Owner: caarmen
- License: apache-2.0
- Created: 2024-03-17T16:19:29.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-04-13T03:16:29.000Z (7 months ago)
- Last Synced: 2024-04-14T12:00:30.710Z (7 months ago)
- Language: Kotlin
- Size: 142 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Robolectric - Instrumentation - Compose unified test suite
## Step 1 - Create a single activity app
Create an app with one activity with:
* A Text initially set to "0"
* A Button which, when clicked, increments the number in the Text
```
┌───────────────┐
│ MainActivity │
│ │
│ Text │
│ "0" │
│ │
│ │
│ │
│ Button │
│ "Add one" │
│ │
│ │
└───────────────┘
```
### Step 1.1
Create the app.
### Step 1.2
Create a UI instrumentation test in `src/androidTest` using `AndroidComposeTestRule` which launches the activity and tests the behavior of the Button and Text.
### Step 1.3
Create a Robolectric test in `src/test` which tests the same thing, using Robolectric apis (not best practice).
### Step 1.4
Adapt the Robolectric test to use androidx test apis instead of Robolectric apis.
### Step 1.5
Merge the two tests into one single test folder.
### Step 1.6
Cleanup: Remove redundant tests.
## Step 2 - Create an app with two activities
Create an app with two activities:
```
┌───────────────┐ ┌───────────────┐ ┌──────────────┐
│ MainActivity │ │ SecondActivity│ │MainActivity │
│ │ │ │ │ │
│ Label │ │ Text input │ │Label │
│ "" │ │ "Hello" │ │"Hello" │
│ │ │ │ │ │
│ │ │ │ │ │
│ │ │ │ │ │
│ Button │ startActivity │ Button │ finish │Button │
│ "Click me" ├──────────────────────►│ "Close" ├─────────────────►│"Click me" │
│ │ ForResult │ │ │ │
│ │ │ │ │ │
└───────────────┘ └───────────────┘ └──────────────┘
```
* The app launches in `MainActivity`.
* Click on "Click me" to start `SecondActivity` for a result.
* In `SecondActivity`, type some text in the Text input.
* In `SecondActivity`, click "Close".
* `SecondActivity` sets the result, and finishes.
* `MainActivity` shows the text that was entered in `SecondActivity`.
### Step 2.1
Create the app.
### Step 2.2
Create a UI instrumentation test in `src/androidTest` using `AndroidComposeTestRule` which launches the activity and tests the behavior of the activities.
### Step 2.3
Create a Robolectric test in `src/test` which tests the same thing, using Robolectric apis for the wiring between activities
### Step 2.4
Create a ShadowActivity to replace the wiring done in step 2.3
### Step 2.5
Introduce more robust shadows to support multi-activity tests.
### Step 2.6
Merge the two tests into one single test folder.
### Step 2.7
Cleanup: Remove redundant tests.
### Step 2.8
Specify robolectric-specific `Config` to run tests on multiple api levels (only for jvm tests).
## Step 3 - Create an app with an interaction on an external app
Create an app with one screen which displays the current state of airplane mode:
```
┌───────────────┐
│ MainActivity │
│ │
│ Label │
│ "Airplane ON" │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
└───────────────┘
```
The activity updates the label when the airplane mode state changes.
### Step 3.1
Create the app.
### Step 3.2
Create a UI instrumentation test in `src/androidTest` using `AndroidComposeTestRule` and UI Automator to toggle airplane mode from the system settings.
### Step 3.3
Create a Robolectric test in `src/test` which tests the same things, using Robolectric apis instead of UI Automator to simulate airplane mode state changes.
### Step 3.4
Merge the two tets into one single test folder.
### Step 3.5
Cleanup: Remove redundant tests.
# References
* Write automated tests with UI Automator: https://developer.android.com/training/testing/other-components/ui-automator
* Testing in Jetpack Compose: https://developer.android.com/codelabs/jetpack-compose-testing
* Compose testing cheatsheet: https://developer.android.com/jetpack/compose/testing-cheatsheet
* Robolectric: https://robolectric.org/