Cargo活用

Rustのビルドツール「Cargo」の高度な機能を学びます。

Cargo.tomlの詳細

基本構造

[package]
name = "my_app"
version = "0.1.0"
edition = "2021"
authors = ["Your Name <you@example.com>"]
description = "My awesome application"
license = "MIT"

[dependencies]
serde = "1.0"

[dev-dependencies]
criterion = "0.4"

[build-dependencies]
cc = "1.0"

バージョン指定

[dependencies]
# 完全一致
exact = "=1.0.0"

# キャレット（デフォルト）: 互換性のある最新
caret = "1.0"      # >=1.0.0, <2.0.0
caret2 = "1.0.0"   # >=1.0.0, <2.0.0

# チルダ: マイナーバージョンまで固定
tilde = "~1.0"     # >=1.0.0, <1.1.0

# ワイルドカード
wildcard = "1.*"   # >=1.0.0, <2.0.0

# 範囲
range = ">=1.0, <2.0"

Features（機能フラグ）

依存クレートのfeatures

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

# または一部のみ
tokio = { version = "1", features = ["rt", "net", "io-util"] }

自分のクレートにfeatures定義

[features]
default = ["json"]
json = ["dep:serde_json"]
yaml = ["dep:serde_yaml"]
full = ["json", "yaml"]

[dependencies]
serde_json = { version = "1.0", optional = true }
serde_yaml = { version = "0.9", optional = true }

#![allow(unused)]
fn main() {
#[cfg(feature = "json")]
pub fn parse_json(s: &str) -> Result<Value, Error> {
    serde_json::from_str(s)
}
}

ビルドプロファイル

dev（開発用）

[profile.dev]
opt-level = 0      # 最適化なし
debug = true       # デバッグ情報あり

release（本番用）

[profile.release]
opt-level = 3      # 最大最適化
debug = false      # デバッグ情報なし
lto = true         # リンク時最適化

カスタムプロファイル

[profile.bench]
opt-level = 3
debug = true

[profile.profiling]
inherits = "release"
debug = true

ワークスペース

複数のクレートをまとめて管理します。

my_workspace/
├── Cargo.toml        # ワークスペースルート
├── app/
│   ├── Cargo.toml
│   └── src/
├── lib_core/
│   ├── Cargo.toml
│   └── src/
└── lib_utils/
    ├── Cargo.toml
    └── src/

ルートCargo.toml

[workspace]
members = ["app", "lib_core", "lib_utils"]

app/Cargo.toml

[package]
name = "app"
version = "0.1.0"

[dependencies]
lib_core = { path = "../lib_core" }
lib_utils = { path = "../lib_utils" }

便利なCargoコマンド

Cargo.lock

依存関係の正確なバージョンを記録します。

• ライブラリ: .gitignoreに入れる（利用者が決める）
• アプリケーション: コミットする（再現性のため）

環境変数

// ビルド時の情報
const VERSION: &str = env!("CARGO_PKG_VERSION");
const NAME: &str = env!("CARGO_PKG_NAME");

fn main() {
    println!("{} v{}", NAME, VERSION);
}

まとめ

確認テスト

次のドキュメント: 02_crate_ecosystem.md