Changes between Version 1 and Version 2 of GSoC2012/Android/debugging

Timestamp:

Jun 7, 2012, 12:46:51 PM (12 years ago)

Author:

michaelz

Comment:

Added steps on configuring gdb and starting a debug session.

GSoC2012/Android/debugging

@@ -1 +1 @@
 = debugging native code in Android. =
+
+(setting this up is not needed to do java debugging, you just can't step into native functions.)
+
+== before starting ==
+
+You should at first compile the library yourself.
+
+Then, go to the android ndk directory. There should be a file ndk-gdb. Copy it, name the copy ndk-gdb-eclipse, and remove the following, last line:
+  $GDBCLIENT -x `native_path $GDBSETUP`
+
+== in Eclipse ==
+  * Open the External Tools Configuration Dialog.
+  * Add a new Program by double-clicking on Program on the left side.
+  * Select the ndk-gdb-eclipse script you just created.
+  * Select the build tab, and disable Build before launch.
+  * Hit Apply, Close.
+
 
   * (skip for Testclient) Set android:debuggable="true" in your application definition in the AndroidManifest.xml.
@@ -7 +24 @@
     * Enter im.pidgin.libpurple as Project name
     * Enter Android/libim.pidgin.libpurple.so as C/C++ Application name (or just click on Search project... to find it)
+    * Select Disable auto build
   * Go to the debugger tab.
     * Select gdbserver as Debugger.
@@ -12 +30 @@
     * As command file, select the gdb.setup file in the native directory.
     * In the connection tab, enter TCP as connection type, localhost as target and 5039 as port.
+  * Hit apply.
+
+  * Create a new Launch group by double-clicking on Launch group.
+    * Add the Program launcher you created. You should set "Post launch action" to "Wait until terminated".
+    * Add your Debug configuration we just created
+    * Give it a nice name.
   * Close the dialog by hitting Apply and Close.
+== Start debugging ==
+
+When you want to debug native code, do the following:
+
+  * Add a breakpoint before initializing libpurple, e.g. in your Applications onCreate().
+
+  * Start your application in the normal Android debug mode. It should pause at that breakpoint.
+
+  * Then start your debug configuration, by clicking on Debug Configurations..., selecting the Launch group you created and hitting Debug.