blob: 3ee364d25fa5e2ee122e88a46c9c09479570feb2 [file] [log] [blame]
Pete Batard75b1cf82012-05-10 16:44:30 +01001Installation Instructions for Windows
2*************************************
3
Chris Dickens178e4332020-08-18 10:07:46 -07004If you are compiling for MinGW or cygwin, please refer to the INSTALL file,
5which is automatically generated by autotools (e.g. running bootstrap.sh).
Pete Batard75b1cf82012-05-10 16:44:30 +01006
7If you are using Microsoft Visual Studio:
8- Open the relevant solution file in /msvc:
Chris Dickensf90d0762020-01-20 18:02:19 -08009 libusb_2013.sln for Visual Studio 2013,
10 libusb_2015.sln for Visual Studio 2015,
Chris Dickens178e4332020-08-18 10:07:46 -070011 libusb_2017.sln for Visual Studio 2017,
12 libusb_2019.sln for Visual Studio 2019 or later.
Pete Batard75b1cf82012-05-10 16:44:30 +010013- 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
NancyLi1013be575252020-04-17 01:52:28 -070017Installing and building libusb via vcpkg
18****************************************
19
20You 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
28The libusb port in vcpkg is kept up to date by Microsoft team members and
29community contributors. If the version is out of date, please create an issue
30or pull request (https://github.com/Microsoft/vcpkg) on the vcpkg repository.
31
Pete Batard75b1cf82012-05-10 16:44:30 +010032Destination directories
33***********************
34
Chris Dickens28630ad2020-01-21 15:39:34 -080035The 32-bit binaries are placed in a Win32\ directory at the root of the
36library.
37The 64-bit binaries are placed in a x64\ directory.
Pete Batard75b1cf82012-05-10 16:44:30 +010038
39Troubleshooting
40***************
41
42If the compilation process complains about missing libraries, ensure that the
43default library paths for your project points to the relevant directories.
Chris Dickens28630ad2020-01-21 15:39:34 -080044If needed, these libraries can be obtained by installing the latest Windows
45SDK.
Pete Batard75b1cf82012-05-10 16:44:30 +010046
Pete Batard75b1cf82012-05-10 16:44:30 +010047Links
48*****
49
50Additional information related to the Windows backend:
hjelmn@cs.unm.edu1eff2202014-01-08 23:50:34 +000051 http://windows.libusb.info