Merge pull request #437 from fsladkey/add-junit-gtest-sample

Add junit-gtest sample

Author: brettchabot

projects.conf

@@ -15,3 +15,4 @@ ui/espresso/RecyclerViewSample
 ui/espresso/ScreenshotSample
 ui/espresso/WebBasicSample
 ui/uiautomator/BasicSample
+unit/BasicNativeAndroidTest

unit/BasicNativeAndroidTest/.gitignore

@@ -0,0 +1,11 @@
+*.iml
+.gradle
+/local.properties
+/.idea/*
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
+

unit/BasicNativeAndroidTest/README.md

@@ -0,0 +1,19 @@
+# Basic sample for writing C/C++ GTest tests and running them on Android emulators / devices.
+
+This project uses the Gradle build system. You don't need an IDE to build and execute it but Android Studio is recommended.
+
+1. Download the project code, preferably using `git clone`.
+2. In Android Studio, select *File* | *Open...* and point to the `./build.gradle` file.
+3. Check out the relevant code:
+   * The C++ sources and tests are in `src/main/cpp`
+   * The device tests (which wrap the native tests) are in `src/androidTest/java`
+4. Create and run the Instrumented test configuration
+   * Open the `AdderTest` file, and click the run icon in the gutter, or
+   * Manually create a configuration.
+      * Open *Run* menu | *Edit Configurations*
+      * Add a new *Android Instrumented Tests* configuration
+      * Choose the `app` module
+      * Connect a device or start an emulator
+      * Run the newly created configuration
+
+If you are using Android Studio, the *Run* window will show the test results.

unit/BasicNativeAndroidTest/app/.gitignore

@@ -0,0 +1 @@
+/build

unit/BasicNativeAndroidTest/app/build.gradle

@@ -0,0 +1,69 @@
+plugins {
+    id 'com.android.application'
+    id 'kotlin-android'
+}
+apply plugin: 'kotlin-android'
+
+android {
+    compileSdk 32
+
+    defaultConfig {
+        applicationId "com.example.android.testing.nativesample"
+        minSdk 18
+        targetSdk 32
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        externalNativeBuild {
+            cmake {
+                arguments "-DANDROID_STL=c++_shared"
+            }
+        }
+    }
+    externalNativeBuild {
+        cmake {
+            path "src/main/cpp/CMakeLists.txt"
+        }
+    }
+
+    buildFeatures {
+        prefab true
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+    kotlinOptions {
+        jvmTarget = '1.8'
+    }
+    testOptions {
+        managedDevices {
+            devices {
+                // run with ../gradlew  nexusOneApi30DebugAndroidTest
+                nexusOneApi30(com.android.build.api.dsl.ManagedVirtualDevice) {
+                    // A lower resolution device is used here for better emulator performance
+                    device = "Nexus One"
+                    apiLevel = 30
+                    // Also use the AOSP ATD image for better emulator performance
+                    systemImageSource = "aosp-atd"
+                }
+            }
+        }
+    }
+}
+
+dependencies {
+    androidTestImplementation "junit:junit:$rootProject.junitVersion"
+    implementation "androidx.test.ext:junit-gtest:$rootProject.junitGtestVersion"
+    implementation "com.android.ndk.thirdparty:googletest:$rootProject.googletestVersion"
+    androidTestImplementation "androidx.test:runner:$rootProject.runnerVersion"
+    androidTestImplementation "androidx.test.ext:junit-ktx:$extJUnitVersion"
+}

unit/BasicNativeAndroidTest/app/proguard-rules.pro

@@ -0,0 +1,22 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
+

unit/BasicNativeAndroidTest/app/src/androidTest/java/com/example/android/testing/nativesample/AdderTest.kt

@@ -0,0 +1,12 @@
+package com.example.android.testing.nativesample
+
+import androidx.test.ext.junitgtest.GtestRunner
+import androidx.test.ext.junitgtest.TargetLibrary
+import org.junit.runner.RunWith
+
+
+// Run our tests with the `GtestRunner`, which knows how to load and run GTest suites.
+@RunWith(GtestRunner::class)
+// Specify the name of the artifact which contains our tests, as configured in CMakeLists.txt
+@TargetLibrary(libraryName = "adder-test")
+class AdderTest

unit/BasicNativeAndroidTest/app/src/main/AndroidManifest.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.example.android.testing.nativesample">
+  <application>
+  </application>
+</manifest>

unit/BasicNativeAndroidTest/app/src/main/cpp/CMakeLists.txt

@@ -0,0 +1,19 @@
+cmake_minimum_required(VERSION 3.10.2)
+
+project(junit-gtest-example LANGUAGES CXX)
+
+find_package(googletest REQUIRED CONFIG)
+find_package(junit-gtest REQUIRED CONFIG)
+
+include_directories(include)
+
+add_library(adder SHARED src/adder.cpp)
+
+add_library(adder-test SHARED test/adder_test.cpp)
+
+target_link_libraries(adder-test
+        PRIVATE
+        adder
+        googletest::gtest
+        junit-gtest::junit-gtest
+)

unit/BasicNativeAndroidTest/app/src/main/cpp/include/adder

@@ -0,0 +1 @@
+int add(int a, int b);