Différences

Ci-dessous, les différences entre deux révisions de la page.

--- sysadmin:linux:format_appimage [2022/03/12 16:06] – Ajout tag image yoann
+++ sysadmin:linux:format_appimage [2025/11/23 15:41] (Version actuelle) – [Erreur "The SUID sandbox helper binary was found, but is not configured correctly."] yoann
@@ Ligne 6: / Ligne 6: @@
 De nombreux logiciels sont à présent proposés sous ce format et téléchargeables directement sur les sites web appartenant auteurs/développeurs.
+<note>
+Les versions récentes d'Ubuntu intègrent un système équivalent : [[sysadmin/linux/snap| Snap]]
+</note>
 Puisque l'application est autonome, elle n'est pas intégrée au système de paquetage de la distribution GNU/Linux, elle doit être mise à jour par l'utilisateur ou intégrer son propre système de notification de mises à jours.
@@ Ligne 25: / Ligne 29: @@
 ===== Gestion des fichiers AppImage =====
-Plusieurs logiciels proposent d'assister l'utilisateur dans la gestion des AppImages:
+Plusieurs logiciels proposent d'assister l'utilisateur dans la gestion des paquets AppImages (notamment pour les intégrer dans l'environnement de bureau virtuel):
-  * **AppImageLauncher**: Permet de générer les lanceurs dans la plupart des environnements de bureaux virtuels.
+  * **[[software/applications/appimagelauncher|AppImageLauncher]]**: Permet de générer les lanceurs dans la plupart des environnements de bureaux virtuels.
   * **App Outlet**: équivalent d'un market ou d'un store agnostique aux distributions proposant tous types d'applications portables aux formats AppImage, Flatpak ou Snap.
   * **AppImage installer**: CLI télécharge et intègre les fichiers AppImage à l'environnement de bureau virtuel.
+===== Prérequis : fuse =====
+Sur de nombreuses distributions, il est **nécessaire** d'installer le composant [[https://github.com/AppImage/AppImageKit/wiki/FUSE|fuse (Filesystem in UserSpacE)]] pour pouvoir exécuter les applications AppImage.
+Dans l'exemple ci-dessous la tentative d'exécution d'une application AppImage retourne une erreur :
+<code bash>
+./FreeCAD-0.21.2-Linux-x86_64.AppImage
+dlopen(): error loading libfuse.so.2
+AppImages require FUSE to run.
+You might still be able to extract the contents of this AppImage
+if you run it with the --appimage-extract option.
+See https://github.com/AppImage/AppImageKit/wiki/FUSE
+for more information
+</code>
+Le système n'arrive pas à charger la bibliothèque fuse en version 2. Sur les versions Ubuntu récentes (>= 22.04), le système est livré avec fuse en version 3.
+<code bash>
+# Affiche la version du système
+cat /etc/os-release | grep VERSION_ID
+VERSION_ID="23.10"
+# Affiche la version du paquet fuse
+dpkg -l | grep fuse
+ii    fuse3    3.14.0-4    amd64    Filesystem in Userspace (3.x version)
+</code>
+Pour installer la bibliothèque fuse2 :
+<code bash>
+sudo add-apt-repository universe
+sudo apt install libfuse2
+</code>
+===== Manipulation du format AppImage =====
+==== Extraction des fichiers ====
+Il est possible d'extraire les fichiers du paquet AppImage avec l'option **%%--appimage-extract%%**
+<code bash>
+# Extraction des fichiers de l'image dans le dossier courant
+./myImage.AppImage --appimage-extract
+</code>
+==== Créer un fichier AppImage =====
+:TODO:
+==== Exécution hors sandbox ====
+Normalement les images s'exécutent dans un environnement confiné (sandbox).
+Dans certains cas il peut être utile de lancer l'application sans confinement. Pour cela ajouter l'argument **%%--no-sandbox%%** sur la ligne de commande :
+<code bash>
+./Joplin-3.4.12.AppImage --no-sandbox
+</code>
+===== Raccourcis / Lanceurs =====
+Pour créer un  raccourcis sur le bureau virtuel, confère le wiki [[sysadmin:linux:creer_icone_bureau_linux| créer un icône (lanceur)]].
+===== Dépannage =====
+==== Erreur "The SUID sandbox helper binary was found, but is not configured correctly." ====
+Certaines applications refusent de se lancer et retourne un message du type :
+<file>
+The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /tmp/.mount_pia-3.vvemOE/chrome-sandbox is owned by root and has mode 4755.
+</file>
+ Deux possibilités :
+  * Lancer l'application avec l'option ''%%--no-sandbox%%'' (non recommandé) ;
+  * Décompresser l'archive AppImage et corriger le problème de droit ;
+Pour corriger le problème lié au droit, décompresser l'archive AppImage et modifier les droits sur le fichier **chrome-sandbox** présent à la racine de l'arborescence de l'application :
+<code bash>
+# Créer un répertoire dédié pour l'application
+mkdir pia
+# Déplacer l'image dans le répertoire
+mv pia-3.0.3.AppImage pia
+# Décompresser l'image
+cd pia
+./pia-3.0.3.AppImage --appimage-extract
+# Modifier les droits du fichier chrome-sandbox
+cd squashfs-root/
+sudo chown root: chrome-sandbox
+sudo chmod 4755 chrome-sandbox
+</code>
+Pour lancer l'application, invoquer le script AppRun
+<code bash>
+./AppRun
+</code>
+Ce problème a été rencontré notamment pour les applications suivantes :
+  * Pia ;
+  * [[software:applications:etcher| Balena Etcher]] ;
+  * [[software:applications:joplin:000_start|Joplin]]
 ===== Références =====
-  * https://appimage.org/
+  * [[https://appimage.org/|Site officiel AppImage (appimage.org) ]]
+  * [[https://docs.appimage.org/index.html|Documentation sur le format AppImage (appimage.org)]]
+  * [[https://github.com/AppImage/AppImageKit|Outil de construction des paquets AppImage (github.com)]]
   * https://www.appimagehub.com/
   * https://www.numetopia.fr/comment-installer-et-utiliser-des-appimage-sous-linux/
   * https://www.youtube.com/watch?v=dhhXbus-INw

wikinotes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page