= Getting Started: Building for Microsoft Windows =
[[TracNav(Getting-Started/TOC)]]


This page describes how to use Microsoft Visual Studio to build pjsip libraries.

  Note: You can also build for Windows using GNU tools such mingw. Follow the steps in [wiki:Getting-Started/Autoconf Getting Started: Building with GNU Tools/Autoconf].

== Build Preparation ==

 1. It is important that you create a config_site.h as described in [wiki:Getting-Started/Building-Preparation Building Preparation]
 2. [wiki:Getting-Started/Download-Source Get the source code], if you haven't already.

== Requirements ==

The Visual Studio based project files can be used with one of the following tools:

    * Microsoft Visual Studio 6,
    * Microsoft Visual Studio .NET 2002,
    * Microsoft Visual Studio .NET 2003,
    * Microsoft Visual C++ 2005 (including Express edition),
    * Microsoft Visual Studio 2008 may work, but not tested specifically. Follow the instructions for Visual Studio 2005.

In addition, the following SDK's are needed:

    * Platform SDK (tested with Platform SDK for Windows Server 2003 SP1).
    * DirectX SDK (tested with DirectX version 8 and 9),
    * OpenSSL development kit (optional) is needed if TLS support is wanted. Learn more: [wiki:Getting-Started/Installing-OpenSSL-Windows Installing OpenSSL Libraries on Windows].

  Note: The new Platform SDK is still needed for Visual Studio 6, although VS6 comes with its own Platform SDK. The new Platform SDK is needed for Iphlpapi.[h|lib] for the new PJNATH library.

For the host, the following are required:

    * Windows NT, 2000, XP, 2003, or later ,
    * Windows 95/98 should work too, but this has not been tested,
    * Sufficient amount of RAM for the build process.


== Building the Projects ==

Follow the steps below to build the libraries/application using Visual Studio:

   1. For Visual Studio 6/2002/2003: open pjproject.dsw workspace file.
   2. For Visual Studio 8 (VS 2005): open pjproject-vs8.sln solution file.
   3. Set pjsua as Active Project.
   4. Select Debug or Release build as appropriate.
   5. Build the project. This will build pjsua application and all libraries needed by pjsua.
   6. After successful build, the pjsua application will be placed in pjsip-apps/bin directory, and the libraries in lib directory under each projects.

To build the samples:

   1. (Still using the same workspace)
   2. Set samples project as Active Project
   3. Select Debug or Release build as appropriate. See [wiki:Getting-Started/Visual-Studio-Build-Configuration Visual Studio Build Configuration] page for explanation of each provided build configuration]
   4. Build the project. This will build all sample applications and all libraries needed.
   5. After successful build, the sample applications will be placed in pjsip-apps/bin/samples directory, and the libraries in lib directory under each projects.

 
== Debugging Sample Applications ==

Sample applications are built using Samples.mak makefile, therefore it is difficult to setup debugging session in Visual Studio for these applications. To solve this issue, the pjsip_apps workspace contain one project called sample_debug which can be used to debug a sample application.

To setup debugging using sample_debug project:

   1. Set sample_debug project as Active Project
   2. Edit debug.c file inside this project.
   3. Modify the #include line to include the particular sample application to debug
   4. Select Debug build.
   5. Build and debug the project.