Özellikler (features)

Cargo features ile koşullu derleme yapmayı öğrenirsin.

Özellikler (features)

Feature'lar, bir crate'in isteğe bağlı parçalarını açıp kapatmayı sağlar. Kullanılmayan kod derlenmez, böylece derleme süresi ve ikili boyutu küçülür:

# Cargo.toml
[features]
default = ["metin"]
metin = []
json = ["dep:serde_json"]

[dependencies]
serde_json = { version = "1", optional = true }

Kullanan taraf seçer: fatura = { version = "1", features = ["json"] } ya da komut satırında cargo build --features json.

Koşullu derleme

Kodda feature'lara #[cfg(..)] özniteliği ya da cfg!(..) makrosuyla bakılır:

#[cfg(feature = "json")]
pub fn json_yaz(..) { .. }       // yalnızca json açıksa derlenir

fn bicim() -> &'static str {
    if cfg!(feature = "json") { "json" } else { "metin" }
}

#[cfg] öğeyi tamamen kaldırır; cfg! ise derleme anında true/false olan bir ifadedir, iki dal da derlenmek zorundadır. Aynı mekanizma işletim sistemi için de kullanılır: #[cfg(target_os = "windows")].

Uygulama Biçim seçimi

cfg!(feature = "json") ile "json" ya da "metin" döndüren fn bicim() -> &'static str yaz ve sonucu biçim: ... olarak yazdır. Alıştırma ortamında hiçbir feature açık değildir.

Örnek çözümü göster

fn bicim() -> &'static str {
    if cfg!(feature = "json") {
        "json"
    } else {
        "metin"
    }
}

fn main() {
    println!("biçim: {}", bicim());
}

Kendini test et

Feature'lar neden yalnızca <strong>eklemeli</strong> (additive) olmalıdır?
- Gerekmez
- Bağımlılık ağacında iki crate farklı feature isterse Cargo hepsini birleştirir; bir feature diğerini bozmamalı
- Derleyici kuralı
- Performans için
Cevabı göster

Bağımlılık ağacında iki crate farklı feature isterse Cargo hepsini birleştirir; bir feature diğerini bozmamalı — Bir feature açıldığında API'den bir şey kaldırmak ya da davranışı tersine çevirmek, başka bir kullanıcının derlemesini kırabilir.

Koşullu öğe

#[____(feature = "json")]
pub fn json_yaz() {}

Cevabı göster

#[cfg(feature = "json")]
pub fn json_yaz() {}

Yazım ve anlamı

default = ["metin"]

Varsayılan açık
optional = true

İsteğe bağlı bağımlılık
#[cfg(feature = "x")]

Koşullu öğe
cfg!(feature = "x")

Derleme anı bool

Sıradaki ders: Workspace

Deneyiminizi Geliştiriyoruz

Çerez Tercihleri

Kesinlikle Gerekli Çerezler

Analitik Çerezler