Installing Halium-based builds#

With the necessary compontents built, you are now ready to install them on your device and check whether they function as intended. There are only minor differences between Halium versions when it comes to the installation process. In all cases, the system image and rootfs are installed together on the userdata partition of the device. This is done for practical reasons, as it makes the installation process simpler to manage during the first phases of the porting process. Once the port reaches the level of maturity required for it to be offered through the UBports installer (see Finalizing the port), this must be changed in order to reserve a maximum of possible space for userdata.

In brief:

  • Halium-7.1 requires installing the boot image and system image you have built, together with the UBports rootfs, which you need to download.

  • Halium-9.0 and newer require installing the boot image you have built together with the GSI and the UBports rootfs. Both the GSI and the rootfs are available for download. Note: If you chose to build your own system.img, then you must use this instead of the GSI when installing.

In order to install Ubuntu Touch, you need a recovery image with Busybox, such as TWRP, installed on your phone. If you have not done so yet, refer to section Zainstaluj TWRP recovery and install it now.

You will also need to ensure the /data partition is formatted with ext4 and is not encrypted. Boot into recovery, check and adjust as necessary.

Flashing halium-boot.img#

To install halium-boot, reboot your phone into fastboot mode. Then do the following from the root of your BUILDDIR:

cout
fastboot flash boot halium-boot.img

Jeśli masz problemy z dostępem do twojego urządzenia w trybie fastboot, ale masz dostęp do adb w TWRP/trybie recovery, zbootuj urządzenie do trybu recovery i spróbuj tego sposobu:

cout
adb push halium-boot.img /tmp/

On your device, choose Install in the TWRP menu, navigate to the /tmp directory, choose Image, select your image file, select Boot and swipe to flash.

Informacja

Urządzenia Samsunga: Flashowanie halium-boot.img na urządzeniach Samsunga jest możliwe dzięki narzędziu do flashowania Heimdal (na Linuxie) lub Odin (na Windowsie) poprzednio wprowadziwszy urządzenie do «trybu download». Zobacz więcej informacji o tych narzędziach tutaj. Podążaj za instrukcjami dla narzędzia, które wybrałeś/aś, wliczając specyficzną komende na flashowanie partycji boot. Zainstaluj system.img i rootfs (poniżej) na urządzeniu w trybie recovery.

Installing system image and rootfs#

Read carefully and perform only the steps which apply to your Halium version and the files you will be flashing!

Download the appropriate rootfs#

Start by downloading the appropriate rootfs for your device. You need a rootfs corresponding to your device’s architecture and the Halium version you have built. At the moment there are two available versions for Halium 7.1, an armhf (32 bit) version and an arm64 (64 bit) version. For Halium 9.0 there is only an arm64 rootfs available. Follow the appropriate link below to download the one you need.

Download the halium-install script#

Clone or download the halium-install repository. This repository contains tools that can be used to install a Halium system image and distribution rootfs. Reboot your device to recovery (e.g. TWRP), to get adb access again. Now use the halium-install script to install Ubuntu Touch on your device.

Perform the installation#

For Halium 7.1 ports use the following command:

path/to/halium-install -p ut path/to/rootfs.tar.gz path/to/system.img

For Halium 9.0 ports, use this command:

path/to/halium-install -p ut -s path/to/ubuntu-touch-android9-arm64.tar.gz path/to/[SYSTEM_IMAGE]

where [SYSTEM_IMAGE] will be the file android-rootfs.img you downloaded and extracted, or alternatively the file system.img you built yourself.

Skrypt skopiuje i rozpakuje pliki do ich właściwych miejsc, potem pozwoli ci wybrać hasło dla twojego urządzenia (hasło użytkownika phablet ).

Informacja

halium-install might fail due to unconfigured bintfmt-support for qemu throwing errors such as «chroot: failed to run command ‘passwd’: Exec format error». To fix this, /proc/sys/fs/binfmt_misc/register should be updated. binfmt-manager by @mikkeloscar can provide quickfix.