28 stable releases

Uses old Rust 2015

1.7.2 Mar 31, 2022
1.6.5 Oct 21, 2021
1.6.3 Jun 13, 2021
1.6.1 Feb 17, 2021
0.1.2 Jan 31, 2017

#16 in Development tools

Download history 7186/week @ 2022-01-28 6088/week @ 2022-02-04 7127/week @ 2022-02-11 7870/week @ 2022-02-18 7801/week @ 2022-02-25 8840/week @ 2022-03-04 9054/week @ 2022-03-11 8181/week @ 2022-03-18 9005/week @ 2022-03-25 7555/week @ 2022-04-01 6339/week @ 2022-04-08 5551/week @ 2022-04-15 5556/week @ 2022-04-22 7297/week @ 2022-04-29 7271/week @ 2022-05-06 6648/week @ 2022-05-13

27,714 downloads per month
Used in 21 crates (19 directly)

MIT license

30KB
409 lines

rust-embed-resource TravisCI build status AppVeyorCI build status Licence Crates.io version

A Cargo build script library to handle compilation and inclusion of Windows resources in the most resilient fashion imaginable

Documentation

Quickstart

In your build script, assuming the resource file is called checksums.rc:

extern crate embed_resource;

fn main() {
    // Compile and link checksums.rc
    embed_resource::compile("checksums.rc");

    // Or, to select a resource file for each binary separately
    embed_resource::compile_for("assets/poke-a-mango.rc", &["poke-a-mango", "poke-a-mango-installer"]);
    embed_resource::compile_for("assets/uninstaller.rc", &["unins001"]);
}

Example: Embedding a Windows Manifest

Courtesy of @jpoles1.

The following steps are used to embed a manifest in your compiled rust .exe file. In this example the manifest will cause admin permissions to be requested for the final executable:

  1. Add the following to your cargo.toml:
[build-dependencies]
embed-resource = "1.7"
  1. In your project root directory, add a file named build.rs with the following:
extern crate embed_resource;
fn main() {
    embed_resource::compile("app-name-manifest.rc");
}
  1. In your project root directory, add a file named app-name-manifest.rc with the following:
#define RT_MANIFEST 24
1 RT_MANIFEST "app-name.exe.manifest"
  1. In your project root directory, add a file named app-name.exe.manifest with the following:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
        <security>
            <requestedPrivileges>
                <requestedExecutionLevel level="requireAdministrator" uiAccess="false"/>
            </requestedPrivileges>
        </security>
    </trustInfo>
</assembly>
  1. Build your project!

Credit

In chronological order:

@liigo -- persistency in pestering me and investigating problems where I have failed

@mzji -- MSVC lab rat

@TheCatPlusPlus -- knowledge and providing first iteration of manifest-embedding code

@azyobuzin -- providing code for finding places where RC.EXE could hide

@retep998 -- fixing MSVC support

@SonnyX -- Windows cross-compilation support and testing

@MSxDOS -- finding and supplying RC.EXE its esoteric header include paths

@roblabla -- cross-compilation to Windows MSVC via LLVM-RC

Special thanks

To all who support further development on Patreon, in particular:

  • ThePhD
  • Embark Studios
  • Jasper Bekkers

Dependencies

~415–650KB
~14K SLoC