Instalación

El primer paso a realizar es instalar Rust y para ello debemos descargar rustup, una herramienta de línea de comandos para gestionar las versiones de Rust y herramientas asociadas. rustup descarga componentes de Internet bajo demanda, por lo que si necesitas instalar Rust sin acceso a Internet, rustup no es la herramienta adecuada.

Nota: En la página de instalación de Rust puedes encontrar otras opciones para realizar la instalación.

Versiones y lanzamientos

Rust tiene un proceso de liberación rápida de 6 semanas, es decir, cada seis semanas hay una versión nueva del compilador, siendo la versión 1.44.0 la última publicada. El proceso de lanzamiento de Rust sigue el modelo 'release train', en el que hay tres 'canales de lanzamiento' a través de los que los binarios oficiales de Rust son publicados: nightly, beta y stable, y estos canales de lanzamiento corresponden a las ramas de desarrollo.

Rust soporta un gran número de plataformas, por lo que hay muchas versiones de Rust disponibles en cualquier momento. rustup gestiona estas versiones de manera consistente en cada plataforma que Rust soporta, permitiendo la instalación de Rust desde los canales de lanzamiento beta y nightly, así como soporte para compilación cruzada en otras plataformas.

La naturaleza del desarrollo y lanzamientos es diferente en cada canal, ya que cada uno tiene un objetivo específico. nightly es para el desarrollo activo, beta es para pruebas y corrección de errores y stable es para lanzamientos finales.

Nightly es donde sucede la mayor parte del desarrollo, construido a partir de la rama master de rust-lang/rust cada noche, de ahí el nombre. Brinda acceso a funcionalidades en desarrollo antes de que sean publicadas.

En la rama beta se realizan pruebas y correción de errores, especialmente en la compatibilidad con versiones anteriores del compilador. Las funcionalidades y mejoras que se prueban en este canal son candidatas a estar en la próxima versión.

'Stable' se actualiza cada seis semanas y es donde puede accederse a la última versión de Rust. En donde las funcionalidades y mejoras que pasaron las pruebas están disponibles.

Las garantías de estabilidad de Rust aseguran que todos los ejemplos en el libro continuarán compilando con las versiones nuevas de Rust. La salida puede diferir ligeramente entre versiones, porque Rust frecuemente mejora los mensajes de error y advertencias. En otras palabras, cualquier versión estable de Rust que instales siguiendo estos pasos debería funcionar como se espera con el contenido de este libro.

Notación de la línea de comandos

En este capítulo y en todo el libro, mostraremos algunos comandos que deben ejecutarse en la terminal. Las líneas que debes escribir en la terminal empiezan con $. No necesitas escribir el caracter $; indica el inicio de de cada comando. Las líneas que no empiecen con $ generalmente muestran la salida del comando anterior. Adicionalmente, ejemplos específicos de PowerShell usarán > en lugar de $.

Instalar rustup

Para instalar rustup puedes seguir las instrucciones disponibles en rustup.rs o consultar las secciones 1.1.1, 1.1.2 y 1.1.3, donde puedes encontrar información más amplia sobre como instalar en Windows, Linux y Mac OS X.

Actualizar y Desinstalar

Despues de que has instalado Rust via rustup, actualizar a la última versión es sencillo. Desde tu terminal, ejecuta el siguiente script de actualización:

$ rustup update

Para desinstalar Rust y rustup, ejecuta el siguiente script de desinstalación desde tu terminal:

$ rustup self uninstall

Solución de problemas

Para comprobar si has instalado Rust correctamente, abre una terminal y escribe esta línea:

$ rustc --version

Deberías ver el número de versión, el hash del commit, y la fecha de commit en el siguiente formato para la última versión estable que has sido publicada

rustc x.y.z (abcabcabc yyyy-mm-dd)

Si ves esta información, ¡has instalado Rust exitosamente! Si no ves esta información y estás en Windows, revisa que Rust esté en la varible de sistema %PATH%. Si todo está correcto and Rust aún no está funcionando, hay un número de lugares donde puedes ontener ayuda. Lo más sencillo es en el canal #beginners en the official Rust Discord. Ahí, puedes conversar con otros Rustaceans (un nombre tonto con el que nos llamamos) que pueden ayudarte. Otros grandes recursos incluye the Users forum y Stack Overflow.

Documentación local

La instalación de Rust también incluye una copia de la documentación localmente, así que puedes leerla fuera de línea. Ejecuta rustup doc para abrir la documentación local en tu navegador.

Cuando un tipo o función es proporcionado por la librería estándar y no estás seguro de qué hace o cómo usarlo, usa la documentación de la interfaz de programación de aplicaciones (API).