Change step 7. to refer to VCVARS.

Also adds a note about the `CPAL_ASIO_SDK` environment variable
determining whether or not cpal will attempt to build ASIO and generate
bindings to it.
This commit is contained in:
mitchmindtree 2018-11-07 15:34:13 +07:00
parent 0ff0b65647
commit b70e27ed87
1 changed files with 15 additions and 9 deletions

View File

@ -44,6 +44,8 @@ WASAPI. To do so, follow these steps:
3. Assign the full path of the `ASIOSDK2.3.1` directory to the `CPAL_ASIO_DIR` 3. Assign the full path of the `ASIOSDK2.3.1` directory to the `CPAL_ASIO_DIR`
environment variable. [How to set persisting Environment Variables on environment variable. [How to set persisting Environment Variables on
Windows](https://gist.github.com/mitchmindtree/92c8e37fa80c8dddee5b94fc88d1288b#file-windows_environment_variables-md). Windows](https://gist.github.com/mitchmindtree/92c8e37fa80c8dddee5b94fc88d1288b#file-windows_environment_variables-md).
The existence of the `CPAL_ASIO_DIR` environment variable determines whether
or not CPAL will attempt to build the ASIO SDK and generate bindings to it.
4. **Download and install LLVM** from 4. **Download and install LLVM** from
[here](http://releases.llvm.org/download.html) under the "Pre-Built Binaries" [here](http://releases.llvm.org/download.html) under the "Pre-Built Binaries"
section. The version as of writing this is 7.0.0. section. The version as of writing this is 7.0.0.
@ -57,15 +59,19 @@ WASAPI. To do so, follow these steps:
and install ASIO4ALL**](http://www.asio4all.org/). Be sure to enable the and install ASIO4ALL**](http://www.asio4all.org/). Be sure to enable the
"offline" feature during installation despite what the installer says about "offline" feature during installation despite what the installer says about
it being useless. it being useless.
7. **Use the correct command prompt** to build cpal and run examples. In my 7. **Loading VCVARS**. `rust-bindgen` uses the C++ tool-chain when generating
case, I had to run a specific command prompt, otherwise rust-bindgen would bindings to the ASIO SDK. As a result, it is necessary to load some
fail to find some of the necessary build tools. To do this, I went to the environment variables in the command prompt that we use to build our project.
`Start Menu > Visual C++ Build Tools > Visual C++ 2015 x64 Native Build Tools On 64-bit machines run:
Command Prompt` and ran this prompt. The exact prompt you need might differ ```
based on your machine's architecture and how you installed your Visual C++ "C:\Program Files (x86)Microsoft Visual Studio 14.0VC\vcvarsall" amd64
tools. There must be an easier solution to this (especially as not everyone ```
wants to build projects from the command line). On 32-bit machines run:
8. Select ASIO as the backend at the start of our program with the following: ```
"C:\Program Files (x86)Microsoft Visual Studio 14.0VC\vcvarsall" x86
```
8. Select ASIO as the backend at the start of our program with the following
code:
```rust ```rust
#[cfg(target_os = "windows")] #[cfg(target_os = "windows")]