Скриптове за построяване

Понякога обикновеното построяване с cargo не стига. Може би е нужна някаква предварителна подготовка, преди cargo да може да компилира всичко успешно. Например създаване на обособен програмен код или нещо трябва да се компилира отделно. За справяне с такива случаи Cargo може да изпълни написани от вас скриптове за построяване.

За да добавите такъв скрипт към вашия пакет, можете да го укажете в Cargo.toml както следва:

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

Иначе Cargo по подразбиране ще търси скрипт с име build.rs в директорията на проекта.

Как се ползва скрипт за построяване

Скриптът е просто файл с код на Ръждьо, който ще бъде компилиран и извикан преди всичко друго в пакета. Сиреч, може да бъде използван за създаване на нужните предпоставки за успешно построяване на вашия кош.

Cargo предоставя входни данни на скрипта чрез променливи на обкръжението. Те са описани в „The Cargo Book” (Environment variables Cargo sets for crates).

Скриптът предоставя изходни данни чрез стандартния изход (stdout). Всички отпечатани редове биват записани в target/debug/build/<pkg>/output. Редовете, започващи с cargo:, ще бъдат ползвани пряко от Cargo и така можете да задавате параметри за компилирането на пакета.

За повече подробности и примери прегледайте Cargo specification.