Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 1 | Installation Instructions for Windows |
| 2 | ************************************* |
| 3 | |
Chris Dickens | 178e433 | 2020-08-18 10:07:46 -0700 | [diff] [blame] | 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). |
Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 6 | |
| 7 | If you are using Microsoft Visual Studio: |
| 8 | - Open the relevant solution file in /msvc: |
Chris Dickens | f90d076 | 2020-01-20 18:02:19 -0800 | [diff] [blame] | 9 | libusb_2013.sln for Visual Studio 2013, |
| 10 | libusb_2015.sln for Visual Studio 2015, |
Chris Dickens | 178e433 | 2020-08-18 10:07:46 -0700 | [diff] [blame] | 11 | libusb_2017.sln for Visual Studio 2017, |
| 12 | libusb_2019.sln for Visual Studio 2019 or later. |
Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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 | |
NancyLi1013 | be57525 | 2020-04-17 01:52:28 -0700 | [diff] [blame] | 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 | |
Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 32 | Destination directories |
| 33 | *********************** |
| 34 | |
Chris Dickens | 28630ad | 2020-01-21 15:39:34 -0800 | [diff] [blame] | 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. |
Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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. |
Chris Dickens | 28630ad | 2020-01-21 15:39:34 -0800 | [diff] [blame] | 44 | If needed, these libraries can be obtained by installing the latest Windows |
| 45 | SDK. |
Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 46 | |
Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 47 | Links |
| 48 | ***** |
| 49 | |
| 50 | Additional information related to the Windows backend: |
hjelmn@cs.unm.edu | 1eff220 | 2014-01-08 23:50:34 +0000 | [diff] [blame] | 51 | http://windows.libusb.info |