Depurar en IDEs de JetBrains

En esta guía, estaremos configurando JetBrains RustRover para depurar el proceso principal (Core Process) de tu aplicación Tauri. También se aplica en su mayoría a IntelliJ y CLion.

Configurar un proyecto de Cargo

Según la pila (stack) del frontend que se utilice en un proyecto, el directorio del proyecto puede o no ser un proyecto de Cargo. De forma predeterminada, Tauri coloca el proyecto de Rust en un subdirectorio llamado src-tauri. Crea un proyecto de Cargo en el directorio raíz solo si también se utiliza Rust para el desarrollo del frontend.

Si no hay un archivo Cargo.toml en el nivel superior, debes adjuntar el proyecto manualmente. Abre la ventana de herramientas de Cargo (en el menú principal, ve a View | Tool Windows | Cargo), haz clic en + (Attach Cargo Project) en la barra de herramientas y selecciona el archivo src-tauri/Cargo.toml.

Alternativamente, podrías crear un workspace de Cargo de nivel superior manualmente agregando el siguiente archivo al directorio raíz del proyecto:

Cargo.toml

[workspace]
members = ["src-tauri"]

Antes de continuar, asegúrate de que tu proyecto esté completamente cargado. Si la ventana de herramientas de Cargo muestra todos los módulos y objetivos del workspace, estás listo para continuar.

Configurar configuraciones de ejecución

Necesitarás configurar dos configuraciones de ejecución/depuración independientes:

• una para iniciar la aplicación Tauri en modo de depuración,
• otra para ejecutar el servidor de desarrollo de tu frontend preferido.

Aplicación Tauri

1. En el menú principal, ve a Run | Edit Configurations.
2. En el cuadro de diálogo Run/Debug Configurations:

• Para crear una nueva configuración, haz clic en + en la barra de herramientas y selecciona Cargo.

Una vez creada, necesitamos configurar RustRover para que le indique a Cargo compilar nuestra aplicación sin ninguna característica predeterminada. Esto le dirá a Tauri que use tu servidor de desarrollo en lugar de leer recursos del disco. Normalmente esta flag es pasada por la CLI de Tauri, pero dado que aquí estamos esquivando eso por completo, necesitamos pasar la flag manualmente.

Ahora opcionalmente podemos renombrar la configuración de ejecución/depuración a algo más fácil de recordar; en este ejemplo la llamamos “Run Tauri App”, pero puedes llamarla como quieras.

Servidor de desarrollo

La configuración anterior usará Cargo directamente para compilar la aplicación de Rust y adjuntarle el depurador. Esto significa que omitimos por completo la CLI de Tauri, por lo que las funciones como beforeDevCommand y beforeBuildCommand no se ejecutarán. Debemos encargarnos de ello ejecutando manualmente el servidor de desarrollo.

Para crear la configuración de ejecución correspondiente, debes verificar el servidor de desarrollo real en uso. Busca el archivo src-tauri/tauri.conf.json y encuentra la siguiente línea:

    "beforeDevCommand": "pnpm dev"

Para npm, pnpm o yarn, podrías usar la configuración de ejecución de npm, por ejemplo:

Asegúrate de tener los valores correctos en los campos Command, Scripts y Package Manager.

Si tu servidor de desarrollo es trunk para frameworks de frontend de WebAssembly basados en Rust, podrías usar la configuración de ejecución genérica de Shell Script:

Iniciar una sesión de depuración

Para iniciar una sesión de depuración, primero debes ejecutar tu servidor de desarrollo y luego comenzar a depurar la aplicación Tauri haciendo clic en el botón Debug junto al selector de configuraciones de ejecución. RustRover reconocerá automáticamente los puntos de interrupción colocados en cualquier archivo de Rust de tu proyecto y se detendrá en el primero que alcance.

A partir de este punto, puedes explorar los valores de tus variables, avanzar más en el código y verificar en detalle qué está sucediendo en tiempo de ejecución.