Android JUnit runner¶

The Android JUnit runner lets a normal JVM test execute an AutoMobile YAML plan against a connected device. The Kotlin test owns pass/fail assertions; the plan keeps device actions easy to review.

sequenceDiagram
  participant Gradle as Gradle testDebugUnitTest
  participant Runner as AutoMobileRunner (JVM)
  participant Daemon as AutoMobile Daemon
  participant Device as Android device (ADB)

  Gradle->>Runner: run test class
  Runner->>Daemon: connect
  Runner->>Daemon: execute YAML plan
  Daemon->>Device: launch, observe, interact
  Device-->>Daemon: UI state and screenshots
  Daemon-->>Runner: success or failed step
  Runner-->>Gradle: pass or fail

import dev.jasonpearson.automobile.junit.AutoMobilePlan
import dev.jasonpearson.automobile.junit.AutoMobileRunner
import org.junit.Test
import org.junit.runner.RunWith
import kotlin.test.assertTrue

@RunWith(AutoMobileRunner::class)
class LaunchTest {
  @Test
  fun appLaunches() {
    val result = AutoMobilePlan("test-plans/launch-app.yaml").execute()
    assertTrue(result.success, result.output)
  }
}

name: launch-app
platform: android
steps:
  - tool: launchApp
    appId: com.example.app
    clearAppData: true
  - tool: observe
    waitFor:
      text: Welcome
      timeout: 10000