Waydroid

From NixOS Wiki
Revision as of 15:01, 8 May 2022 by imported>PedroHLC (Enable it through the service because of the environment; add the GApps support parameters; Teach how to know if it worked; Add GPU Adjustments)

WayDroid is an application which uses LXC containers to run Android applications on a non-Android system.

Warning: WayDroid requires a Wayland desktop session and cannot be used on X11.

Install:

We will need to enable the WayDroid and LXD options (the WayDroid module enables LXC).

 
/etc/nixos/configuration.nix
{ pkgs, ... }:
{
  virtualisation = {
    waydroid. enable = true;
    lxd.enable = true;
  };
}

You'll need to finish the WayDroid install in your shell.

# Rebuild NixOS config.
nixos-rebuild switch

# Fetch WayDroid images.
# You can add the parameters "-s GAPPS -f" to have GApps support.
sudo waydroid init

# Before the following steps, you might need to do some GPU adjustments. See the next section.

# Start the WayDroid LXC container
sudo systemctl start waydroid-container
# You'll know it worked by checking the journal You should see "Started Waydroid Container".
sudo journalctl -u waydroid-container

# Start WayDroid session
# You'll know it is finished when you see the message "Android with user 0 is ready".
waydroid session start

GPU Adjustments

In case you have an NVIDIA card or an RX 6800 series, you'll need to disable GBM and mesa-drivers:

 
/var/lib/waydroid/waydroid_base.prop
ro.hardware.gralloc=default
ro.hardware.egl=swiftshader

Usage

# Start Android UI
waydroid show-full-ui
# Start an Android app
waydroid app start <application name>
# Install an Android app
waydroid app install </path/to/app.apk>
# List Android apps
waydroid app list
# Enter the LXC shell
sudo waydroid shell

See Also:

Arch Wiki