For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/desktop/ship-in-5-minutes.md (or send Accept: text/markdown).
Ejecutar la app de escritorio en 5 minutos
Prepare Rust y las herramientas de compilación de su sistema operativo, inicie un backend web accesible, inicie la ventana Tauri y verifique la bandeja, el acceso directo y el comportamiento de las tareas locales.
1. Instalar las herramientas generales y nativas.
Complete Antes de comenzar, clone su repositorio de escritorio o monorepo de todas las plataformas y ábralo en el editor. El escritorio es una ventana nativa alrededor de la misma aplicación web. No incluye una segunda implementación de cuentas ni chat. El lanzamiento de cinco minutos comienza después de que se instalan las dependencias y las herramientas nativas; La instalación por primera vez y la compilación de Rust suelen tardar más.
En Windows, instale Microsoft C++ Build Tools utilizando el enlace de requisitos previos de Tauri que aparece a continuación. En su instalador seleccione Desarrollo de escritorio con C++, mantenga seleccionado Windows SDK y complete la instalación. Asegúrese de que Microsoft Edge WebView2 Runtime esté instalado. Instale Rust desde Rustup.rs usando Rustup-init.exe; mantenga la cadena de herramientas MSVC predeterminada. Vuelva a abrir su terminal después de la instalación.
En macOS, ejecute xcode-select --install en Terminal y complete el cuadro de diálogo de herramientas de línea de comandos si no están instaladas. Instale Rust usando el comando macOS de Rustup.rs. En Linux, siga la página de requisitos previos Tauri para los paquetes WebKitGTK, compilador, bandeja y biblioteca del sistema de su distribución exacta, luego instale Rust. Los nombres de los paquetes de Linux varían; no ejecute los comandos de otra distribución.
Abra una terminal en la raíz del repositorio y ejecute las comprobaciones de versión a continuación. Tanto rustc como cargo deben imprimir versiones; cargo es la herramienta de construcción de Rust. Si falta alguno de ellos, finalice la instalación y vuelva a abrir el terminal antes de continuar.
- Instale las herramientas y obtenga el código
- Aprenda a ejecutar un comando y editar un archivo
- Lista de verificación de requisitos previos del sistema operativo de Tauri
- Instalador oficial de Rust
rustc --version
cargo --version
corepack pnpm install2. Inicie o elija el backend web
Si su pago contiene apps/web, siga el tutorial web, cree apps/web/.env.local, ejecute el servidor web en una terminal separada usando el siguiente comando y déjelo en ejecución. Primero verifique http://localhost:3000 en su navegador. Puede utilizar la demostración de /dashboard sin una base de datos; El inicio de sesión real en /auth necesita migrar Postgres.
Un pago solo de escritorio no contiene apps/web.. Utilice el backend web que se ejecuta por separado suministrado para su producto y abra su URL en su navegador para confirmar que funciona. El shell del escritorio no puede crear el backend por usted. No intente el siguiente comando web si esa carpeta no está. El paso 3 muestra cómo elegir una dirección de backend proporcionada.
# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev3. Inicie la ventana del escritorio.
Abra una segunda terminal en la raíz del repositorio mientras el backend permanece ejecutándose. Para el backend local predeterminado en http://localhost:3000,, ejecute el primer comando a continuación. Cargo puede descargar bibliotecas y compilar el shell; espere a que se abra la ventana de Supastack. Se esperan mensajes del compilador durante la primera compilación.
Para un backend proporcionado, reemplace https://app.example.com en el bloque de sistema operativo apropiado a continuación con su URL real. Ejecute solo el bloque de su plataforma. SUPASTACK_APP_URL es una configuración del entorno del terminal, leída cuando se inicia el proceso nativo. Ponerlo solo en root .env no configurará el shell. Mantenga el backend URL libre de nombres de usuario o contraseñas incrustados.
En el monorepo Todas las plataformas, corepack pnpm dev:desktop puede iniciar Web y Tauri juntos una vez que pnpm esté en PATH como se explica en Antes de comenzar. El siguiente comando filtrado también funciona en pagos solo de escritorio, con el backend ejecutándose por separado.
# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev
# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev
# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev4. Verifique la ventana, la bandeja y el acceso directo.
Éxito significa que la ventana muestra la misma página de inicio que su backend en el navegador. La ventana del escritorio no tiene barra de direcciones del navegador. Para abrir la demostración sin credenciales, salga del shell usando la acción Salir de la bandeja, luego ejecute el bloque de su sistema operativo a continuación en la terminal de escritorio mientras el servidor web permanece ejecutándose. Esto carga /dashboard directamente; Siga los pasos de la tarea local del tutorial web allí. El inicio de sesión de la cuenta real utiliza la base de datos del backend, al igual que en el navegador.
Cierra la ventana usando el botón de cerrar: la aplicación debería ocultarse en la bandeja en lugar de salir. Haga clic en el icono de la bandeja Supastack o presione Ctrl + Shift + Espacio en Windows/Linux, o Comando + Shift + Espacio en macOS, para mostrarlo nuevamente. Utilice la acción Salir de la bandeja para salir. Para finalizar el desarrollo por completo, presione también Ctrl + C en la terminal de escritorio y luego detenga la terminal backend.
Si la ventana está en blanco o muestra un problema de conexión, primero abra el URL configurado en un navegador. Inicie el backend o corrija URL, luego reinicie Tauri. Si Rust informa que no se encuentra linker.exe, instale la carga de trabajo de Windows C++ y vuelva a abrir la terminal. Si Linux informa que falta una biblioteca del sistema, siga los requisitos previos específicos de la distribución. Si la tecla de acceso rápido ya está en uso, use la bandeja y siga el comportamiento nativo para cambiarla.
Esto abre una ventana de desarrollo local; no produce un instalador firmado ni publica una aplicación. Siga la distribución de escritorio para compilaciones de instaladores, firma de plataformas y pruebas en otra máquina. La compilación de Windows no verifica el comportamiento de macOS o Linux.
- Configurar el comportamiento de la ventana nativa y de los accesos directos
- Crear y verificar instaladores de escritorio
# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev
# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop devUsa la URL local de la app
Sin una anulación, Tauri carga http://localhost:3000. Define SUPASTACK_APP_URL solo si tu app local de Next.js usa otro origen HTTP(S) accesible. Se rechazan las URL con credenciales o que no usen un protocolo web.
El identificador del bundle de desarrollo y la configuración de publicación aún no están listos para producción. Consulta la guía de publicación independiente para la comprobación previa y la firma de cada plataforma.