Version 21 (modified by ming, 14 years ago) (diff)


Getting Started: Building for Apple iPhone, iPad and iPod Touch

  1. Features
  2. Requirements
  3. Build Preparation
  4. Building PJSIP
  5. Simulator
  6. Common problems
    1. Compilation error using iPhoneSimulator SDK version 3.2
    2. Sound not working in the simulator
  7. Other iPhone Projects

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


Some of the features of the iPhone port:

  • it has 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
  • supports for the built-in iLBC codec


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

Build Preparation

  1. 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


  • 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 Building with GNU page.


To configure the build system for the iPhone simulator:

$ export DEVPATH=/Developer/Platforms/iPhoneSimulator.platform/Developer
$ export CC=/Developer/Platforms/iPhoneSimulator.platform/Developer/usr/bin/gcc-4.0
$ ./configure-iphone
$ make dep && make clean && make

Note that the exact paths may vary according to your SDK version.

Common problems

Compilation error using iPhoneSimulator SDK version 3.2

If you get this error during compilation:


Add this in your config_site.h:


Sound not working in the simulator

Go to System Preferences > Sound > Sound Effects and then uncheck and recheck "Play user interface sound effects".

Other iPhone Projects

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

Attachments (1)

Download all attachments as: .zip