readme.md

cppwinrt

Run the bundled C++/WinRT compiler from a Rust build. Use it when the build also compiles C++ that consumes or implements WinRT types; use windows-bindgen for Rust. The bundled compiler runs on Windows.

• 📦 crates.io
• 📖 docs.rs
• 📁 Source

Generate headers

[build-dependencies]
cppwinrt = "0.100"

In build.rs, pass your component metadata and a build-owned output directory:

use std::{ffi::OsStr, path::PathBuf};

fn main() {
    println!("cargo:rerun-if-changed=component.winmd");
    let output = PathBuf::from(std::env::var_os("OUT_DIR").unwrap()).join("include");
    cppwinrt::cppwinrt([
        OsStr::new("-in"),
        OsStr::new("component.winmd"),
        OsStr::new("-out"),
        output.as_os_str(),
    ]);
}

Add reference metadata inputs required by the component, then add the output directory to your C++ compiler's include paths. Compile and link C++ sources separately, with Cargo rerun directives for those inputs too.

cppwinrt(["-help"]) lists the bundled compiler's options. The wrapper returns standard output on success and panics on failure, stopping the build.

The robot C++ component and C++ client show the complete pipeline.