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