= BOINC Dependencies on Windows =
BOINC uses a number of third party libraries to handle things like communicating through proxies  and SSL support.  Building these libraries with support for debugging can be tricky.

A number of dependency trees have been created for Visual Studio:

2005: [http://boinc.berkeley.edu/gitweb/?p=boinc_depends_win_vs2005.git;a=summary boinc_depends_win_vs2005][[BR]] 2008: [http://boinc.berkeley.edu/gitweb/?p=boinc_depends_win_vs2008.git;a=summary boinc_depends_win_vs2008][[BR]] 2010: [http://boinc.berkeley.edu/gitweb/?p=boinc_depends_win_vs2010.git;a=summary boinc_depends_win_vs2010][[BR]] 2013: [http://boinc.berkeley.edu/gitweb/?p=boinc_depends_win_vs2013.git;a=summary boinc_depends_win_vs2013][[BR]]

These will need to be updated whenever new third party libraries need to be used or the Microsoft C-Runtime  library has been updated.

== Building Updated Dependency Libraries ==
As of VS 2013 our libraries should be configured with the following settings for all builds.

Compiler Settings:

 * Debug Information Format: Program Database (/Zi)
 * Runtime Library: Multi-threaded DLL (/MD)

Linker Settings:

 * Generated Debug Info: Yes (/DEBUG)
 * Set Checksum: Yes (/RELEASE)

These settings enable the use of the correct C-Runtime library for BOINC and the ability for a debugger  to correctly load the right symbol file for a given executable or DLL from BOINC's  [http://boinc.berkeley.edu/symstore/ symbol store].

BOINC builds with four configurations:

 * Debug/x86
 * Release/x86
 * Debug/x64
 * Release/x64

Each library will need to have an updated binary and symbol file for each configuration.

=== zLib ===
Project URL: [http://www.zlib.net/]

zLib keeps its Visual Studio project files under 'contrib/vstudio/vc11'.  Upgrade the project files to VS 2013.

Build all four configurations and copy the dll, lib, and pdb file to the root of the zlib source directory so  that libcurl can find it later.

Project file diffs: [wiki:AdminDepLibszLib zLib]

=== OpenSSL ===
Project URL: https://www.openssl.org/ Follow these build instructions:

1) Install perl from https://www.activestate.com/activeperl

2) Open Visual Studio Command Prompt

3) Build 32-bit Release and debug.  Roughly based on INSTALL.W32 from the main openssl directory:

  Release:
{{{
$ perl Configure VC-WIN32 no-asm --prefix=c:\openssl_W32_Release 
$ ms\do_ms 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install
}}}
  Debug:
{{{
$ perl Configure VC-WIN32 no-asm --prefix=c:\openssl_W32_Debug 
$ ms\do_ms 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install
}}}

4) Open Visual Studio x64 Win64 Command Prompt (note this is different than the normal visual studio command prompt):

5) Build 64-bit Release and debug.  Instructions in INSTALL.W64 are not complete/detailed:

  Release:
{{{
$ perl Configure VC-WIN64A --prefix=c:\openssl_W64_Release 
$ ms\do_win64a 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install
}}}
  Debug:
{{{
$ perl Configure debug-VC-WIN64A --prefix=c:\openssl_W64_Debug 
$ ms\do_win64a 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install
}}}

6) Copy resulting files to the appropriate boinc_dependencies directories

=== Curl ===
Project URL: [http://curl.haxx.se/libcurl/]

Follow build instructions in docs/INSTALL for all configurations.

Example (Release/x86):

{{{
     set ZLIB_PATH=c:\src\sdks\zlib-1.2.8
     set OPENSSL_PATH=c:\src\sdks\openssl-1.0.2a
     nmake -f Makefile cfg=release-dll-ssl-dll-zlib-dll
}}}
Project file diffs: [wiki:AdminDepLibsCurl Curl]

=== Sqlite ===
(will be deprecated once we switch to concierge-based auto attach)

Project URL: !https://www.sqlite.org [[BR]]Follow these build instructions:[[BR]]1) Download the amalgamated source code files: !https://www.sqlite.org/index.html [[BR]]2) Open Visual Studio command prompt and cd to uncompressed amalagamted source directory:[[BR]][[BR]]
{{{
   $ cl sqlite3.c -DSQLITE_DEBUG -O2 -link -dll -out:sqlite3_Win32_Debug.dll
   $ cl sqlite3.c -O2 -link -dll -out:sqlite3_Win32_Release.dll
   $ "c:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin\link.exe" /lib /def:sqlite3.def /MACHINE:X86
}}}
[[BR]]3) Open Visual Studio x64 Win64 Command Prompt (note this is different than the normal visual studio command prompt):[[BR]][[BR]]
{{{
   $ cl sqlite3.c -DSQLITE_DEBUG -O2 -link -dll -out:sqlite3_x64_Debug.dll
   $ cl sqlite3.c -O2 -link -dll -out:sqlite3_x64_Release.dll
   $ "c:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin\link.exe" /lib /def:sqlite3.def /MACHINE:X64
}}}
[[BR]]4) Copy resulting files to the appropriate boinc_dependencies directories
=== !WxWidgets ===
URL: http://www.wxwidgets.org/