Add vcpkg installation instructions
[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 Installing and building libusb via vcpkg
16 ****************************************
17
18 You can download and install libusb using the vcpkg dependency manager:
19
20     git clone https://github.com/Microsoft/vcpkg.git
21     cd vcpkg
22     ./bootstrap-vcpkg.bat
23     ./vcpkg integrate install
24     vcpkg install libusb
25
26 The libusb port in vcpkg is kept up to date by Microsoft team members and
27 community contributors. If the version is out of date, please create an issue
28 or pull request (https://github.com/Microsoft/vcpkg) on the vcpkg repository.
29
30 Destination directories
31 ***********************
32
33 The 32-bit binaries are placed in a Win32\ directory at the root of the
34 library.
35 The 64-bit binaries are placed in a x64\ directory.
36
37 Troubleshooting
38 ***************
39
40 If the compilation process complains about missing libraries, ensure that the
41 default library paths for your project points to the relevant directories.
42 If needed, these libraries can be obtained by installing the latest Windows
43 SDK.
44
45 Links
46 *****
47
48 Additional information related to the Windows backend:
49   http://windows.libusb.info
50
51 Microsoft Windows SDK Archive:
52   https://developer.microsoft.com/en-us/windows/downloads/sdk-archive