Rust · Avançado · Inglês · Técnico
build script
Arquivo build.rs na raiz do pacote, compilado e executado pelo Cargo antes do build principal. Gera código, compila dependências em C ou informa flags ao compilador.
Onde usar
Aparece em crates que ligam com bibliotecas nativas, via cc ou bindgen. A comunicação com o Cargo é feita por linhas impressas, como cargo::rustc-cfg.
Em código
// build.rs, na raiz do projeto
fn main() {
println!("cargo::rustc-cfg=tem_extra");
}
// no código: #[cfg(tem_extra)]Exemplos
The build script compiles the C sources.
O build script compila os fontes em C.
Add rerun-if-changed to the build script.
Adicione rerun-if-changed ao build script.
Cuidado
Aumenta o tempo de compilação e roda com os privilégios do usuário; use rerun-if-changed para não repetir o trabalho à toa.
Sinônimos
build.rs