README.md

Android Testing in Chromium

Concepts

• Native Unit Tests: Normal Chromium unit tests based on the gtest framework. Tests for native code.
• Java Unit Tests: JUnit tests that run on the host machine using Robolectric to emulate Android APIs.
• Instrumentation Tests: JUnit tests that run on Android devices (or emulators).
  • Unit Instrumentation Tests: Instrumentation tests that test an individual feature. They do not require starting up ContentShell (or Chrome browser). These use BaseActivityTestRule or BlankUiTestActivityTestCase based on BaseActivityTestRule.
  • Integration Instrumentation Tests: Instrumentation tests that bring up ContentShell (or Chrome browser) to test a certain feature in the end-to-end flow. These typically use more specialized test rules such as ContentShellActivityTestRule or ChromeActivityTestRule.

How do I...

• set up
  • ... set up a device for local testing?
  • ... set up an emulator for local testing?
• writing tests
  • ... write an instrumentation test?
  • ... write a JUnit or Robolectric test?
  • ... write a test that needs to mock native calls?
• running tests
  • ... run a gtest?
  • ... run an instrumentation test?
  • ... run a JUnit test?
  • ... run the Web tests?
  • ... run a telemetry test?
• debugging tests
  • ... debug junit tests?
  • ... debug flaky tests?
• miscellaneous
  • ... use code coverage for Java tests?

How does it work on Android?

• gtests
• instrumentation tests
• junit tests