Running C++ Unit Tests on Android devices

This tutorial shows how to run C++ unit tests on your Android devices. We will create a basic unit test based on the CppUTest framework that will check that the device has an accelerometer.

Before you begin, install VisualGDB 5.2 or later.

  1. Start Visual Studio and open the VisualGDB Android Project Wizard:01-prjname
  2. On the first page of the wizard select “Create a unit test project” and pick a framework. VisualGDB supports CppUTest and Googletest out-of-the-box and provides an extensibility interface to support any other 3rd-party framework:02-unittestNormally VisualGDB will create  Java app with C++ code that will run the unit tests inside a separate thread. If you don’t need the App context, you can select “Run tests inside a command-line executable” to create a stand-alone command-line Android binary.
  3. Proceed with the default settings on the “Project Source” page:03-activity
  4. On the last page of the wizard select the platform you would like to target and the hardware platforms:04-platform
  5. Press “Finish” to generate the project. Build it with Ctrl-Shift-B and open the Test Explorer to see the example unit tests detected by Visual Studio:05-tests
  6. Select Test->Run All to launch them on your device. The FailingTest should immediately fail, while the others should succeed:06-testsdone
  7. Now we will add a basic tests that ensures that your device has an accelerometer. Replace the code in the tests file with the following:
  8. Add “-landroid” to the System Library Names field in VisualGDB Project Properties so that your project can use the ASensor_xxx() functions:07-library
  9. Build the project. The Test Explorer window will show the newly added test:08-buildtests
  10. Start it via Test->Run All Tests or by right-clicking on it and selecting “Run Selected Tests”:09-pass
  11. If your device has an accelerometer, the test should succeed. If it does not, you can easily debug it by right-clicking on it in Test Explorer and selecting “Debug selected tests”:10-debug
  12. You can use the Call Stack window to understand the context in which the test is run. VisualGDB creates a separate thread using the pthread_create() function and passes control to the CppUTest framework. VisualGDB automatically selects the tests to run and interprets the information about successful and failed runs:11-shell
  13. VisualGDB also generates a very basic Java source file that creates a simple activity and invokes the StartTests() function so that the native tests can be started:12-javacode