RPM/Rust

Как быстро сделать Rust пакет с вендорингом

Вендоринг — сохранение внешних зависимостей вместе с исходным пакетом (в отличии от помещения их в отдельные пакеты и использования BuildRequires). Как завендорить растовые зависимости (в дире с пакетом):

$ cargo vendor
$ find vendor -name '*.a' -delete
$ git add -A -f vendor Cargo.lock
$ git commit -m "cargo vendor"

• cargo vendor - поместит все зависимости в диру vendor/, желательно, чтоб она была пустая.
• find - удалит бинарные библиотеки из виндовых зависимостей (winapi*). Ниже есть более сложный пример.
• git add -f - чтобы избежать возможных проблем с .gitignore.

В спеке:

BuildRequires: /proc
BuildRequires: rust-cargo

• /proc необходим для работы cargo.

В секции %prep после %setup:

mkdir -p .cargo
cat >> .cargo/config <<EOF
[source.crates-io]
replace-with = "vendored-sources"

[source.vendored-sources]
directory = "vendor"

[term]
verbose = true
quiet = false

[install]
root = "%buildroot%_prefix"

[build]
rustflags = ["-Copt-level=3", "-Cdebuginfo=1"]

[profile.release]
strip = false
EOF

• эта конструкция подключит вендореные исходники, настроит опции сборки и инсталляции.

В %build:

cargo build %_smp_mflags --offline --release

В %install (если пакет не библиотека, а бинарник):

cargo install %_smp_mflags --offline --no-track --path .

В %check, если нужен:

cargo test %_smp_mflags --release --no-fail-fast

Полезные советы

• Более глубокая очистка от бинарных артефактов:

find vendor/ \( -name '*.a' -o -name '*.lib' -o -name '*.dll' -o -name '*.obj' \) -delete
sed -Ei 's!,"[^"]+\.(a|lib|dll|obj)":"[^"]+"!!g' $(find vendor -name .cargo-checksum.json)

Такая чистка часто ломает rustix, что решается включением use-libc feature (например добавлением при сборке к rustflags --cfg=rustix_use_libc) или включением cc feature — пример как это выглядит в Cargo.toml:

[dependencies]
rustix = { features = ["cc"] }

Нужно учитывать, что использование переменой окружения RUSTFLAGS отменяет значение build.rustflags из созданного выше .cargo (в этом случае отключится оптимизация и debuginfo). Поэтому надо добавлять новые опции в .cargo:

rustflags = ["-Copt-level=3", "-Cdebuginfo=1", "--cfg=rustix_use_libc"]

• Решение проблем с windows/unix кодировкой текстовых файлов:

grep -sq -w 'text' .gitattributes && echo '* -text' > vendor/.gitattributes

• Часто cargo install начинает пересобирать исходники, поэтому лучше делать обычный install:

install -Dp target/release/%name -t %buildroot%_bindir

• Сборка упала на 32-битных архитектурах с LLVM ERROR: out of memory Allocation failed. Возможно, апстрим включил излишнюю оптимизацию в Cargo.toml. Её можно перекрыть в создаваемом выше .cargo (в зависимости от того что было включено), например:

[profile.release]
lto = "thin"
codegen-units = 16

Сборка через etersoft-build-utils

В etersoft-build-utils предусмотрена автоматизация обновления в git-репозитории пакетов rust, требуемых для сборки. Подробности здесь: https://www.altlinux.org/Etersoft-build-utils/extra_sources

Ссылки

• https://doc.rust-lang.org/cargo/reference/config.html The Cargo Book
• https://nnethercote.github.io/perf-book/build-configuration.html The Rust Performance Book