How can I force `build.rs` to run again without cleaning my whole project?

Question

How can I force build.rs to run again without cleaning my whole project? I checked cargo build --help but I couldn't find anything related to build.rs.

Answer 1

If build.rs changes, Cargo already rebuilds the project:

Note that if the build script itself (or one of its dependencies) changes, then it's rebuilt and rerun unconditionally, so cargo:rerun-if-changed=build.rs is almost always redundant (unless you want to ignore changes in all other files except for build.rs). doc

On Linux, I will just do touch build.rs && cargo build. For Windows, see Windows equivalent of the Linux command 'touch'?

Answer 2

Register build.rs as a crate's bin target:

1. Add this to your Cargo.toml file:

   [package]
   edition = "2018"
   build = "build.rs"
   
   [[bin]]
   name = "force-build"
   path = "build.rs"
   required-features = ["build_deps"]  # only needed for build-dependencies
   

2. If you have any [build-dependencies] (e.g. some_crate = "1.2.3"), you need to add those to (the main) [dependencies] (sadly no [bin-dependencies] as of yet), but you can make them optional:

   [dependencies]
   some_crate = { version = "1.2.3", optional = true }
   
   [features]
   build_deps = ["some_crate"]
   

Then you can run the build script with:

$ cargo run --bin force-build --features build_deps

(or $ cargo run --bin force-build when no [build-dependencies])

• You can even disable the automatic call of the build script by replacing the build = "build.rs" line in Cargo.toml with build = false

• Note: since the OUT_DIR env var is not present for bin targets, if your build.rs script uses env!("OUT_DIR"), you may "fix this" by using concat!(env!("CARGO_MANIFEST_DIR"), "/target/") instead.