Gestión de Versiones (agave-install / avm)
Fija las versiones de Agave/Solana CLI y Anchor con agave-install y avm para que cada máquina y trabajo de CI compile y despliegue contra el mismo runtime.
//
Busca en todas las páginas de la documentación
Fija las versiones de Agave/Solana CLI y Anchor con agave-install y avm para que cada máquina y trabajo de CI compile y despliegue contra el mismo runtime.
Tarjeta de receta de referencia rápida - lista para copiar y pegar.
agave-install init 4.1.1
solana --version
avm install 0.32.1
avm use 0.32.1
anchor --versionCuándo usar esto:
latest rompiera las compilaciones.# Fijar Agave / Solana CLI
sh -c "$(curl -sSfL https://release.anza.xyz/v4.1.1/install)"
agave-install init 4.1.1
solana --version
# Fijar Anchor a través de avm
cargo install --git https://github.com/coral-xyz/anchor avm --locked --force
avm install 0.32.1
avm use 0.32.1
anchor --version
# Anchor.toml por proyecto impone la CLI para comandos de anchor
grep '^anchor_version' Anchor.toml || echo 'anchor_version = "0.32.1"' >> Anchor.tomlLo que esto demuestra:
agave-install init selecciona el canal de lanzamiento del validador/CLI.avm use cambia el binario anchor en PATH.Anchor.toml anchor_version advierte cuando la falta de coincidencia de la CLI corrompería las compilaciones de IDL.agave-install descarga los artefactos de lanzamiento en ~/.local/share/solana/install/active_release.bin para solana, cargo-build-sbf, etc.avm almacena múltiples compilaciones de Anchor CLI bajo ~/.avm y enlaza simbólicamente la activa.rustup (fija 1.91.1 con rust-toolchain.toml).| Capa | Herramienta | Método de fijación |
|---|---|---|
| Validador/CLI | agave-install | init 4.1.1 |
| Anchor CLI | avm | use 0.32.1 |
crate anchor-lang | Cargo.toml | 0.32.1 |
| Compilador Rust | rustup | rust-toolchain.toml |
# Listar lanzamientos de Agave instalados
agave-install list
# Listar versiones de Anchor instaladas
avm listsolana de Homebrew anula la instalación de Agave. Solución: which solana y reordenar PATH.avm use en el pipeline.anchor-lang - CLI 0.32.1 con crate 0.30.x falla la expansión de macros. Solución: actualizar todos los crates de Anchor juntos.rustup - el nuevo estable rompe cargo build-sbf. Solución: confirmar rust-toolchain.toml con 1.91.1.| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
Solo rust-toolchain.toml | Servicios solo de Rust | Fijación completa de Solana CLI |
| Entornos de desarrollo Nix / Docker | Entornos de equipo herméticos | Configuración rápida de portátil individual |
Ayudantes de versión mucho | Repositorios de plantilla de Foundation | Diseños personalizados de múltiples repositorios |
| Extracción manual de tarball | Instalaciones aisladas del aire | Desarrollo normal con conexión a Internet |
Sí - usa las URLs de lanzamiento de Anza (release.anza.xyz) para Agave 4.x en adelante.
Añade rust-toolchain.toml con channel = "1.91.1" en la raíz del repositorio.
Sí - ejecuta avm use al cambiar de directorio o usa los hooks de direnv.
Alinea avm use, Anchor.toml anchor_version y la versión del crate anchor-lang a la misma versión.
Instala la nueva versión, ejecuta anchor test completo y un despliegue de prueba en devnet, luego actualiza la documentación del equipo.
No - solo el binario CLI. Cargo.toml todavía fija las dependencias del programa.
agave-install list luego elimina los directorios no utilizados según la documentación de Anza, o reinstala un canal limpio.
Caché el directorio de instalación con clave de versión 4.1.1 para velocidad; verifica con solana --version en cada ejecución.
Instala la versión coincidente junto con Agave al usar pipelines de compilación verificables.
Usa package.json "@solana/kit": "7.0.0" - separado de las fijaciones de Agave/Anchor.
Versiones de la Pila: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.
Revisado por Chris St. John·Última actualización: 19 jul 2026