AppImage

AppImage es un formato de distribución que no depende de gestores de paquetes del sistema, sino que agrupa todas las dependencias y archivos que la aplicación necesita. Por lo tanto, el archivo de salida es más grande, pero es más fácil de distribuir porque es compatible con muchas distribuciones de Linux y se puede ejecutar sin instalación. El usuario solo necesita hacer el archivo ejecutable (chmod a+x MyProject.AppImage) y luego puede ejecutarlo (./MyProject.AppImage).

AppImage es muy conveniente si no puedes crear un paquete para el gestor de paquetes de tu distribución, ya que simplifica el proceso de distribución. Sin embargo, debes usarlo con precaución, ya que el tamaño del archivo aumentará de 2-6 MB a 70+ MB.

Limitaciones

Las bibliotecas centrales como glibc a menudo rompen la compatibilidad con sistemas antiguos. Por lo tanto, debes construir tu aplicación Tauri utilizando el sistema base más antiguo que planeas admitir. Un sistema relativamente antiguo como Ubuntu 18.04 es más adecuado que Ubuntu 22.04, ya que los binarios compilados en Ubuntu 22.04 tienen requisitos de versión más altos para glibc y encontrarás errores de tiempo de ejecución como /usr/lib/libc.so.6: version 'GLIBC_2.33' not found cuando se ejecutan en sistemas antiguos. Recomendamos usar contenedores Docker o GitHub Actions para construir tu aplicación Tauri para Linux.

Para más información, consulta los issues tauri-apps/tauri#1355 y rust-lang/rust#57497, y la guía de AppImage.

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 los archivos adicionales de gstreamer necesarios para la reproducción multimedia. Esta bandera actualmente solo es totalmente compatible en sistemas de compilación de Ubuntu. Asegúrate de que tu sistema de compilación tenga todos los complementos que tu aplicación pueda necesitar en tiempo de ejecución.

Archivos Personalizados

Para incluir archivos personalizados en AppImage que no quieres incluir a través de la función 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 rutas en AppImage a rutas de archivos en el sistema de archivos (relativas al archivo tauri.conf.json). Aquí tienes un ejemplo de configuración:

{
  "bundle": {
    "linux": {
      "appimage": {
        "files": {
          "/usr/share/README.md": "../README.md", // copia ../README.md a <appimage>/usr/share/README.md
          "/usr/assets": "../assets/" // copia todo el directorio ../assets a <appimage>/usr/assets
        }
      }
    }
  }
}

AppImages para Dispositivos Basados en ARM

linuxdeploy (la herramienta de AppImage que usa Tauri) actualmente no soporta compilación cruzada de AppImages ARM. Esto significa que los AppImages ARM solo se pueden construir en dispositivos ARM o emuladores.

Consulta nuestra guía de GitHub Action para obtener un flujo de trabajo de ejemplo que utilice QEMU para construir tu aplicación. Ten en cuenta que esto es muy lento y solo se recomienda para repositorios públicos con minutos de construcción gratuitos. En repositorios privados, los runners ARM de GitHub deberían ser más rentables y fáciles de configurar.

Support on Open Collective Sponsor on GitHub