Changes between Version 51 and Version 52 of Getting-Started/Android

Timestamp:

Apr 21, 2015 5:08:10 AM (9 years ago)

Author:

nanang

Comment:

--

Getting-Started/Android

@@ -120 +120 @@
  - using real device: http://developer.android.com/tools/device.html
 
-== Building and running pjsua sample application == #pjsua
-
-We have pjsua sample application located under {{{pjsip-apps/src/pjsua/android}}}. It is not built by default, and you need [http://www.swig.org/download.html SWIG] to build it.
+
+== Building and running pjsua2 sample application == #pjsua2
+
+A sample application using [http://www.pjsip.org/docs/book-latest/html/index.html pjsua2 API] with SWIG Java binding, is located under {{{pjsip-apps/src/swig/java/android}}}. It is not built by default, and you need [http://www.swig.org/download.html SWIG] to build it.
+
+Follow these steps to build pjsua2 sample application:
+ 1. Make sure SWIG is in the build environment PATH.
+ 1. Run {{{make}}} from directory {{{$PJDIR/pjsip-apps/src/swig}}} (note that the Android NDK root should be in the PATH), e.g:
+     {{{
+$ cd /path/to/your/pjsip/dir
+$ cd pjsip-apps/src/swig
+$ make
+     }}}
+ 1. Make sure any library dependencies are copied to {{{$PJDIR/pjsip-apps/src/swig/java/android/libs/armeabi}}}, e.g: {{{libyuv.so & libopenh264.so}}} for video support.
+ 1. Create Android project from pjsua. 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 '''pjsua2''' source code (i.e. {{{$PJDIR/pjsip-apps/src/swig/java/android}}}) and press '''Finish'''
+ 1. You may need to select different Android SDK than what is configured in pjsua2. You can do this from the project's '''Properties'''.
+ 1. Run it.
+
+=== Log output ===
+
+The pjsua2 sample application will write log messages to '''!LogCat''' window (to show !LogCat window, from Eclipse menu: '''Window''' --> '''Show View''' --> '''Other''' --> type ''!LogCat'')
+
+
+== Creating your own application == #create-own-app
+
+For developing Android application, you should use [http://www.pjsip.org/docs/book-latest/html/index.html pjsua2 API] whose Java interface available via SWIG Java binding.
+
+Note that this has only been tested using [http://developer.android.com/tools/help/adt.html Eclipse with ADT], however it might also be applicable for [http://developer.android.com/tools/studio/index.html Android Studio].
+
+ 1. First, build {{{pjproject}}} libraries as described above.
+ 1. Also build {{{pjsua2 sample application}}} as described above, this step is required to generate the pjsua2 Java interface and the native library.
+ 1. Create Android application outside the PJSIP sources for your project.
+ 1. Get pjsua2 Java interface and native library from pjsua2 sample application:
+    1. Copy pjsua2 Java interface files from {{{pjsip-apps/src/swig/java/android/src}}} to your project's {{{src}}} folder:
+       {{{
+$ cd $YOUR_PROJECT_DIR
+$ cp -r $PJSIP_DIR/pjsip-apps/src/swig/java/android/src .
+
+# Cleanup excess pjsua2 application sources.
+$ rm -r src/org/pjsip/pjsua2/app
+       }}}
+    1. Copy native library {{{libpjsua2.so}}} from {{{pjsip-apps/src/swig/java/android/libs}}} to your project's {{{libs}}} folder:
+       {{{
+$ cd $YOUR_PROJECT_DIR
+$ cp -r $PJSIP_DIR/pjsip-apps/src/swig/java/android/libs .
+       }}}
+ 1. Start writing your application, please check [http://www.pjsip.org/docs/book-latest/html/index.html pjsua2 docs] for reference.
+
+
+== Pjsua application with telnet interface == #pjsua
+
+There is also the usual [http://www.pjsip.org/pjsua.htm pjsua] with telnet command line user interface, which is located under {{{pjsip-apps/src/pjsua/android}}}. It is not built by default and you need [http://www.swig.org/download.html SWIG] to build it. Application flow and user interface are handled mainly in the native level, so it doesn't use pjsua2 API with Java interface.
 
 Follow these steps to build pjsua:
@@ -142 +194 @@
 
 
-== Building and running pjsua2 sample application == #pjsua2
-
-Another sample application, which is based on [https://trac.pjsip.org/repos/ticket/1519 pjsua2 high-level API] with SWIG binding, is located under {{{pjsip-apps/src/swig/java/android}}}. It is not built by default, and you need [http://www.swig.org/download.html SWIG] to build it.
-
-Follow these steps to build pjsua2 sample application:
- 1. Make sure SWIG is in the build environment PATH.
- 1. Run {{{make}}} from directory {{{$PJDIR/pjsip-apps/src/swig}}} (note that the Android NDK root should be in the PATH), e.g:
-     {{{
-$ cd /path/to/your/pjsip/dir
-$ cd pjsip-apps/src/swig
-$ make
-     }}}
- 1. Make sure any library dependencies are copied to {{{$PJDIR/pjsip-apps/src/swig/java/android/libs/armeabi}}}, e.g: {{{libyuv.so & libopenh264.so}}} for video support.
- 1. Create Android project from pjsua. 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 '''pjsua2''' source code (i.e. {{{$PJDIR/pjsip-apps/src/swig/java/android}}}) and press '''Finish'''
- 1. You may need to select different Android SDK than what is configured in pjsua2. You can do this from the project's '''Properties'''.
- 1. Run it.
-
-=== Log output ===
-
-The pjsua2 sample application will write log messages to '''!LogCat''' window (to show !LogCat window, from Eclipse menu: '''Window''' --> '''Show View''' --> '''Other''' --> type ''!LogCat'')
-
-
-== Using pjsua2 for developing your own application == #create-own-app
-
-Note that this has only been tested using [http://developer.android.com/tools/help/adt.html Eclipse with ADT], however it might also be applicable for [http://developer.android.com/tools/studio/index.html Android Studio].
-
- 1. First, build {{{pjproject}}} libraries as described above.
- 1. Also build {{{pjsua2 sample application}}} as described above, this step is required to generate the pjsua2 Java interface and the native library.
- 1. Create Android application outside the PJSIP sources for your project.
- 1. Get pjsua2 Java interface and native library from pjsua2 sample application:
-    1. Copy pjsua2 Java interface files from {{{pjsip-apps/src/swig/java/android/src}}} to your project's {{{src}}} folder:
-       {{{
-$ cd $YOUR_PROJECT_DIR
-$ cp -r $PJSIP_DIR/pjsip-apps/src/swig/java/android/src .
-
-# Cleanup excess pjsua2 application sources.
-$ rm -r src/org/pjsip/pjsua2/app
-       }}}
-    1. Copy native library {{{libpjsua2.so}}} from {{{pjsip-apps/src/swig/java/android/libs}}} to your project's {{{libs}}} folder:
-       {{{
-$ cd $YOUR_PROJECT_DIR
-$ cp -r $PJSIP_DIR/pjsip-apps/src/swig/java/android/libs .
-       }}}
- 1. Start writing your application, please check [http://www.pjsip.org/docs/book-latest/html/index.html pjsua2 docs] for reference.
-
-
 == Debugging native code with Eclipse == #debug-native