Changes between Initial Version and Version 1 of Getting-Started/Windows

Timestamp:

Apr 28, 2009 11:53:35 AM (16 years ago)

Author:

ismangil

Comment:

--

Getting-Started/Windows

@@ +1 @@
+= Getting Started: Building for Microsoft Windows =
+
+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 ==
+
+It is important that you create a config_site.h as described in [wiki:Building-Preparation Building Preparation]
+
+== 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),
+
+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: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: 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.
+   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.
+