Skip to content

Commit

Permalink
Add a note not to add Qt to the PATH on windows
Browse files Browse the repository at this point in the history
  • Loading branch information
LeonMatthesKDAB committed Nov 17, 2023
1 parent 1e0d2c7 commit 856c011
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions book/src/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,17 @@ Make sure to select and install a version of Qt 6.
Then add the installation directory to your `PATH` environment variable and make sure `qmake` is in your `PATH` by running `qmake --version`.
You may have to restart your terminal for this to work correctly.

> Note that on Windows the Qt installation usually shouldn't be in your system path.
> That may cause issues with other programs that link to Qt dynamically.
>
> CXX-Qt still needs to be able to find the `qmake` executable however.
> A good compromise is to create a development environment which either temporarily
> adds the Qt installation in the PATH or assigns the `QMAKE` environment variable
> to point to the correct `qmake` executable.
>
> If this is too much trouble to set up you can always fall back to providing the
> `QMAKE` environment variable each time you execute `cargo build` or `cargo run`.
### MacOS

Preferrably install Qt using the [Qt online installer][qt-installer].
Expand Down

0 comments on commit 856c011

Please sign in to comment.