wiki:os:gnu_linux:debian:tutos:emulation:waydroid

Android sous GNU/Linux via Waydroid avec Wayland

Logo de Waydroid :

Site officiel 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.

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.

Pour la suite de ce tuto, je vais utiliser l'utilitaire sudo pour les tâches administratives.

Pour installer sudo, vous connectez en tant que root :

su -

entrez votre mot de passe root.

Installez sudo en tant que root :

apt-get install sudo

Ajoutez votre utilisateur au groupe sudo :

adduser nom_user sudo

puis tapez la commande exit pour vous déconnectez du compte root.

Installez les paquets nécessaires à l'installation de Waydroid :

sudo apt-get install curl ca-certificates

Utiliser le script Waydroid comme préconisé par le projet Waydroid :

curl -s https://repo.waydro.id | sudo bash

Installation du paquet Waydroid :

sudo apt-get install waydroid

Définir la variable $DISTRO :

export DISTRO=$(source /etc/os-release;echo $VERSION_CODENAME)

Ajouter le dépôt Waydroid :

sudo curl --proto '=https' --tlsv1.2 -Sf https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg

ensuite :

echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ $DISTRO main" | sudo tee /etc/apt/sources.list.d/waydroid.list

puis :

sudo apt-get update

et enfin :

sudo apt-get install waydroid

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 :

Fenêtre Waydroid avec version GAPPS :

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.

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.

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

Suite à l'installation de LineageOS, il faut démarrer le conteneur Waydroid :

sudo waydroid container start
Vous pouvez vérifier si votre conteneur Waydroid est actif via la commande :
sudo service waydroid-container status

Vous devez désormais lancer la session Waydroid :

waydroid session start

pour stopper la session, remplacer l'option start par stop.

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

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

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.

  • La principale commande est :
    waydroid app option_de_la_commande
  • Pour avoir la liste des options disponibles :
    waydroid app -h

    affiche :

    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
  • Pour installer une application Android :
    waydroid app install chemin_vers_fichier.apk
Le chemin du fichier .apk peut être un chemin local ou une URL.
  • Pour supprimer une application :
    waydroid app remove nom_application
  • Pour lancer une application :
    waydroid app launch nom_application
  • Pour lister les applications installées :
    waydroid app list
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 :
waydroid app install https://f-droid.org/F-Droid.apk
  • wiki/os/gnu_linux/debian/tutos/emulation/waydroid.txt
  • Dernière modification : 2025/04/04 14:08
  • de Thibault Seguin