Actualizar desde Tauri 2.0 Beta

Esta guía te guía a través de la actualización de tu aplicación Tauri 2.0 beta a Tauri 2.0 release candidate.

Migración Automatizada

La CLI de Tauri v2 incluye un comando migrate que automatiza la mayor parte del proceso y te ayuda a completar la migración:

npm install @tauri-apps/cli@latest
npm run tauri migrate

yarn upgrade @tauri-apps/cli@latest
yarn tauri migrate

pnpm update @tauri-apps/cli@latest
pnpm tauri migrate

cargo install tauri-cli --version "^2.0.0" --locked
cargo tauri migrate

Obtén más información sobre el comando migrate en la referencia de la Interfaz de Línea de Comandos (CLI)

Cambios de ruptura

Hemos tenido varios cambios importantes de beta a release candidate. Estos se pueden migrar automáticamente (ver arriba) o realizar manualmente.

Plugins del núcleo de Tauri

Cambiamos cómo se direccionan los plugins integrados de Tauri en las capacidades en la PR #10390.

Para migrar desde la última versión beta, debes anteponer a todos los identificadores de permisos del núcleo en tus capacidades core: o cambiar al permiso core:default y eliminar los antiguos identificadores de plugins del núcleo.

...
"permissions": [
    "path:default",
    "event:default",
    "window:default",
    "app:default",
    "image:default",
    "resources:default",
    "menu:default",
    "tray:default",
]
...

...
"permissions": [
    "core:path:default",
    "core:event:default",
    "core:window:default",
    "core:app:default",
    "core:image:default",
    "core:resources:default",
    "core:menu:default",
    "core:tray:default",
]
...

También añadimos un nuevo conjunto de permisos especial core:default que contendrá todos los permisos predeterminados de todos los plugins del núcleo, para que puedas simplificar la estructura básica de permisos en la configuración de tus capacidades.

...
"permissions": [
    "core:default"
]
...

Servidor de Desarrollo Integrado

Introdujimos cambios en la exposición en red del servidor de desarrollo integrado en la PR #10437 y la PR #10456.

El servidor de desarrollo móvil integrado ya no se expone a toda la red y hace un túnel con el tráfico de la máquina local directamente al dispositivo.

Actualmente, esta mejora no se aplica automáticamente cuando se ejecuta en dispositivos iOS (ya sea directamente o desde Xcode). En este caso, por defecto usamos la dirección de red pública para el servidor de desarrollo, pero hay una forma de solucionarlo que implica abrir Xcode para iniciar automáticamente una conexión entre tu máquina macOS y tu dispositivo iOS conectado, luego ejecutar tauri ios dev --force-ip-prompt para seleccionar la dirección TUN del dispositivo iOS (termina con ::2).

La configuración de tu servidor de desarrollo necesita adaptarse a este cambio si se pretende ejecutar en un dispositivo iOS físico. Anteriormente recomendábamos verificar si la variable de entorno TAURI_ENV_PLATFORM coincidía con android o ios, pero como ahora podemos conectarnos a localhost a menos que usemos un dispositivo iOS, deberías en su lugar verificar la variable de entorno TAURI_DEV_HOST. Aquí tienes un ejemplo de la migración de configuración de Vite:

2.0.0-beta:

import { defineConfig } from 'vite';
import { svelte } from '@sveltejs/vite-plugin-svelte';
import { internalIpV4Sync } from 'internal-ip';

const mobile = !!/android|ios/.exec(process.env.TAURI_ENV_PLATFORM);

export default defineConfig({
  plugins: [svelte()],
  clearScreen: false,
  server: {
    host: mobile ? '0.0.0.0' : false,
    port: 1420,
    strictPort: true,
    hmr: mobile
      ? {
          protocol: 'ws',
          host: internalIpV4Sync(),
          port: 1421,
        }
      : undefined,
  },
});

2.0.0:

import { defineConfig } from 'vite';
import Unocss from 'unocss/vite';
import { svelte } from '@sveltejs/vite-plugin-svelte';

const host = process.env.TAURI_DEV_HOST;

export default defineConfig({
  plugins: [svelte()],
  clearScreen: false,
  server: {
    host: host || false,
    port: 1420,
    strictPort: true,
    hmr: host
      ? {
          protocol: 'ws',
          host: host,
          port: 1430,
        }
      : undefined,
  },
});

Apoya en Open Collective Patrocina en GitHub