Skip to content

Commit

Permalink
Add Troubleshooting: Unable to debug dynamically linked Bevy applicat…
Browse files Browse the repository at this point in the history
…ion in VSCode (#746)

Co-authored-by: alexmadeathing <[email protected]>
  • Loading branch information
alexmadeathing and alexmadeathing authored Oct 9, 2023
1 parent 0d62320 commit 201f416
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 additions & 0 deletions content/learn/book/troubleshooting/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,32 @@ Causes include:

1. Vulkan-compatible drivers not installed. To fix this, install/update the drivers. On Linux this may be `vulkan-intel` or `vulkan-radeon`.
2. Trying to run an example on a headless machine. To fix this, install a GPU!

## Unable to debug dynamically linked Bevy application in VSCode on Windows

```txt
The program '[10184] my-game.exe' has exited with code -1073741515 (0xc0000135).
```

Whilst `cargo run` may load the application successfully, running via the debugging UI in VSCode may yield the above error. This error means
that the required libraries were not loaded correctly (likely due to a pathing quirk with VSCode debug extensions on Windows).

Edit your launch configurations in `.vscode/launch.json` so that the rust libraries are found correctly.

For `cppvsdbg`:

```json
"environment": [
{"name":"PATH", "value":"%USERPROFILE%/.rustup/toolchains/nightly-x86_64-pc-windows-msvc/bin;${workspaceFolder}/target/debug/deps;%PATH%"}
// Switch `nightly` to `stable` if you're using Rust stable
],
```

Or for `codelldb`:

```json
"env": {
"PATH": "${env:USERPROFILE}/.rustup/toolchains/nightly-x86_64-pc-windows-msvc/bin;${workspaceFolder}/target/debug/deps;${env:PATH}",
// Switch `nightly` to `stable` if you're using Rust stable
},
```

0 comments on commit 201f416

Please sign in to comment.