premiere-libtorrent/docs/vs2005_build_notes.rst

93 lines
3.0 KiB
ReStructuredText
Raw Normal View History

============================================
libtorrent setup for VS.NET 2005 Development
============================================
:Author: THOMAS GODDARD
:Contact: www.thomasgoddard.com
Prerequisites
-------------
1. Download boost from boost.org
2. Download libtorrent
3. Extract both to a folder called libtorrent
Compiling boost for VS.NET 2005
-------------------------------
1. Copy bjam.exe to libtorrent\\boost_[version]\\tools\\build
2. Add the path "libtorrent\\boost_[version]\\tools\\build" to the windows path environment variable
3. Log off / log back on
4. Open the file "libtorrent\\boost_[version]\\tools\\build\\user-config.jam" in notepad
5. Uncomment the ``# using msvc;`` line by removing the #
6. Replace the line with: ``using vc-8_0 ;``
7. Save the file and close it
8. Open the visual studio .net command line in the VS.net 2005 folder in your start menu
9. CD to the "libtorrent\\boost_[version]" folder
10. Type: ``bjam "-sTOOLS=vc-8_0" install`` and hit enter
11. Be patient and wait for it to finish
Troubleshooting
...............
* Make sure to CD to the root of the boost directory before running the install.
* For additional details and information on using Visual Studio 2005 Express addition, see the Boost Getting Started Guide.
Setting up and compiling libtorrent with VS.NET 2005
-----------------------------------------------------
1. Create a new vs.net 2005 MFC project and solution file in the root of the libtorrent folder where you extracted all of the libtorrent files.
2. Include the files contained in the src folder, excluding the makefiles.
**NOTE:**
Only include either file.cpp or file_win.cpp. Read here to determine which file to include:
http://www.rasterbar.com/products/libtorrent/docs.html#building-with-other-build-systems
3. Include all .c files in the zlib folder.
4. Add the following Additional Include Header Files::
"libtorrent\include"
"C:\Boost\include\boost-1_33_1"
"libtorrent\zlib"
"libtorrent\include\libtorrent"
5. Add the following Preprocessor Definitions::
WIN32
WIN32_LEAN_AND_MEAN
_WIN32_WINNT=0x0500
BOOST_ALL_NO_LIB
_FILE_OFFSET_BITS=64
BOOST_THREAD_USE_LIB
TORRENT_BUILDING_SHARED
TORRENT_LINKING_SHARED
UNICODE
6. Add ``C:\Boost\lib`` to Additional Library Directories
7. Add the following Additional Dependencies::
wsock32.lib
libboost_thread-vc80-mt.lib
libboost_filesystem-vc80-mt.lib
libboost_date_time-vc80-mt.lib
8. Set the Runtime Library to Multi-threaded Debug DLL (/MDd) under the code generation section.
Troubleshooting
...............
Error: error LNK2005:already defined etc...
Make sure you use the Multi-threaded Debug DLL (/MDd)
Error: error linking zlib related files...
Make sure to include all .c files in the zlib folder.
Runtime error in client_test.exe
If you're using boost-1.33.1, there is a bug in the program options
library which will make VS.NET 2005 assert. For a patch, see:
http://thread.gmane.org/gmane.comp.lib.boost.devel/140932/focus=140932