= Getting Started: Building for Apple iPhone =
[[TracNav(Getting-Started/TOC)]]
[[PageOutline(2-3,,inline)]]


Apple iPhone target is supported by PJSIP version 1.6.5 and later.

== Features ==

The iPhone port contains a native !CoreAudio based audio device, which supports the following features:
 * the built-in/device's echo canceller
 * output volume setting
 * change input route to bluetooth input
 * change output route
 * input latency setting
 * output latency setting


== Requirements ==

You'll need an iPhone SDK. We tested mainly with version 3.x SDK/devices, but SDK version 2.x would build fine too.

== Build Preparation ==

 1. [wiki:Getting-Started/Download-Source Get the source code], if you haven't already.
 2. Set your {{{config_site.h}}} to the following:
  {{{
#define PJ_CONFIG_IPHONE 1
#include <pj/config_site_sample.h>
  }}}
  This will activate iPhone specific settings in the {{{config_site_sample.h}}}.

== Building PJSIP ==

Just run:
 {{{
$ cd /path/to/your/pjsip/dir
$ ./configure-iphone
$ make dep && make clean && make
 }}}

Notes:
 * the {{{./configure-iphone}}} is a wrapper that calls the standard {{{./configure}}} script with settings suitable for iPhone target.
 * the latest iPhone SDK version will be selected by default. You may change this by setting {{{IPHONESDK}}} environment variable to the desired SDK path.
 * you may pass standard {{{./configure}}} options to this script too.
 * for more info, run {{{./configure-iphone --help}}}
 * other customizations are similar to what is explained in [wiki:Getting-Started/Autoconf Building with GNU] page.


== Other iPhone Projects ==

Also have a look at these PJSIP iPhone ports by pjsip users:

 * [http://code.google.com/p/siphon/ Siphon] Project by Samuel Vinson
 * [http://code.teluu.com/tabikphone/ TabikPhone], an adaptation of Sipphone code from V-Net Corp