wiki:os:gnu_linux:debian:tutos:emulation:waydroid [Wiki Ordunix.net]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Android sous GNU/Linux via Waydroid avec Wayland ======
Logo de **Waydroid** : {{ :wiki:os:gnu_linux:debian:tutos:emulation:waydroid_white_tb.png?nolink&300 |}}

Site officiel de Waydroid :
  * [[https://waydro.id/|Waydroid]]

===== Présentation de Waydroid =====
**Waydroid** permet d'exécuter **Android** et ces applications via la virtualisation par conteneurisation (**LXC**) sous **GNU/Linux**. La rom Android utilisé par Waydroid est **LineageOS** qui se base sur **Android AOSP** (comme les ''3/4'' des //roms customs//).  Par défaut, la version de LineageOS est **LineageOS 18.1** qui correspond à **Android 11**.

<note important>Pour pouvoir exécuter Waydroid, il vous faut un environnement de bureau ou gestionnaire de fenêtres compatible avec **Wayland**. Pour cette raison vous ne pouvez pas utiliser Waydroid avec une carte graphique **NVIDIA** qui nécessite le pilote ''propriétaire'', car ce pilote est pour le moment uniquement compatible avec un //serveur X11//, comme **X.Org**.</note>

Pour la suite de ce tuto, je vais utiliser l'utilitaire [[wiki:os:gnu_linux:tutos:admin:sudo|sudo]] pour les tâches administratives.

Pour installer sudo, vous connectez en tant que //root// :
<code user>su -</code>entrez votre mot de passe root.

Installez sudo en tant que root :
<code root>apt-get install sudo</code>

Ajoutez votre //utilisateur// au //groupe// sudo :
<code root>adduser nom_user sudo</code>puis tapez la commande **exit** pour vous déconnectez du compte //root//.

===== Installer Waydroid sous Debian =====
Installez les paquets nécessaires à l'installation de Waydroid :
<code user>sudo apt-get install curl ca-certificates</code>

==== Via script Waydroid ====
Utiliser le [[wiki:os:gnu_linux:debian:tutos:emulation:waydroid:script]] Waydroid comme préconisé par le projet Waydroid :
<code user>curl -s https://repo.waydro.id | sudo bash</code>

Installation du paquet Waydroid :
<code user>sudo apt-get install waydroid</code>

==== Par la méthode traditionnelle ====
Définir la variable **$DISTRO** :
<code user>export DISTRO=$(source /etc/os-release;echo $VERSION_CODENAME)</code>

Ajouter le ''dépôt'' Waydroid :
<code user>sudo curl --proto '=https' --tlsv1.2 -Sf https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg</code>ensuite :
<code user>echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ $DISTRO main" | sudo tee /etc/apt/sources.list.d/waydroid.list</code>puis :
<code user>sudo apt-get update</code>et enfin :
<code user>sudo apt-get install waydroid</code>

===== Initialisation de Waydroid et choix de la version de LineageOS =====
1. Vous devez lancer ''Waydroid'' avec votre interface graphique via votre menu ''Applications''.

2. Ensuite, dès que la fenêtre ''Waydroid'' s'ouvre, il vous faut choisir entre LineageOS ''VANILLA'' ou ''GAPPS''.

Fenêtre ''Waydroid'' avec version ''VANILLA'' : {{ :wiki:os:gnu_linux:debian:tutos:emulation:capture_d_ecran_du_2025-04-03_21-24-18.png?nolink&400 |}}
 
Fenêtre ''Waydroid'' avec version ''GAPPS'' : {{ :wiki:os:gnu_linux:debian:tutos:emulation:capture_d_ecran_du_2025-04-03_21-24-27.png?nolink&400 |}}

3. LineageOS ''VANILLA'' est une version minimale sans les **services Google** alors que la version ''GAPPS'', est une image complète de LineageOS, avec les **applications Google**. Une fois que vous avez fait votre choix, il faut cliquer sur ''Download''.

<note>Sachez tout de même que la version ''VANILLA'' ne dispose pas du //Play Store//, donc si vous avez besoin d'applications bien spécifiques (uniquement disponible sur le //Play Store//), choisissez la version ''GAPPS''.</note>

4. Une fois l'image Android (LineageOS) téléchargée, cliquez sur ''Done''.  

===== Utilisation et configuration de Waydroid =====
Suite à l'installation de LineageOS, il faut démarrer le conteneur Waydroid :
<code user>sudo waydroid container start</code>

<note>Vous pouvez vérifier si votre conteneur Waydroid est actif via la commande : <code user>sudo service waydroid-container status</code></note>

Vous devez désormais lancer la session Waydroid :
<code user>waydroid session start</code>pour stopper la ''session'', remplacer l'option ''start'' par ''stop''.

<note>En principe vous n'avez pas besoin d'exécuter ces deux commandes.</note>

Vous aurez normalement un menu ''Applications'' > ''Waydroid'', contenant toutes les //applications Android// installées (selon votre environnement de bureau ou gestionnaire de fenêtres).

==== Utilisation de Waydroid via son interface graphique ====
Si vous souhaitez lancer LineageOS (Android) dans son ensemble allez dans :
  * ''Applications'' > ''Waydroid'' > ''Waydroid''.

À partir de la fenêtre //Waydroid//, vous pouvez lancer et installer n'importe quelle application sous //LineageOS//.

==== Utilisation de Waydroid via son interface en ligne de commande ====
  * La principale //commande// est : <code user>waydroid app option_de_la_commande</code>
  * Pour avoir la liste des //options// disponibles : <code user>waydroid app -h</code>affiche : <file>usage: waydroid app [-h] {install,remove,launch,list} ...

optional arguments:
  -h, --help            show this help message and exit

subaction:
  {install,remove,launch,list}
    install             push a single package to the container and install it
    remove              remove single app package from the container
    launch              start single application
    list                list installed applications</file>
  * Pour //installer// une application Android : <code user>waydroid app install chemin_vers_fichier.apk</code>
<note>Le //chemin// du fichier ''.apk'' peut être un //chemin// ''local'' ou une ''URL''.</note> 
  * Pour //supprimer// une application : <code user>waydroid app remove nom_application</code>
  * Pour //lancer// une application : <code user>waydroid app launch nom_application</code>
  * Pour //lister// les applications installées : <code user>waydroid app list</code>

<note>Je vous suggère d'installer le //Store// **F-Droid**, qui contient uniquement des applications Android **open source**, ce //Store// est une petite pépite. Pour l'installer : <code user>waydroid app install https://f-droid.org/F-Droid.apk</code></note>