Windows: Remove support for WinCE and Visual Studio older than 2013
[platform/upstream/libusb.git] / INSTALL_WIN.txt
1 Installation Instructions for Windows
2 *************************************
3
4 If you are compiling for MinGW or cygwin, please refer to the INSTALL file.
5
6 If you are using Microsoft Visual Studio:
7 - Open the relevant solution file in /msvc:
8   libusb_2013.sln for Visual Studio 2013,
9   libusb_2015.sln for Visual Studio 2015,
10   libusb_2017.sln for Visual Studio 2017 or later.
11 - If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
12   in msvc\config.h
13 - Select your configuration and compile the project
14
15 Note that if you are using Visual Studio Express, you may have to install the
16 Windows SDK to be able to compile the 64 bit version of the library.
17
18 If you are using the freely available Windows DDK/WDK (Driver Development Kit)
19 - If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
20   in msvc\config.h
21 - Open one of the relevant Free Build or Checked Build prompt for your target
22   platform
23 - Navigate to the msvc\ directory where the ddk_build.cmd file is located, and
24   run 'ddk_build'
25 - To produce a DLL rather than a static library, use: 'ddk_build DLL'
26 - To produce a static library that uses LIBCMT[d] instead of MSVCRT[d] (/MT[d]
27   vs /MD[d] in Visual Studio) use: 'ddk_build /MT'
28
29 Note that using the Windows DDK, it is possible to compile both the 32 and 64
30 bit versions of the library.
31
32 Destination directories
33 ***********************
34
35 The 32 bit binaries compiled either from Visual Studio or the DDK are placed in
36 a Win32\ directory at the root of the library
37 The 64 bit binaries are placed in an x64\ directory
38
39 Troubleshooting
40 ***************
41
42 If the compilation process complains about missing libraries, ensure that the
43 default library paths for your project points to the relevant directories.
44 If needed, these libraries can be obtained by installing either the latest
45 Windows SDK or the DDK (Links provided at the end of this file).
46
47 Links
48 *****
49
50 Additional information related to the Windows backend:
51   http://windows.libusb.info
52
53 Latest Windows Driver (Development) Kit (WDK):
54   http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=36a2630f-5d56-43b5-b996-7633f2ec14ff
55
56 Latest Microsoft Windows SDK:
57   http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=c17ba869-9671-4330-a63e-1fd44e0e2505