AppImage

AppImage es un formato de distribución que no depende de los paquetes instalados en el sistema y en su lugar empaqueta todas las dependencias y archivos necesarios para la aplicación. Por esta razón, el archivo resultante es más grande pero más fácil de distribuir, ya que es compatible con muchas distribuciones de Linux y se puede ejecutar sin instalación. El usuario solo necesita hacer que el archivo sea ejecutable (chmod a+x MyProject.AppImage) y luego puede ejecutarlo (./MyProject.AppImage).

Los AppImage son convenientes, simplificando el proceso de distribución si no puedes crear un paquete dirigido al gestor de paquetes de la distribución. Aún así, debes usarlo con cuidado ya que el tamaño del archivo aumenta del rango de 2-6 MB a más de 70 MB.

Limitaciones

Las bibliotecas fundamentales como glibc frecuentemente rompen la compatibilidad con sistemas más antiguos. Por esta razón, debes compilar tu aplicación Tauri utilizando el sistema base más antiguo que pretendas admitir y que también proporcione los paquetes requeridos de WebKitGTK 4.1 para Tauri v2. Ubuntu 22.04 y Debian 12 son ejemplos adecuados de referencia porque proporcionan libwebkit2gtk-4.1-dev desde sus repositorios estándar de paquetes. Compilar en un sistema base más nuevo puede aumentar la versión mínima de glibc requerida por tu aplicación, por lo que al ejecutarla en un sistema más antiguo, podrías enfrentarte a un error de tiempo de ejecución como /usr/lib/libc.so.6: version 'GLIBC_2.33' not found. Recomendamos usar un contenedor Docker o GitHub Actions para compilar tu aplicación Tauri para Linux.

Consulta los problemas tauri-apps/tauri#1355 y rust-lang/rust#57497, además de la guía de AppImage para obtener más información.

Soporte multimedia a través de GStreamer

Si tu aplicación reproduce audio/video, necesitas habilitar tauri.conf.json > bundle > linux > appimage > bundleMediaFramework. Esto aumentará el tamaño del paquete AppImage para incluir archivos adicionales de gstreamer necesarios para la reproducción de medios. Esta opción actualmente solo está totalmente admitida en sistemas de compilación Ubuntu. Asegúrate de que tu sistema de compilación tenga todos los plugins que tu aplicación pueda necesitar en tiempo de ejecución.

Archivos personalizados

Para incluir archivos personalizados en el AppImage que no quieras incluir mediante la característica resources de Tauri, puedes proporcionar una lista de archivos o carpetas en tauri.conf.json > bundle > linux > appimage > files. El objeto de configuración mapea la ruta dentro del AppImage a la ruta del archivo en tu sistema de archivos, relativa al archivo tauri.conf.json. Aquí tienes un ejemplo de configuración:

{
  "bundle": {
    "linux": {
      "appimage": {
        "files": {
          "/usr/share/README.md": "../README.md", // copies the ../README.md file to <appimage>/usr/share/README.md
          "/usr/assets": "../assets/" // copies the entire ../assets directory to <appimage>/usr/assets
        }
      }
    }
  }
}

AppImages para dispositivos basados en ARM

linuxdeploy, la herramienta de AppImage que usa Tauri, actualmente no admite la compilación cruzada de AppImages para ARM. Esto significa que los AppImage de ARM solo se pueden compilar en dispositivos ARM o emuladores.

Consulta nuestra guía de GitHub Actions para ver un ejemplo de flujo de trabajo que aprovecha QEMU para compilar la aplicación. Ten en cuenta que esto es extremadamente lento y solo se recomienda en repositorios públicos donde los minutos de compilación son gratuitos. En repositorios privados, los runners ARM de GitHub deberían ser más rentables y mucho más fáciles de configurar.

Apoya en Open Collective Patrocina en GitHub