Сочетания клавиш

Нажмите ← или → для навигации между главами

Нажмите S или / для поиска по книге

Нажмите ? для отображения этой справки

Нажмите Esc, чтобы скрыть эту справку

Настройка сборок с помощью профилей релиза

В Rust профили релиза — это предопределённые настраиваемые профили с различными конфигурациями, которые позволяют программисту получить больше контроля над различными параметрами компиляции кода. Каждый профиль настраивается независимо от других.

Cargo имеет два основных профиля: профиль dev, который Cargo использует при запуске cargo build, и профиль release, который Cargo использует при запуске cargo build --release. Профиль dev определён с хорошими значениями по умолчанию для разработки, а профиль release имеет хорошие значения по умолчанию для релизных сборок.

Эти имена профилей могут быть знакомы по выводу ваших сборок:

$ cargo build
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.00s
$ cargo build --release
    Finished `release` profile [optimized] target(s) in 0.32s

dev и release — это разные профили, используемые компилятором.

Cargo имеет настройки по умолчанию для каждого из профилей, которые применяются, когда вы явно не добавили никаких секций [profile.*] в файл Cargo.toml проекта. Добавляя секции [profile.*] для любого профиля, который хотите настроить, вы переопределяете любое подмножество настроек по умолчанию. Например, вот значения по умолчанию для параметра opt-level для профилей dev и release:

Имя файла: Cargo.toml

[profile.dev]
opt-level = 0

[profile.release]
opt-level = 3

Параметр opt-level управляет количеством оптимизаций, которые Rust применит к вашему коду, в диапазоне от 0 до 3. Применение большего количества оптимизаций увеличивает время компиляции, поэтому если вы находитесь в процессе разработки и часто компилируете код, вам нужно меньше оптимизаций для более быстрой компиляции, даже если результирующий код работает медленнее. Поэтому opt-level по умолчанию для dev равен 0. Когда вы готовы выпустить код, лучше потратить больше времени на компиляцию. Вы будете компилировать в режиме release только один раз, но запускать скомпилированную программу много раз, поэтому режим release обменивает более длительное время компиляции на более быстрый код. Именно поэтому opt-level по умолчанию для профиля release равен 3.

Вы можете переопределить настройку по умолчанию, добавив для неё другое значение в Cargo.toml. Например, если мы хотим использовать уровень оптимизации 1 в профиле разработки, мы можем добавить эти две строки в файл Cargo.toml нашего проекта:

Имя файла: Cargo.toml

[profile.dev]
opt-level = 1

Этот код переопределяет настройку по умолчанию 0. Теперь, когда мы запустим cargo build, Cargo будет использовать значения по умолчанию для профиля dev плюс нашу настройку opt-level. Поскольку мы установили opt-level в 1, Cargo применит больше оптимизаций, чем по умолчанию, но не столько, сколько при релизной сборке.

Полный список параметров конфигурации и значений по умолчанию для каждого профиля см. в документации Cargo.