{{tag>BROUILLON}}
----
{{ :applications:waydroid_icon_sm.png?80}}
====== Waydroid ======
Créée en 2021, il s'agit d'une solution nouvelle, en cours de développement, basée sur un container intégré permettant de démarrer un système Android complet au sein d'un système GNU/Linux ordinaire comme Ubuntu. WayDroid est la contraction des mots "Wayland" et "Android". L'environnement d'exécution Android fonctionne sur le mode Wayland et est livré avec une image système Android personnalisée minimale basée sur LineageOS. WayDroid peut être utilisé en mode intégré (les apps Android se trouvent dans le menu GNOME avec les autres logiciels), en version multi-fenêtres, ou encore en mode "Full UI" (on ouvre une fenêtre Android à part entière). La version actuelle est basée sur Android 11. A noter que WayDroid n'est pour l'instant pas compatible avec les pilotes propriétaires Nvidia.
===== Pré-requis =====
* Avoir activé [[Wayland]].
* Avoir [[:tutoriel:comment_installer_un_paquet|installé les paquets]] **[[apt>curl,ca-certificates|curl ca-certificates]]** pour pouvoir ajouter la source nécessaire à l’installation.
* Connaître la [[versions|version]] installée et le nom de code de développement correspondant qu'on trouve dans la fichier [[sources.list]]
===== Installation =====
Pour installer ce logiciel, il faut ajouter les sources nécessaires puis on pourra effectuer l’installation.
Définir la variable DISTRO avec le nom de code de développement de la version installée, par exemple pour **jammy** :
export DISTRO=$(source /etc/os-release;echo $VERSION_CODENAME)
Autres codes de développement possibles : focal, jammy, ubuntu-devel, bookworm, bullseye, sid
Ajouter les sources nécessaires :
sudo curl --proto '=https' --tlsv1.2 -Sf https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg
echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ $DISTRO main" | sudo tee /etc/apt/sources.list.d/waydroid.list
sudo apt update
Puis [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>waydroid|waydroid]]** :
sudo apt install waydroid
===== Installation via le script officiel: =====
1-Installez curl:
sudo apt install curl
2- Après l'installation de curl, lancez le script d'installation depuis le site officiel avec curl:
curl -s https://repo.waydro.id/ | sudo bash
3- Le script terminé, installez le paquet WayDroid:
sudo apt install waydroid
===== Configuration =====
==== Basique ====
Lancer Waydroid directement dans les applications. Lors de la première utilisation une fenêtre de configuration apparaîtra. Cliquez sur "Download" afin de télécharger une version légère de Lineage OS.
{{:waydroid_installation_initiale.png?nolink&400|Fenêtre d'installation initiale de Waydroid}}
==== Réseau ====
Sous Waydroid 1.4.1 avec Ubuntu 22.04 la connexion à internet ne fonctionne pas ((Solution pour l'absence de connexion réseau : [[https://github.com/waydroid/waydroid/issues/143#issuecomment-1520857943|Issue "No internet in waydroid" sur le repo GitHub de Waydroid]])) à cause d'une erreur dans un fichier de configuration. Pour corriger ceci :
sudo sed -i~ -E 's/=.\$\(command -v (nft|ip6?tables-legacy).*/=/g' \
/usr/lib/waydroid/data/scripts/waydroid-net.sh
==== Etendu ====
En l'état, Waydroid est minimaliste. Il ne permet pas par exemple de lancer une application compilée pour un processeur ARM (cas de la majorité des applications) sur un processeur x86.
Pour disposer de fonctions étendues, [[https://github.com/casualsnek/waydroid_script|un script]] facilite l'installation de la translation ARM, du support des applications google et d'autres fonctions.
* [[:tutoriel:comment_installer_un_paquet|installer les paquets]] **[[apt>git,python3|git python3]]**
mkdir ~/Waydroid # Création d'un dossier pour Waydroid. Optionnel
cd ~/Waydroid
git clone https://github.com/casualsnek/waydroid_script
cd waydroid_script
sudo python3 -m pip install -r requirements.txt
sudo python3 main.py
===== Utilisation =====
Des raccourcis sont créés pour le bureau de l'application mais aussi des applications installées dans android.
==== En ligne de commande ====
Via le [[:terminal]] avec les [[:commande_shell|commandes]] décrites ci-dessous
* Démarrer une session waydroid session start
* Arrêter une session waydroid session stop
=== Applications Android ===
Attention : pour qu'une application compilée en ARM soit fonctionnelle sur un ordinateur avec un processeur x86 fonctionne, il faut certaines extensions (voir chapitre configuration).
* Installer une application depuis un apk waydroid app install *chemin_vers_app*
* Trouver la liste des applications installée waydroid app list
* Lancer une application waydroid app launch *nom_package_trouvee_dans_liste*
Exemple : installer le magasin d'application libre [[https://f-droid.org/fr/|F-Droid]].
- Créer un dossier pour les opérations de Waydroid
mkdir ~/Waydroid
cd ~/Waydroid
- Télécharger l'[[https://f-droid.org/F-Droid.apk|APK de F-Droid]] wget https://f-droid.org/F-Droid.apk
- (si pas déjà fait) lancer une session de Waydroid waydroid session up &
- Installer l'application waydroid app install F-Droid.apk
- Trouver le nom du package de l'application dans la liste waydroid app list | grep fdroid
- Lancer l'application à l'aide du package name waydroid app launch org.fdroid.fdroid
A noter qu'un raccourci pour lancer directement l'application est installé dans Gnome
===== Désinstallation =====
Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
===== Voir aussi =====
* **(en)** [[https://waydro.id/|Site officiel de Waydroid]] et sa [[https://docs.waydro.id/|documentation]] incluant des [[https://docs.waydro.id/usage/install-on-desktops#ubuntu-debian-and-derivatives|instructions d'installation pour Ubuntu]].
* **(en)** [[https://github.com/waydroid/waydroid|Dépôt GitHub de Waydroid]]
* [[https://forum.ubuntu-fr.org/viewtopic.php/viewtopic.php?id=2063037|Discussion « Applications Android sur Ubuntu Touch (WayDroid) »]] sur le forum Ubuntu-fr
* **(en)** [[https://wiki.archlinux.org/title/Waydroid|Waydroid sur le Wiki Arch Linux]]
* **(en)** [[https://github.com/casualsnek/waydroid_script|Scripts pour faciliter l'installation spécifique (support ARM...)]]
----
//Contributeurs principaux : [[utilisateurs:AdeDidou|Adeline]], [[utilisateurs:chmilblick|chmilblick]].//