core: set default backend options before calling backend init
[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 which is automatically generated by autotools (e.g. running bootstrap.sh).
6
7 If you are using Microsoft Visual Studio:
8 - Open the relevant solution file in /msvc:
9   libusb_2013.sln for Visual Studio 2013,
10   libusb_2015.sln for Visual Studio 2015,
11   libusb_2017.sln for Visual Studio 2017,
12   libusb_2019.sln for Visual Studio 2019 or later.
13 - If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
14   in msvc\config.h
15 - Select your configuration and compile the project
16
17 Installing and building libusb via vcpkg
18 ****************************************
19
20 You can download and install libusb using the vcpkg dependency manager:
21
22     git clone https://github.com/Microsoft/vcpkg.git
23     cd vcpkg
24     ./bootstrap-vcpkg.bat
25     ./vcpkg integrate install
26     vcpkg install libusb
27
28 The libusb port in vcpkg is kept up to date by Microsoft team members and
29 community contributors. If the version is out of date, please create an issue
30 or pull request (https://github.com/Microsoft/vcpkg) on the vcpkg repository.
31
32 Destination directories
33 ***********************
34
35 The 32-bit binaries are placed in a Win32\ directory at the root of the
36 library.
37 The 64-bit binaries are placed in a 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 the latest Windows
45 SDK.
46
47 Links
48 *****
49
50 Additional information related to the Windows backend:
51   http://windows.libusb.info