Prerrequisitos

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

1. Dependencias del Sistema
2. Rust
3. Configurar para Móvil (solo se requiere si se desarrolla para móviles)

Dependencias del Sistema

Sigue el enlace para comenzar según tu sistema operativo:

• Linux (ver más abajo para distribuciones específicas)
• macOS Catalina (10.15) y versiones posteriores
• Windows 7 y versiones posteriores

Linux

Tauri requiere varias dependencias del sistema para el desarrollo en Linux. Estas pueden ser diferentes dependiendo de su distribución, pero hemos incluido algunas distribuciones populares a continuación para ayudarlo a configurar.

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

Fedora

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

Gentoo

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

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 \
  curl \
  wget \
  file \
  openssl \
  libayatana-appindicator-dev \
  librsvg

NixOS

Nota

Esto también instalará Rust y Node.js, además de la CLI de cargo-tauri por ti, por lo que puedes omitir esos pasos a continuación.

Using nix-shell:

let
  pkgs = import <nixpkgs> { };
in
pkgs.mkShell {
  nativeBuildInputs = with pkgs; [
    pkg-config
    gobject-introspection
    cargo
    cargo-tauri
    nodejs
  ];

  buildInputs = with pkgs;[
    at-spi2-atk
    atkmm
    cairo
    gdk-pixbuf
    glib
    gtk3
    harfbuzz
    librsvg
    libsoup_3
    pango
    webkitgtk_4_1
    openssl
  ];
}

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

Siguiente: Instalar Rust

macOS

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

Descarga e instala Xcode desde uno de los siguientes lugares:

• App Store de Mac
• Sitio web del Desarrollador de Apple.

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

¿Solo desarrollando para escritorio?

Si estás planeando desarrollar aplicaciones de escritorio y no apuntar a iOS, puedes instalar Xcode Command Line Tools en su lugar:

xcode-select --install

Siguiente: Instalar Rust

Windows

Tauri usa las Herramientas de compilación de C++ de Microsoft para el desarrollo, así como Microsoft Edge WebView2. Ambos son necesarios 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 marque la opción “Desarrollo de escritorio con C ++”.

Siguiente: Instalar WebView2.

WebView2

Consejo

WebView 2 ya está instalado en Windows 10 (desde la versión 1803 en adelante) y versiones posteriores de Windows. Si estás desarrollando en una de estas versiones, puede 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 Boostrapper” e instálalo.

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/macOS

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

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

Tip de Seguridad

Nosotros hemos auditado este script bash y hace lo que dice que debe hacer. Sin embargo, antes de ejecutar ciegamente un script, siempre es bueno revisarlo primero.

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

Windows

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

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

winget install --id Rustlang.Rustup

MSVC toolchain como predeterminado

Para un soporte total para Tauri y herramientas como trunk asegurate de que la toolchain MSVC de Rust sea el default host triple 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 esté instalada la toolchain correcta ejecutando el siguiente 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 Móvil si deseas construir para Android e iOS, o, si te gustaría usar un framework de JavaScript, instala Node. De lo contrario, Crea un Proyecto.

Node.js

Ecosistema de JavaScript

Solo si tu intención es usar un framework frontend de JavaScript

1. Visita la web de Node.js, descarga la version de Soporte a Largo Plazo (LTS) e instálala.

2. Comprueba si Node se ha instalado correctamente ejecutando:

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

Es importante reiniciar tu Terminal para asegurarse de que reconoce la nueva instalación. En algunos casos, puede que necesites reiniciar tu ordenador.

Aunque npm es el gestor de paquetes predeterminado para Node.js, puedes usar otros como por ejemplo pnpm o yarn. Para habilitarlos, ejecuta corepack enable en tu Terminal. Este paso es opcional y únicamente necesario si prefieres usar otro gestor de paquetes que no sea npm.

Next: Configurar para Móvil o Crea un proyecto.

Configurar para Móvil

Si deseas compilar tu aplicación para Android o iOS, entonces hay algunas dependencias adicionales que necesitas 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"

Windows

[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

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)"

Windows

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

Consejo

PowerShell no detectará las nuevas variables de entorno hasta que reinicies o cierres sesión. Sin embargo, puedes actualizar la sesión actual:

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

5. Agrega los destinos de compilación de Android con rustup:

Linux/macOS

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

Windows

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

Siguiente: Configurar para iOS o Crear un proyecto.

iOS

Solo macOS

El desarrollo de 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. Agrega los destinos de compilación de iOS con rustup en la Terminal:

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

2. Instala 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 tienes algún problema durante la instalación, asegúrate de revisar la Guía de Solución de Problemas o comunícate en el Discord de Tauri.

Siguientes Pasos

¡Ahora que has instalado todos los prerequisitos estás listo para crear tu primer proyecto Tauri!