androidx-test-ext-junit-gtest-documentation.md
# Module root
JUnit Gtest
# Package androidx.test.ext.junitgtest
A JUnit runner for running Gtest suites on connected devices. Can be used by creating a Java/Kotlin class for the Gtest suite we want to run and annotating it with the `TargetLibrary` annotation. For example, given a gtest suite in a file `mytest.cpp`, we can create the following Kotlin class inside our `androidTest` directory.
```kotlin
@RunWith(GtestRunner::class)
@TargetLibrary("mytest")
class MyTest
```
And the `junit-gtest` library must be linked to your test library like the example `CMakeLists.txt`
```
project("example")
find_package(googletest REQUIRED CONFIG)
find_package(junit-gtest REQUIRED CONFIG)
add_library(
mylib
SHARED
mylib.cpp)
add_library(
mytest
SHARED
mytest.cpp)
target_link_libraries( # Specifies the target library.
mytest
PRIVATE
mylib
googletest::gtest
junit-gtest::junit-gtest
)
```