ビルドスクリプト

時々、デフォルトのcargoのビルドでは不十分な場合があります。おそらくそれはcargoが コンパイルを成功するのにコード生成、他のファイルのコンパイルなどを事前にしなければ いけないときでしょう。この問題を解決するために、Cargoではビルドスクリプトが実行できます。

Cargo.tomlに以下のような行を加えると、ビルドスクリプトが追加できます。

[package]
...
build = "build.rs"

デフォルトでCargoはプロジェクトディレクトリのbuild.rsファイルがあれば、 実行します。

ビルドスクリプトの使い方

ビルドスクリプトは単純にはじめにコンパイルされ、パッケージ内の他のものをコンパイルする Rustファイルです。これによってクレートの事前要件を満たすことができます。

Cargoはここで指定された環境変数を入力として実行されるスクリプトをいくつか提供しています。

また、スクリプトは標準出力を介して出力し、target/debug/build/<pkg>/outputにすべての 出力が書き込まれます。さらに、cargo:で始まる行はCargoに解析され、パッケージをコンパイル するときのひきすうとして使われます。

さらなる仕様やサンプルについてはCargoのドキュメントを参照してください。