AppImage

AppImage est un format de distribution qui ne dépend pas des paquets installés sur le système et regroupe à la place toutes les dépendances et les fichiers nécessaires à l’application. Pour cette raison, le fichier de sortie est plus volumineux mais plus facile à distribuer car il est pris en charge sur de nombreuses distributions Linux et peut être exécuté sans installation. L’utilisateur a juste besoin de rendre le fichier exécutable (chmod a+x MyProject.AppImage) et peut ensuite l’exécuter (./MyProject.AppImage).

Les AppImages sont pratiques, simplifiant le processus de distribution si vous ne pouvez pas créer de paquet ciblant le gestionnaire de paquets de la distribution. Cependant, vous devez l’utiliser avec précaution car la taille du fichier passe de la plage de 2 à 6 Mo à 70 Mo et plus.

Limitations

Les bibliothèques de base telles que glibc rompent fréquemment la compatibilité avec les systèmes plus anciens. Pour cette raison, vous devez construire votre application Tauri en utilisant le système de base le plus ancien que vous avez l’intention de prendre en charge. Un système relativement ancien tel qu’Ubuntu 18.04 est plus adapté qu’Ubuntu 22.04, car le binaire compilé sur Ubuntu 22.04 aura une exigence plus élevée de la version glibc, donc lors de l’exécution sur un système plus ancien, vous serez confronté à une erreur d’exécution comme /usr/lib/libc.so.6: version 'GLIBC_2.33' not found. Nous vous recommandons d’utiliser un conteneur Docker ou GitHub Actions pour construire votre application Tauri pour Linux.

Voir les problèmes tauri-apps/tauri#1355 et rust-lang/rust#57497, en plus du guide AppImage pour plus d’informations.

Support multimédia via GStreamer

Si votre application lit de l’audio/vidéo, vous devez activer tauri.conf.json > bundle > linux > appimage > bundleMediaFramework. Cela augmentera la taille du bundle AppImage pour inclure des fichiers gstreamer supplémentaires nécessaires à la lecture multimédia. Ce drapeau n’est actuellement entièrement pris en charge que sur les systèmes de construction Ubuntu. Assurez-vous que votre système de construction possède tous les plugins dont votre application peut avoir besoin au moment de l’exécution.

Fichiers personnalisés

Pour inclure des fichiers personnalisés dans l’AppImage que vous ne souhaitez pas inclure via la fonctionnalité resources de Tauri, vous pouvez fournir une liste de fichiers ou de dossiers dans tauri.conf.json > bundle > linux > appimage > files. L’objet de configuration mappe le chemin dans l’AppImage au chemin vers le fichier sur votre système de fichiers, relatif au fichier tauri.conf.json. Voici un exemple de configuration :

{
  "bundle": {
    "linux": {
      "appimage": {
        "files": {
          "/usr/share/README.md": "../README.md", // copie le fichier ../README.md vers <appimage>/usr/share/README.md
          "/usr/assets": "../assets/" // copie tout le répertoire ../assets vers <appimage>/usr/assets
        }
      }
    }
  }
}

AppImages pour les appareils basés sur ARM

linuxdeploy, l’outil AppImage utilisé par Tauri, ne prend actuellement pas en charge la compilation croisée des AppImages ARM. Cela signifie que les AppImages ARM ne peuvent être construites que sur des appareils ou des émulateurs ARM.

Consultez notre guide GitHub Action pour un exemple de workflow qui exploite QEMU pour construire l’application. Notez que c’est extrêmement lent et recommandé uniquement dans les dépôts publics où les minutes de construction sont gratuites. Dans les dépôts privés, les runners ARM de GitHub devraient être plus rentables et beaucoup plus faciles à configurer.

Support on Open Collective Sponsor on GitHub