cargo adk build

Présentation

La commande cargo adk build compile votre projet d’agent ADK-Rust sans le déployer. Elle vous permet de vérifier rapidement que votre agent se compile correctement — en détectant les problèmes de dépendances, les erreurs de type et les problèmes de configuration — avant de lancer un cycle de déploiement complet.

Utilisez cargo adk build dans le cadre de votre workflow de développement local et de vos pipelines CI afin de valider rapidement les modifications, sans avoir besoin d’identifiants de plateforme ni d’un accès réseau.

Syntaxe de la commande

cargo adk build [OPTIONS]

La commande encapsule cargo build --release par défaut, en ciblant votre projet d’agent. En cas de réussite, elle indique le profil de compilation, le répertoire cible et la taille du binaire.

Indicateurs et options

Exemples

# Build in release mode (default)
cargo adk build

# Build in debug mode for faster iteration
cargo adk build --debug

# Build a project at a specific path
cargo adk build --manifest-path /path/to/my-agent/Cargo.toml

Compilation vs Déploiement

cargo adk build et cargo adk deploy servent des objectifs différents dans le cycle de développement des agents :

Quand utiliser chaque commande

• cargo adk build — À utiliser pendant le développement pour vérifier la compilation, dans les pipelines CI comme contrôle avant la fusion, ou pour vérifier que les mises à jour des dépendances ne cassent pas votre agent.
• cargo adk deploy — À utiliser lorsque vous êtes prêt à déployer votre agent sur la plateforme ADK. Le déploiement inclut une étape de compilation en interne (qui peut être ignorée avec --skip-build).

Exemples d’utilisation

Compilation réussie

$ cargo adk build
   Compiling adk-core v0.9.2
   Compiling adk-agent v0.9.2
   Compiling my-agent v0.1.0 (/home/user/my-agent)
    Finished `release` profile [optimized] target(s) in 42.3s
✅ Build successful
   profile: release
   target:  target/release
   binary:  target/release/my-agent (12.4 MB)

Compilation de débogage pour itérer plus rapidement

$ cargo adk build --debug
   Compiling my-agent v0.1.0 (/home/user/my-agent)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 8.1s
✅ Build successful
   profile: debug
   target:  target/debug
   binary:  target/debug/my-agent (45.2 MB)

Intégration à un pipeline CI

# .github/workflows/ci.yml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: dtolnay/rust-toolchain@stable
      - run: cargo install cargo-adk
      - run: cargo adk build

Scénarios d’erreur et résolution

Dépendances manquantes

Symptôme : La compilation échoue avec des erreurs d’importation non résolues.

error[E0432]: unresolved import `adk_tool`
 --> src/main.rs:3:5
  |
3 | use adk_tool::FunctionTool;
  |     ^^^^^^^^ use of undeclared crate or module `adk_tool`

Résolution : Ajoutez le crate manquant aux dépendances Cargo.toml de votre projet :

[dependencies]
adk-tool = { version = "2.1.0", features = ["mcp"] }

Structure de projet non valide

Symptôme : cargo adk build ne trouve pas Cargo.toml.

Error: failed to run cargo build: No such file or directory (os error 2)

Résolution : Exécutez la commande depuis la racine de votre projet ou indiquez le chemin du manifeste :

cargo adk build --manifest-path ./my-agent/Cargo.toml

Conflits entre indicateurs de fonctionnalités

Symptôme : La compilation échoue en raison de combinaisons de fonctionnalités incompatibles.

error: the package `my-agent` depends on `adk-realtime`, with features:
       `openai-webrtc` but `openai-webrtc` is not a feature of `adk-realtime`

Résolution : Vérifiez que vos indicateurs de fonctionnalités correspondent aux fonctionnalités disponibles pour la version ADK que vous utilisez. Exécutez cargo doc -p adk-realtime --open pour afficher les fonctionnalités disponibles ou consultez la documentation du crate.

Fichier de verrouillage obsolète

Symptôme : Erreurs de résolution de version après la mise à niveau des crates ADK.

error: failed to select a version for the requirement `adk-core = "^0.9.2"`

Résolution : Mettez à jour votre fichier de verrouillage :

cargo update
cargo adk build

Problèmes liés à l’environnement de compilation

Symptôme : Erreurs de l’éditeur de liens ou bibliothèques système manquantes.

error: linker `cc` not found

Résolution : Installez la chaîne d’outils de compilation requise pour votre plateforme :

# Ubuntu/Debian
sudo apt install build-essential pkg-config libssl-dev

# macOS
xcode-select --install

# Fedora/RHEL
sudo dnf install gcc openssl-devel

Mémoire insuffisante pendant la compilation

Symptôme : Le processus de compilation est arrêté ou déclenche une panique en raison d’un échec d’allocation.

Résolution : Réduisez le parallélisme ou utilisez une machine disposant de davantage de mémoire vive :

# Limit parallel compilation jobs
CARGO_BUILD_JOBS=2 cargo adk build

# Or set in .cargo/config.toml
# [build]
# jobs = 2