{"id":2236,"date":"2016-11-17T19:34:52","date_gmt":"2016-11-18T03:34:52","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=2236"},"modified":"2016-11-17T19:34:52","modified_gmt":"2016-11-18T03:34:52","slug":"running-c-unit-tests-on-android-devices","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/android\/tests\/","title":{"rendered":"Running C++ Unit Tests on Android devices"},"content":{"rendered":"

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.<\/p>\n

Before you begin, install VisualGDB 5.2 or later.<\/p>\n

    \n
  1. Start Visual Studio and open the VisualGDB Android Project Wizard:\"01-prjname\"<\/a><\/li>\n
  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-unittest\"<\/a>Normally VisualGDB will create\u00a0 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.<\/li>\n
  3. Proceed with the default settings on the “Project Source” page:\"03-activity\"<\/a><\/li>\n
  4. On the last page of the wizard select the platform you would like to target and the hardware platforms:\"04-platform\"<\/a><\/li>\n
  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\"<\/a><\/li>\n
  6. Select Test->Run All to launch them on your device. The FailingTest should immediately fail, while the others should succeed:\"06-testsdone\"<\/a><\/li>\n
  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:\n
    #include <CppUTest\/CommandLineTestRunner.h>\r\n#include <stdio.h>\r\n#include <android\/sensor.h>\r\n\r\nTEST_GROUP(HardwareTests)\r\n{\r\n};\r\n\r\nTEST(HardwareTests, AccelerometerTest)\r\n{\r\n\u00a0\u00a0\u00a0 ASensorList sensorList;\r\n\u00a0\u00a0\u00a0 ASensorManager* sensorManager = ASensorManager_getInstance();\r\n\u00a0\u00a0\u00a0 CHECK(sensorManager);\r\n\u00a0\u00a0\u00a0 int n = ASensorManager_getSensorList(sensorManager, &sensorList);\r\n\u00a0\u00a0\u00a0 bool accelerometerFound = false;\r\n\u00a0\u00a0\u00a0 for (int i = 0; i < n; i++)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 const ASensor* sensor = sensorList[i];\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (sensor == NULL)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 continue;\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (ASensor_getType(sensor) != ASENSOR_TYPE_ACCELEROMETER)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 continue;\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 const char* name = ASensor_getName(sensor);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 const char* vendor = ASensor_getVendor(sensor);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"Found accelerometer: %s %s\\n\", vendor, name);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 accelerometerFound = true;\r\n\u00a0\u00a0\u00a0 }\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 CHECK(accelerometerFound);\r\n}<\/pre>\n<\/li>\n
  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\"<\/a><\/li>\n
  9. Build the project. The Test Explorer window will show the newly added test:\"08-buildtests\"<\/a><\/li>\n
  10. Start it via Test->Run All Tests or by right-clicking on it and selecting “Run Selected Tests”:\"09-pass\"<\/a><\/li>\n
  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\"<\/a><\/li>\n
  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()<\/strong> 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\"<\/a><\/li>\n
  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\"<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to run C++ unit tests on your Android devices. We will create a basic unit test<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[31,129],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/2236"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=2236"}],"version-history":[{"count":1,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/2236\/revisions"}],"predecessor-version":[{"id":2249,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/2236\/revisions\/2249"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=2236"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=2236"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=2236"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}