Android apps

Anbox is a minimal Android container and compatibility layer that allows you to run Android apps on GNU/Linux operating systems such as UBports.

Bemerkung

Wenn in diesem Dokument „host“ verwendet wird, bezieht es sich auf ein anderes Gerät, mit dem Sie Ihr Ubuntu Touch-Gerät verbinden können. Auf Ihrem Host-Gerät muss adb` und fastboot installiert sein.

Bemerkung

You will need to execute commands on your Ubuntu Touch device to install Anbox and APKs. You can do that by using the terminal application, but it is easier to use adb shell or set up ssh to access your phone from your host.

Unterstützte Geräte

Sicherstellen, dass das Gerät unterstützt wird:

  • Meizu Pro 5 (Codename: turbo, Name der Bootpartition: bootimg)
  • Fairphone 2 (Codename: FP2`, Name der Bootpartition: `boot`)
  • OnePlus One (codename: bacon, name of the boot partition: boot)
  • Nexus 5 (Codename: hammerhead, Name der Bootpartition: boot)
  • BQ M10 HD (Codename: cooler, Name der Bootpartition: boot`)
  • BQ M10 FHD (Codename: frieza, Name der Bootpartition: boot)

Der Codename und der Name der Boot-Partition werden für die Installation benötigt.

Installationsanleitung

Warnung

Installing Anbox is only recommended for experienced users.

Warnung

To install Anbox, you need to flash a specific boot image. You will need to re-flash that image after each Ubuntu Touch update so when you update from OTA-10 to OTA-11 for example. Not doing so can put your phone into an unstable state. Only update your Ubuntu Touch device when you have a computer with you to re-flash that boot image.

  • Make sure your supported device runs on 16.04 (Anbox doesn’t work on 15.04).

  • Be sure to have a backup of the device.

  • Öffnen Sie ein Terminal auf Ihrem Host und setzen Sie einige gerätespezifische Variablen, indem Sie export CODENAME="turbo" && export PARTITIONNAME="bootimg" ausführen, aber ersetzen Sie den Teil zwischen den Anführungszeichen jeweils durch den Codenamen und Namen der Bootpartition für Ihr Gerät. Siehe die obige Liste.

  • Entwicklermodus auf dem Gerät aktivieren.

  • Connect the device to your host and run the following commands from your host (same terminal you ran the export command in):

    wget http://cdimage.ubports.com/anbox-images/anbox-boot-$CODENAME.img
    adb shell # connect from your host computer to your UT device
    sudo reboot -f bootloader # 'adb shell' will exit after this command, the prompt will be back on your host
    sudo fastboot flash $PARTITIONNAME anbox-boot-$CODENAME.img
    sudo fastboot reboot
    rm anbox-boot-$CODENAME.img
    exit
    
  • Wait for the device to reboot, then run this from your host:

    adb shell # connect from your host computer to your UT device
    sudo mount -o rw,remount /
    sudo apt update
    sudo apt install anbox-ubuntu-touch
    anbox-tool install
    exit
    
  • Erledigt! Möglicherweise müssen Sie den Anwendungsbereich der Apps aktualisieren (ziehen Sie ihn aus der Mitte des Bildschirms heraus und geben Sie ihn frei), damit die neuen Android-Apps angezeigt werden.

Bemerkung

You now have an adb server running inside your phone. This guide asks you to run some adb commands, sometime on your computer, sometime on your phone. Carefully check on which device you are!

You can check that adb server is correctly running locally on your phone by opening the terminal app and enter adb devices. You should see something like:

[email protected]:~$ adb devices
List of devices attached
emulator-5558       device

How to install new APKs

  • Copy the APK to /home/phablet/Downloads, then run the following from your host:

    adb shell # connect from your host computer to your UT device
    sudo mount -o rw,remount /
    sudo apt update
    sudo apt install android-tools-adb
    adb install /home/phablet/Downloads/my-app.apk # This is the adb of your device, not your host
    exit
    
  • Erledigt! Möglicherweise müssen Sie den Anwendungsbereich der Apps aktualisieren (ziehen Sie ihn aus der Mitte des Bildschirms heraus und geben Sie ihn frei), damit die neuen Android-Apps angezeigt werden.

Halten Sie Ihre Apps auf dem neuesten Stand

How to uninstall apps

  • Um Apps zu deinstallieren, führen Sie `adb uninstall [APP_ID] von Ihrem Ubuntu Touch-Gerät aus:

    adb shell # connect from your host computer to your UT device
    sudo mount -o rw,remount /
    adb uninstall [APP_ID] # This is the adb of your device, not your host
    exit
    
  • Erledigt! Möglicherweise müssen Sie den Anwendungsbereich der Apps aktualisieren (ziehen Sie ihn aus der Mitte des Bildschirms heraus und geben Sie ihn frei), damit die neuen Android-Apps angezeigt werden.

Problembehandlung

  • Wenn die Installation von anbox-ubuntu-touch oder android-tools-adb auf dem Gerät mit einem Fehler über zu wenig Platz fehlschlägt, versuchen Sie Folgendes:

    adb shell # connect from your host computer to your UT device
    sudo mount -o rw,remount /
    sudo rm -r /var/cache/apt     # delete the apt cache; frees space on system image
    sudo tune2fs -m 0 /dev/loop0  # space reserved exclusively for root user on system image set to zero
    sudo apt update               # recreate apt cache to install Anbox and adb
    sudo apt install anbox-ubuntu-touch android-tools-adb
    sudo mount -o ro,remount /
    exit
    
  • Wenn Sie eine APK installieren wollen, aber den Fehler Ungültige APK-Datei erhalten, könnte dieser Fehler auch bedeuten, dass die Datei nicht gefunden wurde

    • Check that you typed the file name correctly
    • If the APK does not reside in the current folder where you execute adb, you have to specify the full path, e.g. /home/phablet/Downloads/my-app.apk instead of just my-app.apk

Fehler melden

Please report any bugs you come across. Bugs with Ubuntu Touch 16.04 are reported in the normal Ubuntu Touch tracker and issues with Anbox are reported on our downstream fork. Thank you!