Passer au contenu principal

Paquet Linux

Tauri applications for Linux are distributed either with a Debian bundle (.deb file) or an AppImage (.AppImage file). The Tauri CLI automatically bundles your application code in these formats by default. Please note that .deb and .AppImage bundles can only be created on Linux as cross-compilation doesn't work yet.

note

Les applications GUI sur macOS et Linux n'héritent pas des $PATH de vos dotfiles shell (.bashrc, .bash_profile, .zshrc, etc.). Check out Tauri's fix-path-env-rs crate to fix this issue.

Pour compiler et construire votre application Tauri en un seul exécutable, exécutez simplement la commande suivante :

npm run tauri build

Il construira votre frontend (si configuré, voir beforeBuildCommand), compilera le binaire Rust, collectera tous les binaires et ressources externes et enfin, produira des paquets et des installateurs spécifiques à la plateforme.

Limitation​

Les bibliothèques de base telles que glibc rompent fréquemment la compatibilité avec les anciens systèmes. Pour cette raison, vous devez construire votre application Tauri en utilisant le plus ancien système de base que vous comptez supporter. Un système relativement vieux comme Ubuntu 18.04 est plus adapté que Ubuntu 22.04, comme le binaire compilé sur Ubuntu 22.04 aura une exigence plus élevée de la version de la glibc, donc lorsque vous exécutez sur un ancien système, vous allez faire face à une erreur d'exécution comme /usr/lib/libc.so.6 : version 'GLIBC_2.33' introuvable. Nous vous recommandons d'utiliser un conteneur Docker ou des actions GitHub 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.

Base Debian​

Le paquet Debian généré par le bundler Tauri contient tout ce dont vous avez besoin pour envoyer votre application aux distributions Linux basées sur Debian, définissant les icônes de votre application, générant un fichier de bureau et spécifiant les dépendances libwebkit2gtk-4.0-37 et libgtk-3-0, ainsi que libappindicator3-1 si votre application utilise la barre d'état système.

Fichiers de configuration​

Tauri expose quelques configurations pour le paquet Debian au cas où vous auriez besoin de plus de contrôle.

Si votre application dépend des dépendances système supplémentaires, vous pouvez les spécifier dans tauri.conf.json > tauri > bundle > deb > depends.

Pour inclure des fichiers personnalisés dans le paquet Debian, vous pouvez fournir une liste de fichiers ou de dossiers dans tauri.conf.json > tauri > bundle > deb > files. L’objet de configuration peut prend un chemin dans le paquet Debian au chemin d’accès au fichier sur votre système de fichiers, par rapport au fichier tauri.conf.json. Voici un exemple de configuration :

{
  "tauri": {
    "bundle": {
      "deb": {
        "files": {
          "/usr/share/README.md": "../README.md", // copie le fichier README.md dans /usr/share/README.md
          "usr/share/assets": "../assets/" // copies toutes le dossier assets dans /usr/share/assets
        }
      }
    }
  }
}

Si vous avez besoin de regrouper des fichiers de manière multiplateforme, vérifiez les mécanismes ressource et sidecar de Tauri.

AppImage​

AppImage est un format de distribution qui ne repose pas sur les paquets installés par le système et qui regroupe à la place toutes les dépendances et les fichiers nécessaires à l'application. Pour cette raison, le fichier de sortie est plus grand mais plus facile à distribuer car il est supporté 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).

AppImages est pratique, simplifiant le processus de distribution si vous ne pouvez pas créer un paquet ciblant le gestionnaire de paquets de la distribution. Cependant, vous devriez l'utiliser avec précaution car la taille du fichier passe de 2 à 6 Mo à 70 Mo et plus.

caution

Si votre application lit l'audio/la vidéo, vous devez activer tauri.conf.json > tauri > bundle > appimage > bundleMediaFramework. This will increase the size of the AppImage bundle to include additional gstreamer files needed for media playback. This flag is currently only supported on Ubuntu build systems.