Tutorial de Tauri - Capítulo 2: Configuración del Entorno de Desarrollo

Indice Tutorial >>

Antes de escribir una sola línea de código, necesitas tener las herramientas correctas instaladas. Tauri requiere Rust, Node.js y algunas dependencias que varían según tu sistema operativo.

En este capítulo te guío paso a paso por la instalación de todo lo necesario en Windows, macOS y Linux.

Requisitos previos

Antes de empezar, asegúrate de tener:

Conexión a internet estable
Al menos 5GB de espacio libre en disco
Permisos de administrador en tu sistema

Paso 1: Instalar Rust

Rust es el lenguaje que Tauri usa para el backend. La instalación es sencilla gracias a rustup, el instalador oficial.

En Windows

Primero necesitas las Microsoft C++ Build Tools. Descárgalas desde visualstudio.microsoft.com y durante la instalación selecciona «Desarrollo de escritorio con C++».

Después, descarga el instalador de rustup desde rustup.rs y ejecútalo. Cuando aparezca la terminal, pulsa 1 y Enter para la instalación por defecto.

Asegúrate de que el toolchain MSVC sea el predeterminado:

rustup default stable-msvc

En macOS

Primero instala las Xcode Command Line Tools:

xcode-select --install

Acepta la instalación cuando aparezca el diálogo. Después instala Rust:

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

Pulsa 1 y Enter para la instalación estándar.

En Linux (Debian/Ubuntu)

Instala primero las dependencias del sistema:

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libssl-dev libayatana-appindicator3-dev librsvg2-dev

Después instala Rust:

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

En Linux (Fedora)

sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libappindicator-gtk3-devel librsvg2-devel
curl --proto =https --tlsv1.2 -sSf https://sh.rustup.rs | sh

En Linux (Arch)

sudo pacman -S webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg
curl --proto =https --tlsv1.2 -sSf https://sh.rustup.rs | sh

Verificar la instalación de Rust

Cierra la terminal, ábrela de nuevo y ejecuta:

rustc --version

Deberías ver algo como:

rustc 1.75.0 (82e1608df 2023-12-21)

Si ves el número de versión, Rust está instalado correctamente.

Paso 2: Instalar Node.js

Node.js es necesario para las herramientas de desarrollo del frontend y el CLI de Tauri.

La forma más sencilla es descargar la versión LTS desde nodejs.org. Ejecuta el instalador y sigue los pasos.

Verifica la instalación:

node --version
npm --version

Necesitas Node.js 18 o superior.

Paso 3: Verificar que todo está listo

Con todo instalado, puedes verificar tu sistema con el comando de diagnóstico de Tauri. Ejecuta:

npx @tauri-apps/cli info

Este comando analiza tu sistema y te muestra un resumen de las versiones instaladas y posibles problemas.

Resumen de requisitos

Herramienta	Comando de verificación	Versión mínima
Rust	`rustc --version`	1.70+
Node.js	`node --version`	18+
npm	`npm --version`	8+

Problemas comunes y soluciones

«rustc no se reconoce como comando»

Cierra la terminal completamente y ábrela de nuevo. Si sigue sin funcionar, añade Cargo al PATH manualmente:

Windows: Añade %USERPROFILE%.cargobin a las variables de entorno
macOS/Linux: Añade export PATH="$HOME/.cargo/bin:$PATH" a tu .bashrc o .zshrc

Errores de WebKit en Linux

Asegúrate de instalar libwebkit2gtk-4.1-dev (con el 4.1, no 4.0). Tauri 2.0 requiere específicamente la versión 4.1.

La compilación falla en Windows

Verifica que instalaste las Build Tools de Visual Studio con el componente «Desarrollo de escritorio con C++». Sin él, Rust no puede compilar código nativo.

Resumen

Ya tienes tu entorno de desarrollo listo con Rust, Node.js y las dependencias necesarias para Tauri.

En el próximo capítulo vamos a crear tu primera aplicación Tauri: un clásico «Hola Mundo» que te permitirá entender el flujo básico de desarrollo.

Nos vemos en el Capítulo 3.

¿Te está gustando este tutorial?

Este tutorial forma parte del libro Tauri 2.0: Aplicaciones de Escritorio con React y Rust, disponible en Amazon en formato papel y ebook. El libro incluye todos los capítulos, tres proyectos completos paso a paso y contenido exclusivo que no encontrarás en el blog.

Consíguelo en Amazon