Jump to content

Waydroid: Difference between revisions

From postmarketOS Wiki
m Newbyte moved page WayDroid to Waydroid over redirect: WayDroid seems to have been an old way of writing it, never mind
Grammar fixes
Line 1: Line 1:
{{note|Consider using native Linux programs instead, see [[FAQ]].}}
{{note|Consider using native Linux programs instead, see [[FAQ]].}}


[https://github.com/waydroid/ Waydroid] is the modern approach to run Android apps on Linux. It is similar to [[Anbox]], but it works with wayland and is more performance efficient. As of writing, waydroid is available in Alpine Linux and postmarketOS edge, but it is in an experimental stage.
[https://github.com/waydroid/ Waydroid] is the modern approach to run Android apps on Linux. It is similar to [[Anbox]], but it works with Wayland and is more performant. As of writing, Waydroid is available in Alpine Linux and postmarketOS edge, but it is in an experimental stage.


== Installation ==
== Installation ==
Line 9: Line 9:


== Usage ==
== Usage ==
After installation, the waydroid session is configured to start automatically on boot.
After installation, the Waydroid session is configured to start automatically on boot.


In order to run apps, the container needs to be started as well. (Apparently it should start automatically when running apps? Also it appears to take quite some time to start up.)
In order to run apps, the container needs to be started as well. (Apparently it should start automatically when running apps? Also it appears to take quite some time to start up.)
Line 27: Line 27:
</syntaxhighlight>
</syntaxhighlight>


Use the following command to inspect the status of waydroid:
Use the following command to inspect the status of Waydroid:
<syntaxhighlight lang="shell-session">
<syntaxhighlight lang="shell-session">
$ waydroid status
$ waydroid status

Revision as of 17:41, 12 September 2021

Note Consider using native Linux programs instead, see FAQ.

Waydroid is the modern approach to run Android apps on Linux. It is similar to Anbox, but it works with Wayland and is more performant. As of writing, Waydroid is available in Alpine Linux and postmarketOS edge, but it is in an experimental stage.

Installation

$ sudo apk add waydroid

Usage

After installation, the Waydroid session is configured to start automatically on boot.

In order to run apps, the container needs to be started as well. (Apparently it should start automatically when running apps? Also it appears to take quite some time to start up.)


You can start the container and session as follows:

"Container" refers to the Android LXC container itself

$ sudo waydroid container start

"Session" refers to the Waydroid specific bits to integrate Android apps into your users environment (.desktop files etc)

$ waydroid session start

Use the following command to inspect the status of Waydroid:

$ waydroid status
Session:        RUNNING
Container:      RUNNING
Vendor type:    MAINLINE
Session user:   user(10000)
Wayland display:        wayland-0

Run the Android container in fullscreen:

$ waydroid show-full-ui

Run apps from the command-line:

$ waydroid app launch com.android.settings

See waydroid -h for more information.

Related

  • pmaports#1173 lets package it for postmarketOS
  • pmaports!2497 main/linux-postmarketos-*: enable CONFIG_PSI (with side-by-side performance video)