Guía de instalación de Rust

Introducción

Bienvenido a Instalación. Esta práctica es parte del Rust Book. Puedes practicar tus habilidades de Rust en LabEx.

En esta práctica, necesitarás instalar Rust utilizando rustup, una herramienta de línea de comandos para administrar las versiones de Rust y las herramientas asociadas, descargándola a través de una conexión a Internet.

Skills Graph

Instalación

El primer paso es instalar Rust. Descargaremos Rust a través de rustup, una herramienta de línea de comandos para administrar las versiones de Rust y las herramientas asociadas. Necesitarás una conexión a Internet para la descarga.

Nota: Si prefieres no utilizar rustup por alguna razón, consulte la página Métodos Alternativos de Instalación de Rust en https://forge.rust-lang.org/infra/other-installation-methods.html para más opciones.

Los siguientes pasos instalan la última versión estable del compilador de Rust. Las garantías de estabilidad de Rust aseguran que todos los ejemplos del libro que se compilan seguirán compilando con versiones más recientes de Rust. La salida puede variar ligeramente entre versiones porque Rust a menudo mejora los mensajes de error y las advertencias. En otras palabras, cualquier versión más reciente y estable de Rust que instales utilizando estos pasos debería funcionar como se espera con el contenido de este libro.

Notación de Línea de Comandos

En este capítulo y en todo el libro, mostraremos algunos comandos utilizados en la terminal. Las líneas que debes ingresar en la terminal todas empiezan con $. No necesitas escribir el carácter $; es el indicador de la línea de comandos que se muestra para indicar el inicio de cada comando. Las líneas que no empiezan con $ generalmente muestran la salida del comando anterior. Además, los ejemplos específicos de PowerShell utilizarán > en lugar de $.

Instalando rustup en Linux o macOS

Si estás utilizando Linux o macOS, abre una terminal y escribe el siguiente comando:

curl --proto '=https' --tlsv1.3 https://sh.rustup.rs -sSf | sh

El comando descarga un script y comienza la instalación de la herramienta rustup, que instala la última versión estable de Rust. Es posible que se te solicite tu contraseña. Si la instalación es exitosa, aparecerá la siguiente línea:

Rust is installed now. Great!

También necesitarás un enlazador, que es un programa que Rust utiliza para unir sus salidas compiladas en un solo archivo. Es probable que ya tengas uno. Si obtienes errores de enlace, debes instalar un compilador de C, que por lo general incluirá un enlazador. Un compilador de C también es útil porque algunos paquetes comunes de Rust dependen de código C y necesitarán un compilador de C.

Los usuarios de Linux generalmente deben instalar GCC o Clang, de acuerdo con la documentación de su distribución. Por ejemplo, si utilizas Ubuntu, puedes instalar el paquete build-essential.

Solución de problemas

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

## Abre una nueva terminal primero!
rustc --version

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

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

Si ves esta información, ¡has instalado Rust correctamente! Si no ves esta información, comprueba que Rust está en tu variable de entorno %PATH% de la siguiente manera.

En Linux, utiliza:

echo $PATH

Si todo esto es correcto y Rust todavía no funciona, hay varios lugares donde puedes obtener ayuda. Descubre cómo ponerte en contacto con otros Rustaceans (un apodo tonto que nos llamamos a nosotros mismos) en la página de la comunidad en https://www.rust-lang.org/community.

Actualización y desinstalación

Una vez que se ha instalado Rust a través de rustup, es fácil actualizar a una versión recién publicada. Desde tu shell, ejecuta el siguiente script de actualización:

rustup update

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

rustup self uninstall

Escribe N cuando se te solicite para confirmar que quieres desinstalar Rust.

Documentación local

La instalación de Rust también incluye una copia local de la documentación para que puedas leerla sin conexión a Internet. Ejecuta rustup doc para abrir la documentación local en tu navegador.

rustup doc

Cada vez que una librería estándar proporcione un tipo o función y no estés seguro de lo que hace o cómo usarlo, ¡utiliza la documentación de la interfaz de programación de aplicaciones (API) para averiguarlo!

Nota: El WebIDE no admite abrir la documentación local.

Resumen

¡Felicidades! Has completado el laboratorio de Instalación. Puedes practicar más laboratorios en LabEx para mejorar tus habilidades.