Depurar en VS Code

Esta guía te guiará a través de la configuración de VS Code para depurar el Proceso Principal (Core Process) de tu aplicación Tauri.

Todas las plataformas con la extensión vscode-lldb

Requisitos previos

Instala la extensión vscode-lldb.

Configurar launch.json

Crea un archivo .vscode/launch.json y pega en él los siguientes contenidos JSON:

.vscode/launch.json

{
  // Use IntelliSense to learn about possible attributes.
  // Hover to view descriptions of existing attributes.
  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "lldb",
      "request": "launch",
      "name": "Tauri Development Debug",
      "cargo": {
        "args": [
          "build",
          "--manifest-path=./src-tauri/Cargo.toml",
          "--no-default-features"
        ]
      },
      // task for the `beforeDevCommand` if used, must be configured in `.vscode/tasks.json`
      "preLaunchTask": "ui:dev"
    },
    {
      "type": "lldb",
      "request": "launch",
      "name": "Tauri Production Debug",
      "cargo": {
        "args": ["build", "--release", "--manifest-path=./src-tauri/Cargo.toml"]
      },
      // task for the `beforeBuildCommand` if used, must be configured in `.vscode/tasks.json`
      "preLaunchTask": "ui:build"
    }
  ]
}

Esto utiliza cargo directamente para compilar la aplicación Rust y cargarla tanto en modo de desarrollo como de producción.

Ten en cuenta que no utiliza la CLI de Tauri, por lo que las funciones exclusivas de la CLI no se ejecutan. Los scripts beforeDevCommand y beforeBuildCommand deben ejecutarse de antemano o configurarse como una tarea en el campo preLaunchTask. A continuación se muestra un archivo .vscode/tasks.json de ejemplo que tiene dos tareas, una para un beforeDevCommand que genera un servidor de desarrollo y otra para beforeBuildCommand:

.vscode/tasks.json

{
  // See https://go.microsoft.com/fwlink/?LinkId=733558
  // for the documentation about the tasks.json format
  "version": "2.0.0",
  "tasks": [
    {
      "label": "ui:dev",
      "type": "shell",
      // `dev` keeps running in the background
      // ideally you should also configure a `problemMatcher`
      // see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
      "isBackground": true,
      // change this to your `beforeDevCommand`:
      "command": "yarn",
      "args": ["dev"]
    },
    {
      "label": "ui:build",
      "type": "shell",
      // change this to your `beforeBuildCommand`:
      "command": "yarn",
      "args": ["build"]
    }
  ]
}

Ahora puedes establecer puntos de interrupción (breakpoints) en src-tauri/src/main.rs o cualquier otro archivo Rust y comenzar a depurar presionando F5.

Con Visual Studio Windows Debugger en Windows

Visual Studio Windows Debugger es un depurador solo para Windows que generalmente es más rápido que vscode-lldb con mejor soporte para algunas características de Rust como enums.

Requisitos previos

Instala la extensión C/C++ y sigue https://code.visualstudio.com/docs/cpp/config-msvc#_prerequisites para instalar Visual Studio Windows Debugger.

Configurar launch.json y tasks.json

.vscode/launch.json

{
  // Use IntelliSense to learn about possible attributes.
  // Hover to view descriptions of existing attributes.
  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch App Debug",
      "type": "cppvsdbg",
      "request": "launch",
      // change the exe name to your actual exe name
      // (to debug release builds, change `target/debug` to `release/debug`)
      "program": "${workspaceRoot}/src-tauri/target/debug/your-app-name-here.exe",
      "cwd": "${workspaceRoot}",
      "preLaunchTask": "ui:dev"
    }
  ]
}

Ten en cuenta que no utiliza la CLI de Tauri, por lo que las funciones exclusivas de la CLI no se ejecutan. El tasks.json es el mismo que con lldb, excepto que necesitas agregar un grupo de configuración y dirigir tu preLaunchTask desde launch.json a él si quieres que siempre compile antes de iniciar.

Aquí hay un ejemplo de ejecución de un servidor de desarrollo (equivalente de beforeDevCommand) y la compilación (cargo build) como un grupo; para usarlo, cambia la configuración de preLaunchTask en launch.json a dev (o como hayas nombrado a tu grupo).

.vscode/tasks.json

{
  // See https://go.microsoft.com/fwlink/?LinkId=733558
  // for the documentation about the tasks.json format
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build:debug",
      "type": "cargo",
      "command": "build",
      "options": {
        "cwd": "${workspaceRoot}/src-tauri"
      }
    },
    {
      "label": "ui:dev",
      "type": "shell",
      // `dev` keeps running in the background
      // ideally you should also configure a `problemMatcher`
      // see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
      "isBackground": true,
      // change this to your `beforeDevCommand`:
      "command": "yarn",
      "args": ["dev"]
    },
    {
      "label": "dev",
      "dependsOn": ["build:debug", "ui:dev"],
      "group": {
        "kind": "build"
      }
    }
  ]
}