= Getting Started: Building for !BlackBerry 10 (BB10) =
[[TracNav(Getting-Started/TOC)]]
[[PageOutline(2-3,,inline)]]


!BlackBerry 10 (BB10) target is available in the Subversion trunk and currently still experimental.

When it ships, BB10 is expected to have native echo cancellation.

For the latest guide see this [http://blog.pjsip.org/2013/01/15/port-your-pjsip-engine-to-blackberry-10-in-less-than-10-minutes/ blog post].

== Requirements ==

* You'll need !BlackBerry 10 Native SDK. After you download the SDK, set the environment variables by running {{{bbndk-env}}} script provided in the SDK:
 {{{
$ source bbndk_dir/bbndk-env.sh
 }}}

* [https://github.com/blackberry/Cascades-Community-Samples/tree/master/bb10-pjsipdemo BB10 PJSIP Demo]
 * In particular read through [https://github.com/blackberry/Cascades-Community-Samples/blob/master/bb10-pjsipdemo/README.txt README]

== Building PJSIP ==

[wiki:Getting-Started/Download-Source Get the source code], if you haven't already.

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

Notes:
 * the {{{./configure-bb10}}} is a wrapper that calls the standard {{{./configure}}} script with settings suitable for BB10 target.
 * you may pass standard {{{./configure}}} options to this script too.
 * for more info, run {{{./configure-bb10 --help}}}
 * other customizations are similar to what is explained in [wiki:Getting-Started/Autoconf Building with GNU] page.

== Simulator ==

Install and configure the BB10 simulator, you will need to install a virtual machine player in order to use the simulator. To build for BB10 simulator, just run:
 {{{
$ ./configure-bb10 --simulator
$ make dep && make clean && make
 }}}