Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robolectric/robolectric
Android Unit Testing Framework
https://github.com/robolectric/robolectric
android java robolectric unit-testing
Last synced: 3 days ago
JSON representation
Android Unit Testing Framework
- Host: GitHub
- URL: https://github.com/robolectric/robolectric
- Owner: robolectric
- License: other
- Created: 2010-08-28T00:28:25.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2024-12-02T08:47:50.000Z (10 days ago)
- Last Synced: 2024-12-02T12:06:00.440Z (10 days ago)
- Topics: android, java, robolectric, unit-testing
- Language: Java
- Homepage: http://robolectric.org
- Size: 57.5 MB
- Stars: 5,910
- Watchers: 199
- Forks: 1,373
- Open Issues: 510
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- mobile-guide - Robolectric
- awesome-android-testing - Robolectric
README
[](https://github.com/robolectric/robolectric/actions?query=workflow%3Atests)
[](https://github.com/robolectric/robolectric/releases)
Robolectric is the industry-standard unit testing framework for Android. With Robolectric, your tests run in a simulated Android environment inside a JVM, without the overhead and flakiness of an emulator. Robolectric tests routinely run 10x faster than those on cold-started emulators.
Robolectric supports running unit tests for *15* different versions of Android, ranging from Lollipop (API level 21) to V (API level 35).
## Usage
Here's an example of a simple test written using Robolectric:
```java
@RunWith(AndroidJUnit4.class)
public class MyActivityTest {
@Test
public void clickingButton_shouldChangeResultsViewText() {
Activity activity = Robolectric.setupActivity(MyActivity.class);
Button button = (Button) activity.findViewById(R.id.press_me_button);
TextView results = (TextView) activity.findViewById(R.id.results_text_view);
button.performClick();
assertThat(results.getText().toString(), equalTo("Testing Android Rocks!"));
}
}
```
For more information about how to install and use Robolectric on your project, extend its functionality, and join the community of contributors, please visit [robolectric.org](https://robolectric.org).
## Install
### Starting a New Project
If you'd like to start a new project with Robolectric tests, you can refer to `deckard` (for either [Maven](https://github.com/robolectric/deckard-maven) or [Gradle](https://github.com/robolectric/deckard-gradle)) as a guide to setting up both Android and Robolectric on your machine.
### `build.gradle`
```groovy
testImplementation "junit:junit:4.13.2"
testImplementation "org.robolectric:robolectric:4.14.1"
```
## Building and Contributing
Robolectric is built using Gradle. Both Android Studio and IntelliJ can import the top-level `build.gradle.kts` file and will automatically generate their project files from it.
To get Robolectric up and running on your machine, check out
[this guide](https://robolectric.org/building-robolectric/).
To get a high-level overview of Robolectric's architecture, check out
[robolectric.org](https://robolectric.org/architecture).
## Development model
Robolectric is actively developed in several locations. The primary location is
this GitHub repository, which is considered the *source-of-truth* for
Robolectric code. It is where contributions from the broader Android developer
community occur. There is also an active development tree of Robolectric
internally at Google, where contributions from first-party Android developers
occur. By having a development tree of Robolectric internally at Google, it
enables first-party Android developers to more efficiently make contributions
to Robolectric. This tree is synced directly to the [`google`
branch](https://github.com/robolectric/robolectric/tree/google) every
time a change occurs using the [`Copybara`](https://github.com/google/copybara)
code sync tool. Bidirectional merges of this branch and the
[`master`](https://github.com/robolectric/robolectric/tree/master) branch occur
regularly.
Robolectric also has usage in the Android platform via the
[external/robolectric](https://cs.android.com/android/platform/superproject/main/+/main:external/robolectric/)
repo project. Contributions to this source tree are typically related to new
SDK support and evolving platform APIs. Changes from this branch are upstreamed
to the internal Robolectric tree at Google, which eventually propagate to the
GitHub branches.
Although complex, this distributed development model enables Android developers
in different environments to use and contribute to Robolectric, while allowing
changes to eventually make their way to public Robolectric releases.
## Using Snapshots
If you would like to live on the bleeding edge, you can try running against a snapshot build. Keep in mind that snapshots represent the most recent changes on the `master` and may contain bugs.
### `build.gradle`
```groovy
repositories {
maven { url "https://oss.sonatype.org/content/repositories/snapshots" }
}
dependencies {
testImplementation "org.robolectric:robolectric:4.15-SNAPSHOT"
}
```
](https://robolectric.org)