✎ tutoriel:installer_application_flatpak [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Tutoriel : installer une application avec Flatpak ======

Le système [[:Flatpak]] permet le déploiement de logiciels, la gestion de paquets et la virtualisation d'applications sur ordinateurs personnels. Il fournit un environnement isolé du reste du système (//sandbox//), où l'utilisateur peut faire fonctionner des applications de manière mieux sécurisée.

Ce tutoriel vous expliquera comment utiliser [[:Flatpak]] pour installer des logiciels.

{{ http://i.imgur.com/Ezy1wRU.png?600 |Les logiciels Eolie, Lollypop, GNOME Recipes et Peek sont distribués au format flatpak}}

===== Pré-requis =====

Il faut installer le paquet **[[:flatpak]]** (voir la page de l'application), et d'une connexion internet fonctionnelle.

Si vous désirez disposer des logiciels en format //flatpak// dans la [[:gnome-software|logithèque]], vous pouvez aussi installer :

* Ubuntu ou autre variante : **[[apt>gnome-software-plugin-flatpak]]**
  * Kubuntu : **[[apt>plasma-discover-flatpak-backend]]**

==== Niveaux de privilèges ====

La plupart des commandes liées à //flatpak// possèdent une option ''%%--user%%'', par opposition à l'option par défaut ''%%--system%%''.

L'option ''%%--user%%'' implique que la manipulation ne concerne que l'utilisateur courant. Cette option est détaillée [[#Installation pour un seul utilisateur|plus loin]], mais gardez à l'esprit que les manipulations qui suivent (ajout de dépôts, installation, désinstallation) peuvent être faites en utilisant cette option.

<note important>Les droits d'administration sont nécessaires si vous voulez ajouter des dépôts pour tout le système (c'est l'option par défaut), mais **ne tapez pas la commande ''sudo''** !

Une fenêtre s'ouvrira pour demander le mot de passe au moment où il sera nécessaire, et uniquement à ce moment là.</note>

===== Ajouter le dépôt flathub =====

Comme tous les gestionnaires de paquets, //flatpak// va chercher ce qu'il lui faut dans des dépôts, qui ne sont pas configurés par défaut, entre autres car ils sont **indépendants de la distribution**.
<note help>Le concept de dépôt flatpak est parfois désigné par le terme "remote" (ce qui signifie "à distance").</note>

Il existe divers dépôts Flatpak différents, le système ayant été pensé pour être décentralisé. La syntaxe générale de la commande est 
<code>flatpak remote-add --if-not-exists nom_du_dépôt https://adresse-du-dépôt.flatpakrepo</code>

La plupart des paquets Flatpak disponibles sont dans le dépôt **[[https://flathub.org/|flathub]]**, qui nous servira donc d'exemple :
<code>flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo</code>

<note>flathub.org est un dépôt indépendant de toute distribution et de tout environnement, il accueille des logiciels variés, venu de diverses fondations ou distributions ([[:KDE]], elementary, [[:GNOME]], [[:linux_mint|Mint]], etc.), mais aussi des logiciels indépendants.</note>

==== Autres dépôts ====

Parmi les dépôts notables et sécurisés, on peut remarquer celui des applications [[:GNOME]] :
<code>flatpak remote-add --if-not-exists gnome-apps https://sdk.gnome.org/gnome-apps.flatpakrepo</code>
et celui des applications [[:KDE]] :
<code>flatpak remote-add kdeapps --if-not-exists https://distribute.kde.org/kdeapps.flatpakrepo</code>

Les logiciels de ces environnements étant pour la plupart déjà dans les dépôts [[:apt]], et pour certains sur flathub, ces dépôts sont normalement superflus.
==== Paquets téléchargés hors-dépôts ====
Synaptic gère des paquets au format ''.deb'' **provenant de dépôts APT uniquement**.  \\ Il ne permet pas — dans sa configuration actuelle — l'installation d'un paquet téléchargé manuellement depuis un site Internet ou généré par vous-même. \\ Si vous cherchez à effectuer ces manipulations, lisez les sections suivantes ou utilisez plutôt [[:gdebi]].

=== Paquets téléchargés maunuellement ===

== Les paquets précompilés au format *.deb ==

Afin de gérer les paquets précompilés .deb que vous téléchargez manuellement ( par exemple **depuis les sites de confiance** **Sourceforge** ou **Github**) vous devez configurer l'application qui les installera par défaut. il s'agit de la Logithèque Ubuntu.

== Les paquets précompilés au format *.deb à l'aide de l'application Checkinstall ==

Contrairement à l'idée préconçue selon laquelle Synaptic serait incapable de gérer les sources compilés manuellement, **ceci est tout à fait possible à l'aide de l'application checkinstall**. \\
Cet utilitaire en ligne de commandes simplissime à utiliser compile les sources en C++ puis génère un paquet précompilé *.deb. \\
Cette procédure permet d'intégrer ensuite le paquet généré manuellement à la bibliothèque de Synaptic.

Pour de plus amples informations sur l'application Checkinstall, reportez vous au chapitre [[checkinstall|Checkinstall : Créer facilement un paquet debian (*.deb) à partir des sources]] de la documentation.

==== Formats de distribution alternatifs ====
Synaptic ne sait pas gérer les logiciels précompilés au format [[:Flatpak]] ni [[:snap|Snap]] ni [[:Appimage]] encore moins les applications hébergées sur [[wp>https://fr.wikipedia.org/wiki/GitHub|Github]]. \\ Si votre logithèque ne gère pas nativement ces formats, des procédures spécifiques à chaque format vous seront nécessaires.

=== Les nouveaux modules d'intégration à Ubuntu ===
Depuis Ubuntu 17.10, rétroportés sous 16.04, il existe des applications d'intégration des paquets **Flatpak**, **Snap**, **Appimage** et des application hébergées sur le Github. \\ Les procédures d’intégration diffèrent selon le paquet précompilé considéré.
  * Intégration de **Snap** dans la Logithèque Ubuntu : \\ le service snapd est désormais intégré aux distribution récentes d'Ubuntu. Pour gérer les Snaps depuis la logithèque, il vous suffit de vous rendre sur [[https://snapcraft.io/snap-store|la page officielle du Snapstore]] et de cliquer sur le bouton **[ install ]** ( Ubuntu 16.04 et suivantes ) <code bash>sudo snap install snap-store 
sudo apt-get update </code>
  * Intégration du dépôt officiel **Flathub** au sein de Synaptic : <code bash>
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo </code>
  * Intégration de **Flatpak** dans la logithèque Ubuntu : ( Ubuntu 16.04 et suivantes ) <code bash>sudo apt install gnome-software-plugin-flatpak
sudo apt-get update </code> \\ pour les autres gestionnaires de bureaux, se référer à la page « [[https://www.numetopia.fr/installation-et-utilisation-de-flatpak-sous-ubuntu/|Installation et utilisation de Flatpak sur Ubuntu]] » \\ — site : Numétopia.fr ; auteur : le tux masqué ; date : 21 août 2019 ; mise à jour : 6 novembre 2019. \\ 
    * Pour lister vos paquets Flatpak, entrez dans un [[terminal|Terminal]] : <code bash>
flatpak list </code>
    * Pour mettre à jour tous vos paquets Flatpak, entrez dans un [[terminal|Terminal]] : <code bash>
flatpak update </code>
  * Intégration de **Appimage** au sein des différentes interfaces graphiques d'Ubuntu : 
    * se référer à [[https://www.linuxuprising.com/2018/04/easily-run-and-integrate-appimage-files.html|Easily Run And Integrate AppImage Files With AppImageLauncher]]  \\ — site : Linuxuprising.com ; auteur : logix ; date : 17 juillet 2018.
    * télécharger le paquet précompilé *.deb sur la page Github dédiée « [[https://github.com/TheAssassin/AppImageLauncher/releases|Appimage Launcher release builds]] ».
  * Intégration de **Github Desktop** au sein des différentes interfaces graphiques d'Ubuntu : <code bash>sudo snap install github-desktop --edge </code> \\ Le paquet github-desktop permet de gérer son dépôt Github graphiquement dans une application intégrée au gestionnaire d'applications Ubuntu

<note>**Le projet précédent nommé __Appimaged__ est désormais déprécié**. \\
Ceci ne vous empêche nullement de l'utiliser en complément de Appimage Launcher. Pour l'installer **après avoir installé Appimage Launcher** :
<code bash>wget "https://github.com/AppImage/appimaged/releases/download/continuous/appimaged-x86_64.AppImage"</code>
rendez vous dans votre dossier personnel
<code bash> sudo chmod a+x appimaged-x86_64.AppImage</code>
<code bash>sudo ./appimaged-x86_64.AppImage --install</code>
</note>
===== Installation de logiciels =====

==== Les runtimes ====

Pour s'exécuter, les applications qu'on installera auront besoin d'un //runtime//.

Il s'agit, en bon français, d'une **routine d'environnement d'exécution**(([[wpfr>Environnement d'exécution]])) : dans le cas d'une application //ordinaire// (comprenez non précompilées aux formats flatpak ni aux formats [[:snap]]), l'environnement d'exécution est en fait votre système Ubuntu lui-même, ce qui implique un certain nombre de limitations, notamment en terme de compatibilité des versions.

Ne soyez pas donc surpris si une confirmation vous est demandée pour l'installation d'un //environnement d'exécution//.

<note important>L'installation d'une application est assez courte, mais celle d'un //environnement d'exécution// peut prendre une bonne minute ; heureusement, des applications distinctes utilisent souvent le même //environnement d'exécution//.</note>

=== Autres dépôts ===

<note important>si vous avez un message tel que « ''**flatub not found**'' », veuillez entrer au préalable :
<code bash>rm -rf /var/tmp/flatpak-cache-*</code> puis 
reprendre par exemple:
<code bash>flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo</code>
<code bash>flatpak install --user flathub org.gnome.Builder</code> pour installer le logiciel qui vous convient.</note>

Si vous voulez installer quelque chose depuis le dépôt ''gnome-apps'', il faudra **peut-être** au préalable ajouter le dépôt des environnements d'exécution exigés par les applications GNOME :
<code bash>flatpak remote-add --if-not-exists gnome https://sdk.gnome.org/gnome.flatpakrepo</code>

Si vous voulez installer quelque chose depuis le dépôt ''kdeapps'', il faudra **peut-être** au préalable ajouter le dépôt des environnements d'exécution exigés par les applications KDE :
<code bash>flatpak remote-add kderuntime --if-not-exists http://distribute.kde.org/kderuntime.flatpakrepo</code>

== Où trouver les routines d'environnement pour les applications hors dépôts (Flatpak et Appimage) ==

Si vous avez suivi les procédures d'intégrations décrites précédemment, il vous suffit de faire une recherche sur ''freedesktop'' et ''runtime'' dans votre logithèque.

La liste des runtimes disponibles se trouve dans la documentation du Flatpak, au chapitre « [[https://docs.flatpak.org/fr/latest/available-runtimes.html|Runtimes disponibles]] » —{routines d’environnement disponibles}

==== Dénommination des logiciels ====

Dans les dépôts (tous, pas seulement //flathub//), les applications sont identifiées par un nom qui suit un format normé, assez différent de ce qui se fait avec [[:apt]] (exemples) :

L'auto-complétion (double appui sur tab) sera souvent utile pour trouver le nom exact.

==== Installation depuis la logithèque Ubuntu====

{{ :tutoriel:flatpak-logitheque.png?400|Exemple avec l'application Pitivi.}}

Si vous avez suivi les prérequis, les logiciels sont disponibles depuis [[:gnome-software|la logithèque GNOME]] (ou la [[:plasma-discover|la logithèque KDE]] selon votre cas) et s'installent donc comme n'importe quel logiciel (ci-contre).

La version au format Flatpak se reconnaît grâce à l'URL de flathub.org écrite sous la description du logiciel.

~CB~

==== Installation depuis la logithèque Flathub ====

Le principal dépôt de logiciels au format flatpak est Flathub, qui dispose de sa propre logithèque, sous forme d'application web. Vous pouvez vous y rendre [[https://flathub.org/apps|ici]].

Il vous suffit de chercher l'application et de cliquer dessus pour l'installer.\\
{{:tutoriel:flatpak-flathub.png?500|La logithèque en ligne Flathub.}}
==== Installation en ligne de commande ====

Pour disposer de davantage d'options d'installation, vous préférerez peut-être passer par le [[:terminal]], où une simple ligne de commande suffira.

Exemple pour [[:Lollypop]] :
<code>flatpak install flathub org.gnome.Lollypop</code>

On peut mettre plusieurs noms d'applications dans la même commande :
<code>flatpak install flathub com.uploadedlobster.peek com.valvesoftware.Steam</code>

<note tip>Pour connaître l'identifiant de l'application avec certitude, utilisez l'auto-complétion, ou bien cherchez un mot-clé ou un nom de logiciel :
<code>flatpak search steam</code>
</note>

===== Options intéressantes =====

==== Installation depuis un fichier ====

Certains distributeurs de logiciels vont proposeront plutôt un fichier ''.flatpakref'' qui s'installe ainsi :

<code>flatpak install --from adresse/du/fichier.flatpakref</code>

L'adresse du fichier peut être le chemin du fichier parmi les documents sur votre disque, ou bien une adresse internet (URL).

Cette technique vous demandera, en cours d'installation, d'ajouter les dépôts nécessaires.

==== Installation pour un seul utilisateur ====

Ajouter l'option ''%%--user%%'' permet d'installer l'application uniquement pour l'utilisateur courant.

Exemple :

=== Ajouter le "remote" ===

Même quand ça a déjà été fait au niveau du système, il faut l'installer pour l'utilisateur courant :
<code>
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo</code>

<note help>Vous pouvez installer tous les remotes et tous les logiciels uniquement pour l'utilisateur courant, ainsi tout sera dans votre dossier personnel. Étant donné le volume potentiel de certains environnements d'exécution, il peut être pratique d'optimiser un peu où les installer.</note>

=== Installer le logiciel ===

<code>flatpak install --user flathub org.gnome.FeedReader
</code>

Cette commande va installer "FeedReader", un agrégateur de flux RSS pour l'environnement [[:GNOME]], mais **uniquement pour l'utilisateur courant**, les fichiers relatifs à cette application étant alors stockés dans ''~/.local/share/flatpak/app/org.gnome.FeedReader'' au lieu de ''/var/lib/flatpak/app/org.gnome.FeedReader'' comme ça aurait été le cas normalement.

===== Utiliser vos logiciels =====

Pour lancer graphiquement les applications installées, faites comme indiqué **[[tutoriel:comment_lancer_application|ici]]**.

Via le [[:terminal]], la [[:commande_shell|commande]] est :
<code>flatpak run nom.du.logiciel</code>

<note help>Pas la peine de préciser ''%%--user%%'' pour l'exécution des applications installées ainsi.</note>

===== Mise à jour =====

N'oubliez pas de mettre régulièrement à jour vos logiciels :

<code>flatpak update</code>

===== Désinstaller les logiciels =====

La commande est :
<code>flatpak uninstall nom.du.logiciel</code>

<note>Si vous avez installé avec l'option ''%%--user%%'', il faudra remettre cette option à la désinstallation.</note>

Si des environnements d'exécutions ou des données restent installées, utilisez la commande

<code>flatpak uninstall --unused</code>

Si plus aucun logiciel installé n'en provient, vous pouvez retirer le dépôt avec la commande

<code>flatpak remote-delete nom-du-depot</code>

===== Problèmes connus =====

==== Thèmes ====

Si votre logiciel n'a pas le bon thème, il est alors conseillé d'installer le thème depuis //flathub//. Exemples :

<code>flatpak install flathub org.gtk.Gtk3theme.Ambiance</code>
<code>flatpak install flathub org.gtk.Gtk3theme.Communitheme</code>
Pour lister les thèmes il suffit de taper la commande : 
<code>flatpak remote-ls flathub | grep org.gtk.Gtk3theme</code>
[[https://www.linuxuprising.com/2018/05/how-to-get-flatpak-apps-to-use-correct.html|Source]]
==== Emplacements inaccessibles ====

Si un emplacement n'est pas accessible à partir de l'application, n'hésitez pas à le rapporter comme un bug auprès du développeur de l'application (lien dans le "À propos" de l'application).

==== Traduction ====

Les traductions sont normalement installées avec l'application. Si ce n'est pas le cas, installez le paquet ayant le nom de l'application mais avec la terminaison ".Locale" :

<code>flatpak install flathub org.gnome.Games.Locale</code>

===== Voir aussi =====

* [[http://flatpak.org/|Site officiel flatpak.org]]
  * [[https://flathub.org/|L'accueil de flathub.org]]
  * [[:Paquet]]
  * La page dédiée à [[:Flatpak]]
  * **(en)** [[http://www.omgubuntu.co.uk/2017/07/7-flatpak-apps-can-install-right-now-flathub|article d'OMG Ubuntu à propos de l'installation de l'installation par flatpak]]
  * La "concurrence" : [[:apt ]], [[:snap]], [[:appimage]]
  * [[http://flatpak.org/apps.html|Applications disponibles sur flatpak.org]]
  * **(en)** [[https://community.kde.org/Guidelines_and_HOWTOs/Flatpak|Tutoriel pour installer les applications KDE]]

----

//Contributeurs : [[:utilisateurs/roschan]]
, ...//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : J M U B G Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported