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

This change adds a troubleshooting section including a workaround for bevyengine/bevy#2589
  • Loading branch information
alexmadeathing committed Sep 25, 2023
1 parent 34bfd89 commit 95560bb
Showing 1 changed file with 27 additions and 0 deletions.
27 changes: 27 additions & 0 deletions content/learn/book/troubleshooting/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,30 @@ 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

```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).

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:RUSTUP_HOME}/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 95560bb

Please sign in to comment.