windows: Restore behaviour of skipping malformed device GUIDs
[libusb.git] / INSTALL_WIN.txt
blob802e29a43573fd2f70aae37e782d9a547b09f222
1 Installation Instructions for Windows
2 *************************************
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).
7 If you are using Microsoft Visual Studio:
8 - Using Visual Studio 2022, open /msvc/libusb.sln
9 - If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
10   in msvc/config.h
11 - Select your configuration and compile the project.
12 - To target a specific toolset (previous version of Visual Studio), either
13   edit PlatformToolset in /msvc/Configuration.Base.props, or supply the value
14   to msbuild on the command line.
15 - For example, to build for VS2015 (from a different version):
16   msbuild -p:PlatformToolset=v140,Platform=x64,Configuration=Release libusb.sln
18 Installing and building libusb via vcpkg
19 ****************************************
21 You can download and install libusb using the vcpkg dependency manager:
23     git clone https://github.com/Microsoft/vcpkg.git
24     cd vcpkg
25     ./bootstrap-vcpkg.bat
26     ./vcpkg integrate install
27     vcpkg install libusb
29 The libusb port in vcpkg is kept up to date by Microsoft team members and
30 community contributors. If the version is out of date, please create an issue
31 or pull request (https://github.com/Microsoft/vcpkg) on the vcpkg repository.
33 Destination directories
34 ***********************
36 The binaries are located at:
37 /build/<PlatformToolset>/<Platform>/<Configuration>/(lib|dll)/libusb-1.0.(lib|dll)
38 For example: /build/v143/x64/Release/dll/libusb-1.0.dll
40 Troubleshooting
41 ***************
43 If the compilation process complains about missing libraries, ensure that the
44 default library paths for your project points to the relevant directories.
45 If needed, these libraries can be obtained by installing the latest Windows
46 SDK.
48 Links
49 *****
51 Additional information related to the Windows backend:
52   http://windows.libusb.info