Skip to content

A self hosted Android test lab to run android automation tests. A possible firebase alternative

Notifications You must be signed in to change notification settings

oianmol/OpenTestLabAndroid

Repository files navigation

OpenTestLabAndroid

Banner

Overview

This project enables Android developers to execute automation test cases on self-hosted servers.

Features

  • Test Sharding - So more devices the better it gets 😈
  • Report management includes Junit XML styles report with metrics
  • Video recordings of every automation test!

Setup Instructions

  • Configure your test server's IP address in your Android projects build.gradle(.kts)
openTestLabConfigure {
    serverAddress = "localhost:8081"
    ignoreFailures = true
}

Demo Video!

output.mp4

Sample Test Report Junit Report file and the test video recording!

Screenshot 2024-07-09 at 10 27 34 AM
greetingDisplayedWithNameAndroid.dev.oianmol.sampleandroidapp.MainActivityTest.mp4

Features

  • Run automation tests on a self-hosted server
  • Upload builds to this server and groups them by a unique build number
  • Collects reports from the test execution along with Junit Formate reports and recorded videos.

Prerequisites

  • Java Development Kit
  • Android SDK
  • [Any other required tools or libraries] (TBD)

Installation

  1. Clone the repository:

    git clone https://github.com/oianmol/OpenTestLabAndroid.git
    cd OpenTestLabAndroid

2 Set up the Android SDK:

Ensure the ANDROID_HOME environment variable is set to your Android SDK path.

```bash
export ANDROID_HOME=/path/to/your/android/sdk
```

3 Make sure JDK is there?

4 TBD

Usage

  1. Start the server:

    execute Main.kt!
  2. Look at the sample android app:

    Place your test cases in the androidTest directory.

  3. Execute tests:

    checkout the accompanied gradle plugin it should generate a gradle task for you to run the android tests on your remote server.

Configuration

  • Server settings: [Provide details on how to configure the server settings]
  • Device configurations: [Details on configuring devices for testing]

Logging and Reporting

  • Logs are stored in the logs directory.
  • Test reports can be found in the reports directory.

Contributing

We welcome contributions! Please see our Contributing Guidelines for more details.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or support, please open an issue on GitHub or contact [anmol.verma4@gmail.com].


Feel free to modify this template according to your project's specifics.

About

A self hosted Android test lab to run android automation tests. A possible firebase alternative

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages