Applications Android

Waydroid is a minimal Android container and compatibility layer to run Android apps on GNU/Linux operating systems such as Ubuntu Touch.

Note

You will need to execute commands on your Ubuntu Touch device (locally via the terminal application or remotely via ADB/SSH ) to initialize Waydroid, install APKs and uninstall applications.

Limitations

Before installing Waydroid on your device, please note that there are limitations to its support and integration:

  • After installing Waydroid on Ubuntu Touch, you may notice higher battery consumption. To mitigate this, Waydroid can be stopped manually when not in use.

  • Not all Android applications will work with Waydroid. Apps that require Google’s Play Integrity service or SafetyNet, such as banking apps, are unlikely to run.

  • Problems may occur if both Ubuntu Touch and Waydroid request the use of the same peripherals, and one will not be able to claim them (e.g. camera access not permitted).

How to set up

All Halium 9 and newer devices ship with waydroid out of the box starting with Ubuntu Touch focal, if your device fits these requirements you can follow the following steps

  • Ouvrez un terminal sur votre appareil Ubuntu Touch (à distance via ADB/SSH ou localement via l’application Terminal).

  • Run the following command in your shell: waydroid init.

  • C’est fait ! Il vous faudra sans doute actualiser le moteur de recherche des applications (faites glisser votre doigt vers le bas de l’écran et relâchez) afin que les nouvelles applications Android s’affichent.

Comment installer de nouveaux APK

  • Copy the APK to /home/phablet/Downloads on your Ubuntu Touch device.

  • Ouvrez un terminal sur votre appareil Ubuntu Touch (à distance via ADB/SSH ou localement via l’application Terminal).

  • Exécutez la commande suivante dans votre terminal waydroid app install /home/phablet/Downloads/my-app.apk

  • C’est fait ! Il vous faudra sans doute actualiser le moteur de recherche des applications (faites glisser votre doigt vers le bas de l’écran et relâchez) afin que les nouvelles applications Android s’affichent.

Utilisation d’une boutique d’applications dans Waydroid

You can also install an appstore like F-Droid or Amazon Appstore to install applications or keeping them up to date. If you want to install any of the above apps you can find them here:

Veuillez noter qu’en raison de la nature même de Waydroid, aucune de ces deux méthodes ne mettra automatiquement vos applications à jour. Vous devrez ouvrir manuellement la boutique d’applications et vérifier si des mises à jour sont disponibles. De plus, vous devrez autoriser chaque installation ou mise à jour d’application comme suit :

  • recherchez l’application à installer ou à mettre à jour

  • cliquez sur le bouton « Installer » ou « Mettre à jour »

  • attendez que le téléchargement soit terminé ; un message vous invitant à installer l’application ou la mise à jour s’affichera

  • appuyez sur le bouton « Installer » dans la fenêtre qui s’affiche

Pour les utilisateurs plus expérimentés, il est possible de résoudre ce problème en créant une image Waydroid personnalisée intégrant l’une ou l’autre de ces boutiques d’applications.

Comment désinstaller des applications

  • Ouvrez un terminal sur votre appareil Ubuntu Touch (à distance via ADB/SSH ou localement via l’application Terminal).

  • To uninstall apps from the Ubuntu Touch device, run adb uninstall [APP_ID] in your shell

  • Run the following in your shell waydroid app remove [APP_ID] (you can find the APP_ID by using “waydroid app list”)

  • Done! You might have to pull down from the app list for the old Android apps to go away.

Note

If you are using an appstore in waydroid you can also uninstall apps through said appstore

Accéder à l’espace de stockage d’Android

The Android storage is located at /home/phablet/.local/share/waydroid/data/media/0.

  • Links to android libraries can be made in their respective XDG counterparts:

    ln -s ~/.local/share/waydroid/data/media/0/Documents ~/Documents/android
ln -s ~/.local/share/waydroid/data/media/0/Pictures ~/Pictures/android
ln -s ~/.local/share/waydroid/data/media/0/Music ~/Music/android
ln -s ~/.local/share/waydroid/data/media/0/Movies ~/Videos/android

Résolution de problèmes

  • When you are installing an APK, but run into the following error Invalid APK file, this could simply mean that it could not find the apk file. Try the following steps to double check:

    • Check that you typed the filename correctly.

    • If the APK does not reside in the folder you are in when you run adb, you have to specify the full path, e.g. /home/phablet/Downloads/my-app.apk instead of just my-app.apk

Signaler des bogues

Please report any bugs you come across. Bugs concerning Ubuntu Touch are reported in the normal Ubuntu Touch tracker and issues with Waydroid are reported on our waydroid issue tracker. Thank you!