Changes between Version 13 and Version 14 of Getting-Started/Android

Timestamp:

Oct 25, 2012 7:57:39 AM (12 years ago)

Author:

nanang

Comment:

Added tutorial for debugging native code.

Getting-Started/Android

@@ -42 +42 @@
 
 Follow these steps to build apjsua:
- 1. Go to apjsua source directory:
-    {{{
-$ cd pjsip-apps/src/apjsua
-    }}}
- 1. Make sure swig is in the PATH and build the app:
-    {{{
-$ make
-    }}}
+ 1. Make sure SWIG is in the build environment PATH.
+     - Alternatively, update SWIG path in {{{$PJDIR/pjsip-apps/src/apjsua/jni/Android.mk}}} file.
  1. Create Android project from apjsua. In Eclipse:
     a. From menu: '''File''' --> '''New''' --> '''Project'''
     a. Select '''Android Project from Existing Code''', press '''Next'''
-    a. In ''Root Directory'', put the location of '''apjsua''' source code (i.e. $PJDIR/pjsip-apps/src/apjsua) and press '''Finish'''
+    a. In ''Root Directory'', put the location of '''apjsua''' source code (i.e. {{{$PJDIR/pjsip-apps/src/apjsua}}}) and press '''Finish'''
  1. You may need to select different Android SDK than what is configured in apjsua. You can do this from the project's '''Properties'''.
  1. You can modify {{{apjsua/res/raw/config.txt}}} for apjsua's config file.
  1. Run it.
+
+
+== Debugging native code with Eclipse == #debug-native
+
+Here are the steps for debugging PJSIP native code using Eclipse:
+ 1. Build PJSIP with debugging enabled, e.g: insert {{{CFLAGS += -g}}} into {{{user.mak}}} in PJSIP root directory.
+ 1. Make sure that the JNI part of the application is built using {{{ndk-build}}}. For reference, check apjsua's {{{Android.mk}}} build config in {{{pjsip-apps/src/apjsua/jni}}}, it contains sample of how to import PJSIP build settings (build search paths, build flags, etc) and SWIG invocation.
+ 1. Enable NDK plugin for Eclipse, check [http://tools.android.com/recent/usingthendkplugin this] and follow the instructions.
+ 1. It is recommended to introduce delay (about 5 seconds) in the application code between loading the native code library and calling any native functions (to be debugged), e.g:
+     {{{
+try {
+        System.loadLibrary("some_native_lib.so");
+} catch (UnsatisfiedLinkError e) {
+        return -1;
+}
+
+// Wait for GDB init
+if ((getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE) != 0) {
+        try {
+                Thread.sleep(5000);
+        } catch (InterruptedException e) { }
+}
+
+// Start calling native functions here
+// ...
+     }}}
+ 1. Load PJSIP project to Eclipse, and try put breakpoint anywhere in the PJSIP code before launching the application debug configuration in Eclipse.
+
+
 
 == Other Android projects ==