4 releases
Uses old Rust 2015
0.2.2 | Feb 26, 2021 |
---|---|
0.2.1 | Jul 18, 2018 |
0.2.0 | Jul 1, 2018 |
0.1.0 | Oct 20, 2017 |
#295 in Build Utils
1,195 downloads per month
Used in 6 crates
16KB
275 lines
windres-rs
windres
is a Rust library crate for compiling Windows resource (.rc) files into object
files at build time, which are then forwarded to the linker. This allows for embedding icons,
version information, native UI data, etc. in binaries compiled from Rust code.
Example
The following example demonstrates how to embed an icon in a binary crate:
// hello-world.rc
1 ICON "hello-world.ico"
// build.rs
extern crate windres;
use windres::Build;
fn main() {
Build::new().compile("hello-world.rc").unwrap();
}
Usage
You need to install the resource compiler for your target ABI in order for windres
to work.
Currently the following compilers are supported:
windres.exe
for GNU targets (included in the mingw-w64 toolchain)rc.exe
for MSVC targets (included in the Windows SDK, which can be installed via Visual Studio Installer)
Once the appropriate resource compiler is installed, add windres
as a build dependency in
Cargo.toml
:
[target.'cfg(windows)'.build-dependencies]
windres = "0.2"
Then, create a build script (if you haven't already) and add a reference to windres
:
#[cfg(windows)]
extern crate windres;
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
~0–325KB