3 releases
0.1.2 | Oct 15, 2023 |
---|---|
0.1.1 | Dec 20, 2022 |
0.1.0 | Oct 12, 2020 |
#290 in Cargo plugins
54 downloads per month
22KB
298 lines
cargo-vs • autogenerate visual studio solutions / projects
Quickstart
cd my-rust-project
cargo install cargo-vs
cargo vs2017
"%ProgramFiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\devenv.exe" vs\vs2017.sln
What's generated?
vs/.gitignore
since many/most projects don't want .vsode boilerplate checked in IME (although I always provide mine)
vs/vs2017.sln
vs/vs2017/*.vcsproj
- Makefile style projects which will invoke cargo +stable-%ARCH%-pc-windows-msvc build --target %ARCH%-pc-windows-msvc --package [package] [--bin|--example] [target] [--release]
Caveat: 32-bit (x86/Win32) builds require an i686 toolchain
When MSVC configures a build environment, rustc will pick up the %PATH%
provided link.exe
.
On the plus side, this means it should work for new VS versions rustc doesn't recognize.
On the minus side, this means that build.rs
and your target use the same linker, and must match architectures.
This could be "fixed" by clearing a bunch of environment variables, but...
Why makefile projects instead of .vs/*.vs.json?
- Easier to retrofit support for legacy Visual Studio versions
- Presumably easier to integrate into your existing C++/C# msbuild mess
- I can't figure out how to launch the graphics debugger with .vs/*
- Proper build matricies
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~1.1–2MB
~43K SLoC