OpenTestLabAndroid

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!

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 [[email protected]].

---

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