The following instructions are specific to the latest 64bit Raspbian bullseye and may not work on other versions or operating systems.
If you have already made customizations please ensure none of these changes will conflict with your existing changes.
- Can only use Android on a single screen within pyEFIS
- No hardware graphics acceleration on Raspberry PI5, this will be resolved once snap core24 becomes stable
Make sure required software is installed:
sudo apt install -y weston raspi-config
Disable wayland and use x11:
sudo raspi-config nonint do_wayland W1
If you are running on a Raspberry PI 5, you need to enable 4k pages.
This is NOT needed on other versions of the PI:
echo '# 4k pages
kernel=kernel8.img
'| sudo tee -a /boot/firmware/config.txt >/dev/null
This just removes the desktop notifications, we do not need to be informed of an update being avaliable while landing...
sudo apt remove lxplug-updater -y
Enable PSI in the kernel:
sudo sed --follow-symlinks -i 's/quiet/psi=1 quiet/g' /boot/firmware/cmdline.txt
Enable Apparmor:
sudo sed --follow-symlinks -i 's/quiet/apparmor=1 security=apparmor quiet/g' /boot/firmware/cmdline.txt
Reboot before proceeding
Install the waydroid repository and install waydroid:
sudo apt install curl ca-certificates -y
curl https://repo.waydro.id | sudo bash
sudo apt install -y libglibutil libgbinder python3-gbinder waydroid
NOTE: Remove the -s GAPPS if you do not want google play
This will download and install Lineage OS:
sudo waydroid init -s GAPPS
This is related to this bug: waydroid/waydroid#631
cd /etc/apparmor.d/
sudo ln -s lxc/lxc-waydroid .
This is related to this bug: waydroid/waydroid#1065
sudo sed --follow-symlinks -i 's/lxc.console.path/lxc.mount.entry = none acct cgroup2 rw,nosuid,nodev,noexec,relatime,nsdelegate,memory_recursiveprot 0 0\n\nlxc.console.path/g' /var/lib/waydroid/lxc/waydroid/config
If you installed the google play store you will need to self certify this installation before google Play will work. First you need to start waydroid, to do that we first run weston:
weston &
Then we run the command to start android:
WAYLAND_DISPLAY=wayland-1 waydroid show-full-ui
In another terminal window or tab open up the waydroid shell:
sudo waydroid shell
Run this command inside the waydroid shell:
ANDROID_RUNTIME_ROOT=/apex/com.android.runtime ANDROID_DATA=/data ANDROID_TZDATA_ROOT=/apex/com.android.tzdata ANDROID_I18N_ROOT=/apex/com.android.i18n sqlite3 /data/data/com.google.android.gsf/databases/gservices.db "select * from main where name = \"android_id\";"
Use the string of numbers printed by the command to register the device on your Google Account navigate to https://www.google.com/android/uncertified login with you Google Account and enter in the code that was output in the previous command.
After registering the Play store will work once you log into it with your account.
Sometimes it can take Android a long time to stop complaining about uncertified and recognize it should let you log in, so be patient.
Reboot before proceeding
After you have installed the pyefis snap you need to copy a file and run a few commands How to install pyefis can be found Here
Since the snap is confined it cannot directly start Android since it runs outside of the snap. We will setup a service that monitors for the conditions required to start/stop Android to work around this limitation.
You might need to first create a directory:
mkdir -p ~/.config/systemd/user/
Then link the systemd unit file:
ln -s /snap/pyefis/current/extras/waydroid-monitor.service ~/.config/systemd/user/waydroid-monitor.service
Enable the systemd user service so it starts automatically when you reboot:
systemctl --user enable waydroid-monitor.service
Start the service:
systemctl --user start waydroid-monitor.service
With the service running you can start pyEFIS and navigate to a page that includes an Android window. You should see it start up a few seconds after visiting the page.