{{tag>Noble Focal apt paquet gestionnaire_de_paquets logiciels installation_logiciel}}

====== AptUrl : Installer un paquet en un clic depuis une page web ======

L'application **AptUrl** gère le pseudo-protocole **apt** ([[:reseau#URI]] ''apt:%%//%%''), ce qui permet d'installer un [[:paquet]] logiciel avec [[:APT]] depuis un [[wpfr>hyperlien]].

Quand **AptUrl** est installé et configuré, un clic sur un lien ''apt:%%//%%'' démarre l'installation d'un ou de plusieurs paquets présents dans les [[:dépôts]] Ubuntu.\\
Sur ce wiki les liens de ce type sont précédés de l'icône ''[[apt>]]''.

{{ :applications:apturl_lucid2.png|Apt-url}}
Ainsi, lorsqu'un utilisateur d'Ubuntu clique sur le lien ''[[apt>gimp]]'' de cette page [[:Web]], **AptUrl** lance le [[:gestionnaire de paquets]] pour proposer l'installation du paquet ''gimp'' depuis [[:depots|les sources de paquets accessibles]]. Pour l'utilisateur, il n'y a pas besoin d'effectuer d'opération compliquée pour installer le paquet ; pour le rédacteur de la page, il n'y a pas besoin de documenter de procédure fastidieuse.

<note>
**AptUrl** n'a pas pour but de remplacer le système de [[:dépôts]] ni le [[:gestionnaire de paquets]] par défaut. C'est une méthode complémentaire qui s'inscrit par-dessus ceux-ci, qui exploite les ressources des dépôts et des gestionnaires existants (en reposant aussi sur [[:APT]]).
</note>

<note tip>
Pour des méthodes plus générales d'installation d'applications et de [[:paquet|paquets]], voir les pages :
  * [[:Installer une application]]
  * [[:Installer un paquet deb]]
  * [[:installation_non_standard_de_logiciel|Installation non standard d'applications]]
</note>

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

Pour que votre système puisse utiliser cette méthode d'installation de paquets, il vous faut disposer d'un navigateur compatible //(voir la liste ci-dessous)//.

===== Installation =====

**AptUrl** est installé par défaut sur Ubuntu ([[:GNOME]]) jusqu'à la version [[:focal|Focal 22.04]]. Pour les autres versions [[:deb#installer_un_paquet_deb|installer le paquet]] ''[[apt>apturl]]'' via la commande suivante :
  sudo apt install apturl

Une application similaire existe pour [[:KDE]], il s'agit de ''[[apt>apturl-kde]]''.

==== Choisir AptUrl comme gestionnaire de paquet lors d'un clic sur un lien apt ====

**AptUrl** peut se substituer au gestionnaire de paquet habituel et installer des paquets sur le système lors du clic sur un lien ''apt:%%//%%''.

Pour utiliser **AptUrl** comme gestionnaire de lien ''apt:%%//%%'', entrer dans un [[:terminal]] la commande suivante : <code>xdg-mime default apturl.desktop x-scheme-handler/apt</code>

Pour plus d'informations sur le choix des gestionnaires associés au pseudo-protocole **apt**, consulter la section [[:gestionnaire_de_paquets#choisir quel gestionnaire de paquet se lance avec les liens apt]].

===== Configuration =====

==== Firefox et Epiphany ====

{{ :applications:apturl_firefox_lucid2.png?300|Besoin d'activer les liens AptUrl ?}}

Cliquez sur ce lien : ''[[apt>gimp]]''. La fenêtre //Lancement de l'application// (ci-contre) apparaît. (Dans l'exemple ci-contre **AptUrl** est déjà sélectionné );
  * Si dans votre cas **AptUrl** n'est pas visible, cliquez sur le bouton //Choisir// -> //Ordinateur// -> répertoire ''/usr/bin'' -> fichier ''apturl''. Si ce fichier n'existe pas, voir le chapitre //[[#installation]]//.

Cocher //Se souvenir de mon choix// et valider.

Si ça ne fonctionne toujours pas, saisissez ''about:config'' (sans espace) dans la barre de navigation et rajoutez en faisant clic-droit puis //nouvelle// :

  * ''network.protocol-handler.app.apt'' en chaîne de caractères avec pour valeur ''/usr/bin/apturl'',
  * ''network.protocol-handler.app.apt+http'' en chaîne de caractères avec pour valeur ''/usr/bin/apturl'',
  * ''network.protocol-handler.warn-external.apt'' en valeur booléenne et mettez ''false'' comme valeur,
  * ''network.protocol-handler.warn-external.apt+http'' en valeur booléenne et mettez ''false'' comme valeur.
  *  Et éventuellement, une entrée //valeur booléenne// en saisissant (le nom de l'option) ''network.protocol-handler.expose.apt'' puis validez et et sélectionnez ''false'' comme valeur.

Cliquez ensuite sur le lien ''apt:%%//%%'' d'une application que vous voulez installer, choisissez l'application **AptUrl** dont le [[:chemins|chemin]] est ''/usr/bin/apturl'' pour l’ouvrir, cochez //Se souvenir de mon choix// et validez.

==== Konqueror ====

[[:tutoriel:comment_modifier_un_fichier|Créez le fichier]] ///usr/share/services/apt.protocol// en mode [[sudo|administrateur]] avec le contenu suivant : <file - apt.protocol>[Protocol]
exec=apturl "%u"
protocol=apt
input=none
output=none
helper=true
reading=true
writing=true</file>
Faites la même chose pour le fichier **apt+http.protocol** : <file - apt+http.protocol>[Protocol]
exec=apturl "%u"
protocol=apt+http
input=none
output=none
helper=true
reading=true
writing=true</file>

==== Opera ====
Si vous utilisez [[:Opera]], il suffit d'aller dans le //menu principal// puis //Réglages// puis //Préférences//. Cliquez sur l'onglet //Avancés// puis //Programmes//, et choisissez //Ajouter//. Dans //Protocole//, entrez **apt** et dans //Ouvrir avec une autre application//, entrez **/apturl**. Appuyez sur le bouton OK.

Si les modifications ne prennent pas effet immédiatement, redémarrez Opera.


====  Chromium et Google Chrome====
=== Version deb des depots ===
Si vous avez appliqué la commande proposée au début de cette page [[:Chromium]] utilisera sans aucune autre manipulation apt-url.
 
=== Version Snap ===

Chromium Snap ne permet pas actuellement de lancer des logiciels ( comme xdg-open) via des liens

===== Utilisation =====

On trouve sur ce [[:wiki]] des [[wpfr>hyperlien|liens]] du type ''[[apt>nom_du_paquet]]'' qui permettent d'installer le paquet en question une fois le protocole pris en charge par le système.

Lors de l'édition d'une page sur cette documentation, cette icône dans la barre d'outils permet de créer un lien de ce type :\\
{{apt.png}}

Le code généré pour le wiki est de la forme ''%%[[apt>%%//nom-du-paquet//]]'',\\
et l'[[:reseau#URI]] généré pour le [[:navigateur]] est de la forme ''apt:%%//%%//nom-du-paquet//''.

On peut aussi utiliser cet URI n'importe où, par exemple sur le [[:Web]] à la place d'une [[:web#URL]], en particulier sur le [[https://forum.ubuntu-fr.org/|forum]] ubuntu-fr : ''[url]apt:%%//%%//nom-du-paquet//[/url]''.

==== Installer un seul paquet ====

Pour installer, par exemple, le paquet ''[[:rar|unrar]]'' : ''%%[[apt>unrar]]%%'' -> [[apt>unrar]].

L'[[:reseau#URI]] correspondant pour ce paquet est : ''[[apt://unrar]]''.
 
==== Installer plusieurs paquets d'un coup ====

Il suffit de séparer les paquets par une virgule '','' : ''%%[[apt>unrar,vlc,vim]]%%'' -> [[apt>unrar,vlc,vim]].

==== Utiliser un dépôt alternatif ====

Il est aussi possible de spécifier un dépôt à utiliser pour installer le paquet en question avec un lien du type :\\
''%%[[apt>archive.canonical.com?package=skype?dist=bionic?section=commercial|dépôt commercial et Skype]]%%''

Tous les [[:dépôts]] conformes à la norme Debian peuvent être utilisés avec cette méthode.

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

  * [[:APT]]
  * [[https://git.launchpad.net/ubuntu/+source/apturl/tree/|sources]]

----
//[[:Contributeurs]] : [[:utilisateurs:Enchained]],[[:utilisateurs:jewome_62]],[[:utilisateurs:poupoul2]], [[:utilisateurs:Sallé]], [[:utilisateurs:mydjey]], [[:utilisateurs:krodelabestiole]].//