{"id":1883,"date":"2016-04-20T10:42:29","date_gmt":"2016-04-20T17:42:29","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=1883"},"modified":"2016-04-20T10:42:56","modified_gmt":"2016-04-20T17:42:56","slug":"debugging-native-code-with-devices-with-the-run-as-bug","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/android\/run-as\/","title":{"rendered":"Debugging native code on Android devices with the ‘run-as’ bug"},"content":{"rendered":"

This tutorial shows how to debug the native code in your Android apps on devices that do not support the ‘run-as’ command. We will first demonstrate how to reproduce the ‘run-as’ problem and then explain the workaround VisualGDB supports. Before you begin, install VisualGDB 5.1r5 or later.<\/p>\n

    \n
  1. Start Visual Studio and open the VisualGDB Android Project Wizard:\"01-wizard\"<\/a><\/li>\n
  2. Proceed with the default “Create a new App” selection:\"02-newapp\"<\/a><\/li>\n
  3. On the next page proceed with the default app name and the package name:\"03-appname\"<\/a><\/li>\n
  4. Select your Android platform and press “Finish” to generate the project:\"04-platform\"<\/a><\/li>\n
  5. Once the project is generated, press Ctrl-Shift-B to build it:\"05-build\"<\/a><\/li>\n
  6. If you try to debug it now on a device with the run-as bug without testing the toolchain, you will get the following error:\n
    run-as: Package 'com.visualgdb.example.AndroidProject1' is unknown<\/pre>\n
    \"06-err\"<\/a>If you let VisualGDB test the toolchain, it will detect that the device needs the workaround and direct you to this page.<\/li>\n
  7. The problem happens because debugging native code in your app requires running gdbserver – a special tool that runs on the Android device and exposes the internals of your app to the debugger. If your Android device has too restrictive rights on the \/data\/system\/packages.list<\/strong> file, the run-as tool won’t be able to read the file and launch gdbserver with the correct permissions. VisualGDB provides a workaround that allows launching the gdbserver directly from your app and connecting to it automatically. Open VisualGDB Project Properties, go to the Debug Settings page and select “Start gdbserver – manually from the app”:\"07-runas\"<\/a><\/li>\n
  8. This will automatically add a new file to your project that will be responsible for launching gdbserver. Before we look into that file, go to the Makefile Settings page of VisualGDB Project Properties and add “-DLAUNCH_GDBSERVER_FROM_APP” to both CFLAGS and CXXFLAGS and also add “-llog” to the System Library Names:\"08-launcher\"<\/a><\/li>\n
  9. When you press OK, VisualGDB will add a file called gdbserver_launcher.c to your project. The main role of that file is to launch the gdbserver executable shipped with your app and redirect its output to a socket so that VisualGDB can display any errors it reports:\n
    static void DoLaunchGDBServer(const struct ControlBlock *pBlock, int socket)\r\n{\r\n\u00a0\u00a0\u00a0 char pid[32], port[32];\r\n\u00a0\u00a0\u00a0 sprintf(pid, \"%d\", getpid());\r\n\u00a0\u00a0\u00a0 sprintf(port, \":%d\", pBlock->GDBServerPort);\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 if (fork() == 0)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 dup2(socket, STDOUT_FILENO);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 dup2(socket, STDERR_FILENO);\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 int r = execl(pBlock->GDBServerPath,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"gdbserver\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 port,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"--attach\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 pid,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 NULL);\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/if execl() succeeds, control will never reach here\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 __android_log_print(ANDROID_LOG_ERROR, AppName, \"Failed to launch %s: error %d\", pBlock->GDBServerPath, r);\r\n\u00a0\u00a0\u00a0 }\r\n}<\/pre>\n<\/li>\n
  10. The logic responsible\u00a0 for launching gdbserver will be automatically triggered when the library using the gdbserver_launcher.c is loaded:\n
    __attribute__((constructor)) void GDBServerInitializer()\r\n{\r\n\u00a0\u00a0\u00a0 LaunchGDBServer();\r\n}<\/pre>\n
    As the native library does not have access to the Java environment and cannot determine the gdbserver location, it will simply open a socket and rely on VisualGDB to tell it the location of the gdbserver and the port to use. VisualGDB will do it automatically as long as you have the workaround enabled in Debug Settings.<\/li>\n
  11. Before you can debug your application, add the “android.permission.INTERNET” permission to the AndroidManifest.xml file. This will ensure that the application (and gdbserver) can actually open sockets and accept connections:\"09-perm\"<\/a><\/li>\n
  12. If you press F5 now, VisualGDB will automatically take care of locating and launching gdbserver and will start debugging for you:\"10-debug\"<\/a>The only differences from the regular debugging will be:\n