Kobaia

An android UI test library made in Kotlin

Kobaia is an Android library that provides an easy way to test UI with Kotlin. Built on top of UIAutomator2, it provides a simple and discoverable API, removing most of the boilerplate and verbosity of common UIAutomator tasks.

@get:Rule
val kobaiaRules = Kobaia(SplashActivity::class.java)

@Test
fun testApp() {
    kobaiaRules.launchActivity()
    assertTextExist("Kobaia")
    assertTextExist("SKIP")
    assertTextExist("NEXT")
    textClick("SKIP")
    textClick("GET STARTED")
    textClick("LOG IN")
    byDescription("Enter your email")?.text = "right_email@kobaia.com"
    byDescription("Enter your password")?.text = "12345678"
    textClick("ENTER")
    assertTextExist("Welcome to Kobaia!")
}

🚀 Why you should use Kobaia?

Behaviour Driven Development testing
- Kobaia is an high-level test library that create tests readable as close to what the user are doing with the app. So you can focus yours UI tests in a generic user interaction approach.
Automatic wait for your UI
- Kobaia wait your UI be visible in the screen. Animations, long processes and networks requests doesn't need wait/sleep threads workarounds.
Interact with elements outside your app
- Close the app and open and read an push notification? Or maybe test share a text message to an messenger app? It's easy with Kobaia.

📖 Usage

Coming Soon

📦 Installation

Step 1. Add the JitPack repository to your project build file

build.gradle (Project: YourProjectName)

allprojects {
	repositories {
	     ...
		maven { url 'https://jitpack.io' }
	}
}

Step 2. Add the dependency to your app build file

build.gradle (Module: app)

dependencies {
    ...
	implementation 'com.github.AraujoJordan:Kobaia:x.x.x'
}

And that's it!

🌟 Extras