freeswitch/libs/unimrcp/INSTALL
Brian West c7b05ea27c bump rev to upstream r1401
git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@16719 d0543943-73ff-0310-b7d9-9358b9ac24b2
2010-02-22 15:43:43 +00:00

130 lines
3.6 KiB
Plaintext

BUILD REQUIREMENTS
==================
UniMRCP depends on a number of third party tools and libraries,
which are required and must be installed first.
The easiest and recommended way is to install an appropriate
dependency package from the download area, which contains APR,
APR-Util and Sofia-SIP libraries prepackaged for UniMRCP use.
http://code.google.com/p/unimrcp/downloads/
Alternatively, the original packages of APR, APR-Util and
Sofia-SIP libraries and patches for them can be downloaded from
http://www.unimrcp.org/dependencies/
References:
1. Apache Portable Runtime [>=1.2.x] (http://apr.apache.org/).
Whenever you want to build any part of UniMRCP, you need the
Apache Portable Runtime (APR) and the APR Utility (APR-util)
libraries.
2. Sofia-SIP [>=1.12.6] (http://sofia-sip.sourceforge.net/).
Sofia-SIP library is used to implement MRCPv2 specification
compliant SIP signaling. Sofia-SIP is an open-source SIP User-Agent
library, compliant with the IETF RFC3261 specification.
GNU BUILD
===================
Additional requirements
- autoconf 2.57 or newer
- automake
- libtool 1.4 or newer
- gcc
- pkg-config
Build procedure
$ ./bootstrap
$ ./configure
$ make
$ make install
Installed directory layout
bin - binaries (unimrcpserver, unimrcpclient)
conf - configuration files
data - data files
include - header files
lib - shared (convenient) libraries
log - log files
plugin - run-time loadable modules
There are a couple of options to "./configure".
To specify where to look for the APR and APR-util libraries
use the "--with-apr=" and "--with-apr-util=" options.
For example
$ ./configure --with-apr=/usr/local/apr \
--with-apr-util=/usr/local/apr
To specify where to look for the Sofia-SIP library
use the "--with-sofia-sip=" option.
For example
$ ./configure --with-sofia-sip=/usr/local/sofia-sip
To cross-compile for 64-bit platform use
CFLAGS=-m64 CXXFLAGS=-m64 LDFLAGS=-m64 ./configure
To cross-compile for 32-bit platform use
CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 ./configure
To install the default configuration use
$ cd conf
$ make def-conf
To install the default data use
$ cd data
$ make def-data
To generate doxygen documentation from the source use
$ make dox
WINDOWS BUILD
======================
Additional requirements
- Microsoft Visual Studio 2005
One-time pre-build preparation
You may need to adjust the paths for 3-rd party libraries
in appropriate property sheets to match your local installation,
while below are the defaults (build/vsprops).
apr.vsprops
<UserMacro
Name="AprDir"
Value="$(SolutionDir)libs\apr"
/>
<UserMacro
Name="AprUtilDir"
Value="$(SolutionDir)libs\apr-util"
/>
sofiasip.vsprops
<UserMacro
Name="SofiaDir"
Value="$(SolutionDir)libs\sofia-sip"
/>
Build procedure
- open unimrcp.sln solution file
- choose an appropriate solution platform (Build -> Configuration Manager) either win32 or x64
- choose an appropriate solution configuration (Build -> Configuration Manager) either Debug or Release
- build the solution (Build -> Build Solution)
One-time pre-run output directory preparation
Build prepare.vcproj utility project (right click on tools -> prebuild in
Solution Explorer and select Build from context menu). This is a one-time
output directory preparation. It copies all the required APR and SofiaSIP
libraries and the default configuration to the output directory.
Output directory layout
bin - binaries (unimrcpserver, unimrcpclient) and all the required dlls
conf - configuration files
data - data files
lib - libraries
log - log files
plugin - run-time loadable modules