Requisitos previos

Para empezar a construir tu proyecto con Tauri, primero necesitarás instalar algunas dependencias:

1. Dependencias del Sistema
2. Rust
3. Configurar para Objetivos Móviles (solo requerido si desarrollas para dispositivos móviles)

Dependencias del Sistema

Sigue el enlace para comenzar en tu respectivo sistema operativo:

• Linux (ver a continuación para distribuciones específicas)
• macOS Catalina (10.15) y posterior
• Windows 7 y posterior

Linux

Tauri requiere varias dependencias del sistema para el desarrollo en Linux. Estas pueden ser diferentes según tu distribución, pero hemos incluido algunas distribuciones populares a continuación para ayudarte a realizar la configuración.

Debian

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

Arch

sudo pacman -Syu
sudo pacman -S --needed \
  webkit2gtk-4.1 \
  base-devel \
  curl \
  wget \
  file \
  openssl \
  appmenu-gtk-module \
  libappindicator-gtk3 \
  librsvg \
  xdotool

Fedora

sudo dnf check-update
sudo dnf install webkit2gtk4.1-devel \
  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel \
  libxdo-devel
sudo dnf group install "c-development"

Gentoo

sudo emerge --ask \
  net-libs/webkit-gtk:4.1 \
  dev-libs/libayatana-appindicator \
  net-misc/curl \
  net-misc/wget \
  sys-apps/file

OSTree

sudo rpm-ostree install webkit2gtk4.1-devel \
  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel \
  libxdo-devel \
  gcc \
  gcc-c++ \
  make
sudo systemctl reboot

openSUSE

sudo zypper up
sudo zypper in webkit2gtk3-devel \
  libopenssl-devel \
  curl \
  wget \
  file \
  libappindicator3-1 \
  librsvg-devel
sudo zypper in -t pattern devel_basis

Alpine

sudo apk add \
  build-base \
  webkit2gtk-4.1-dev \
  curl \
  wget \
  file \
  openssl \
  libayatana-appindicator-dev \
  librsvg

Nota: Los contenedores de Alpine Linux no incluyen fuentes por defecto. Para asegurarte de que el texto se renderice correctamente en tu aplicación Tauri, instala al menos un paquete de fuentes (por ejemplo, font-dejavu ).

NixOS

Nota

Las instrucciones para Nix/NixOS se pueden encontrar en la NixOS Wiki.

Si tu distribución no está incluida arriba, es posible que desees consultar Awesome Tauri en GitHub para ver si se ha creado una guía.

Siguiente: Instalar Rust

macOS

Tauri utiliza Xcode y varias dependencias de desarrollo de macOS e iOS.

Descarga e instala Xcode desde uno de los siguientes lugares:

• Mac App Store
• Sitio web de Apple Developer.

Asegúrate de iniciar Xcode después de instalarlo para que pueda terminar de configurarse.

¿Solo estás desarrollando para objetivos de escritorio?

If you’re only planning to develop desktop apps and not targeting iOS then you can install Xcode Command Line Tools instead:

xcode-select --install

Siguiente: Instalar Rust

Ventanas

Tauri usa Microsoft C++ Build Tools para el desarrollo, así como Microsoft Edge WebView2. Ambos son requeridos para el desarrollo en Windows.

Sigue los pasos a continuación para instalar las dependencias requeridas.

Microsoft C++ Build Tools

1. Descarga el instalador de Microsoft C++ Build Tools y ábrelo para comenzar la instalación.
2. Durante la instalación, marca la opción "Desarrollo para el escritorio con C++".

Siguiente: Instalar WebView2.

WebView2

Consejo

WebView2 ya está instalado en Windows 10 (a partir de la versión 1803) y versiones posteriores de Windows. Si estás desarrollando en una de estas versiones, puedes omitir este paso e ir directamente a instalar Rust.

Tauri usa Microsoft Edge WebView2 para renderizar contenido en Windows.

Instala WebView2 visitando la sección de descarga de WebView2 Runtime. Descarga el "Evergreen Bootstrapper" e instálalo.

Siguiente: Verificar VBSCRIPT

VBSCRIPT (para instaladores MSI)

Solo compilación de paquetes MSI

Esto solo es necesario si tienes pensado construir paquetes de instaladores MSI ("targets": "msi" o "targets": "all" en tauri.conf.json).

Construir paquetes MSI en Windows requiere que la característica opcional VBSCRIPT esté habilitada. Esta característica está habilitada por defecto en la mayoría de las instalaciones de Windows, pero puede haber sido desactivada en algunos sistemas.

Si encuentras errores como failed to run light.exe al construir paquetes MSI, es posible que debas habilitar la característica VBSCRIPT:

1. Abre Configuración → Aplicaciones → Características opcionales → Más características de Windows
2. Busca VBSCRIPT en la lista y asegúrate de que esté marcado
3. Haz clic en Siguiente y reinicia tu computadora si se te solicita

Nota: VBSCRIPT está actualmente habilitado por defecto en la mayoría de las instalaciones de Windows, pero está siendo obsoleto y puede desactivarse en futuras versiones de Windows.

Siguiente: Instalar Rust

Rust

Tauri está construido con Rust y lo requiere para el desarrollo. Instala Rust usando uno de los siguientes métodos. Puedes ver más métodos de instalación en https://www.rust-lang.org/tools/install.

Linux y macOS

Instala a través de rustup usando el siguiente comando:

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

Consejo de seguridad

Hemos auditado este script de bash, y hace lo que dice que debe hacer. Sin embargo, antes de ejecutar a ciegas un script con curl-bash, siempre es sabio revisarlo primero.

Aquí está el archivo como un script plano: rustup.sh

Ventanas

Visita https://www.rust-lang.org/tools/install para instalar rustup.

Alternativamente, puedes usar winget para instalar rustup usando el siguiente comando en PowerShell:

winget install --id Rustlang.Rustup

Cadena de herramientas MSVC por defecto

Para soporte completo de Tauri y herramientas como trunk, asegúrate de que la cadena de herramientas Rust de MSVC sea el triplete de host predeterminado seleccionado en el diálogo del instalador. Dependiendo de tu sistema, debería ser x86_64-pc-windows-msvc, i686-pc-windows-msvc, o aarch64-pc-windows-msvc.

Si ya tienes Rust instalado, puedes asegurarte de que la cadena de herramientas correcta esté instalada ejecutando este comando:

rustup default stable-msvc

Asegúrate de reiniciar tu Terminal (y en algunos casos tu sistema) para que los cambios surtan efecto.

Siguiente: Configurar para Objetivos Móviles si deseas construir para Android e iOS, o, si deseas usar un framework de JavaScript, instala Node. De lo contrario, Crea un Proyecto.

Node.js

Ecosistema JavaScript

Solo si tienes la intención de usar un framework de frontend en JavaScript

1. Ve al sitio web de Node.js, descarga la versión de Soporte a Largo Plazo (LTS) e instálala.
2. Comprueba si Node se instaló correctamente ejecutando:

node -v
# v20.10.0
npm -v
# 10.2.3

Es importante reiniciar tu Terminal para asegurarte de que reconozca la nueva instalación. En algunos casos, es posible que debas reiniciar tu computadora.

Aunque npm es el gestor de paquetes predeterminado para Node.js, también puedes usar otros como pnpm o yarn. Para habilitarlos, ejecuta corepack enable en tu Terminal. Este paso es opcional y solo es necesario si prefieres usar un gestor de paquetes diferente a npm.

Siguiente: Configurar para Objetivos Móviles o Crear un proyecto.

Configurar para Objetivos Móviles

Si deseas dirigir tu aplicación a Android o iOS, hay algunas dependencias adicionales que debes instalar:

• Android
• iOS

Android

1. Descarga e instala Android Studio desde el sitio web de Android Developers
2. Establece la variable de entorno JAVA_HOME:

Linux

export JAVA_HOME=/opt/android-studio/jbr

macOS

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"

Ventanas

[System.Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Android\Android Studio\jbr", "User")

3. Usa el SDK Manager en Android Studio para instalar lo siguiente:

• Android SDK Platform
• Android SDK Platform-Tools
• NDK (Side by side)
• Android SDK Build-Tools
• Android SDK Command-line Tools

Seleccionar "Show Package Details" en el SDK Manager permite la instalación de versiones más antiguas de los paquetes. Solo instala versiones más antiguas si es necesario, ya que pueden introducir problemas de compatibilidad o riesgos de seguridad.

4. Establece las variables de entorno ANDROID_HOME y NDK_HOME.

Linux

export ANDROID_HOME="$HOME/Android/Sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

macOS

export ANDROID_HOME="$HOME/Library/Android/sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

Ventanas

[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "$env:LocalAppData\Android\Sdk", "User")
$VERSION = Get-ChildItem -Name "$env:LocalAppData\Android\Sdk\ndk" | Select-Object -Last 1
[System.Environment]::SetEnvironmentVariable("NDK_HOME", "$env:LocalAppData\Android\Sdk\ndk\$VERSION", "User")

Consejo

La mayoría de las aplicaciones no actualizan sus variables de entorno automáticamente, por lo que para permitirles tomar los cambios, puedes reiniciar tu terminal y tu IDE o, para tu sesión actual de PowerShell, puedes actualizarla con

[System.Environment]::GetEnvironmentVariables("User").GetEnumerator() | % { Set-Item -Path "Env:\$($_.key)" -Value $_.value }

5. Añade los objetivos de Android con rustup:

rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

Siguiente: Configuración para iOS o Crear un proyecto.

iOS

Solo macOS

El desarrollo para iOS requiere Xcode y solo está disponible en macOS. Asegúrate de haber instalado Xcode y no Xcode Command Line Tools en la sección de dependencias del sistema de macOS.

1. Añade los objetivos de iOS con rustup en la Terminal:

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

2. Instalar Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Instala Cocoapods usando Homebrew:

brew install cocoapods

Siguiente: Crear un proyecto.

Solución de problemas

Si encuentras algún problema durante la instalación, asegúrate de consultar la Guía de Resolución de Problemas o ponte en contacto en el Discord de Tauri.

Próximos Pasos

¡Ahora que has instalado todos los requisitos previos, estás listo para crear tu primer proyecto en Tauri!