Halium-7.1 - Building

For Halium-7.1 porting it is necessary to build both halium-boot.img and system.img.

Initializing the build environment

First you need to initialize the environment using the envsetup.sh tool included in your source tree. Enter your BUILDDIR and issue the command:

source build/envsetup.sh

The output will look like this:

including device/lge/bullhead/vendorsetup.sh
including vendor/cm/vendorsetup.sh
including sdk/bash_completion/adb.bash
including vendor/cm/bash_completion/git.bash
including vendor/cm/bash_completion/repo.bash

The breakfast command is used to set up the build environment for a specific device. From the root of your BUILDDIR run the following, replacing [CODENAME] with your device’s specific codename:

breakfast [CODENAME]

Breakfast will attempt to find your device, set up all of the environment variables needed for building, and give you a summary at the end.

Modify the kernel configuration

The default LineageOS/Halium kernel configuration file needs modifications as Ubuntu Touch requires a slightly different kernel config than Halium, including enabling Apparmor. A script that does this job is provided in your Halium source tree: BUILDDIR/halium/halium-boot/check-kernel-config.

Locate your configuration file. It should be at arch/arm/configs/<CONFIG> or arch/arm64/configs/<CONFIG> depending on the architecture of your device. If you have trouble finding it, run grep "TARGET_KERNEL_CONFIG" device/<VENDOR>/<CODENAME>/BoardConfig.mk to determine the location.

Then, from the root of your BUILDDIR, run:

./halium/halium-boot/check-kernel-config path/to/my/defconfig -w

Dies muss man mitunter zwei Mal machen. Es korrigiert beide Male etwas. Dann führt man das Skript ohne -w-Schalter aus, um zu sehen, ob es noch weitere Fehler gibt. Wenn ja, korrigiert man diese manuell. Sobald das erledigt ist, führt man das Skript erneut -w-Schalter aus, um sicherzustellen, dass alles korrekt ist.

Ubuntu Touch erfordert die Einstellung console=tty0

Das halium-boot initramfs erwartet, dass /dev/console ein Konsolengerät ist und wird init nicht starten, wenn es nicht verfügbar ist. Dies ist bei neueren Geräten häufig der Fall, da sie entweder UART deaktiviert haben oder console= standardmäßig nicht angegeben ist (null). Dies kann behoben werden, indem man console=tty0 als letztes Argument in der Kernel-Cmdline angibt. Um dies zu erreichen, gehen Sie wie folgt vor:

Dies sollte in der Makefile mit dem Namen BoardConfig.mk (oder BoardConfigCommon.mk) geschehen, die sich im Hauptverzeichnis Ihres Gerätebaums befindet, z.B. ~/halium/device/<vendor>/<model_codename>/BoardConfig.mk

Fügen Sie folgende Zeile ein:

BOARD_KERNEL_CMDLINE += console=tty0

Wenn Ihr Makefile bereits eine Zeile enthält, die mit BOARD_KERNEL_CMDLINE beginnt, können Sie sie der Ordnung halber direkt darunter einfügen.

Bemerkung

Die obige Methode ist zwar die bevorzugte, funktioniert aber möglicherweise bei einigen Samsung-Geräten nicht. Das Ergebnis wird sein, dass Sie nach dem Booten keinen Zugriff auf das Gerät über ssh erhalten und Unity 8 nicht starten kann. Wenn Sie auf dieses Problem stoßen, können Sie die Einstellung stattdessen in der Kernelkonfigurationsdatei Ihres Geräts festlegen. Fügen Sie die folgenden Zeilen hinzu:

CONFIG_CMDLINE="console=tty0"
CONFIG_CMDLINE_EXTEND=y

Bemerkung

In seltenen Fällen überschreibt der Bootloader das Kernel-Befehlszeilenargument, wodurch die obige Einstellung unbrauchbar wird. Dies ist der Fall für das Google Pixel 3a (sargo). Um dieses Problem zu beheben, replizieren Sie this commit.

Build

Halium will use the mkbootimg tool for creating the boot image. In most cases it is not on the local harddisk, so it can be built by issuing:

mka mkbootimg

Now build the halium-boot.img using the commands:

export USE_HOST_LEX=yes
mka halium-boot

Bemerkung

If you prefer make instead of mka you should set -j[num] for parallel building, which reduces build time. Replace [num] with the number of threads in your system plus 2.

Build errors

There are a number of known build errors which you might encounter, depending first of all upon how rigorous you have been in following the steps outlined, but you may also run into unforeseen issues. If your build fails at first, make sure you have done exactly as described, then go through the list of known errors in the Halium guide.

I your particular error is not listed, you will need to do some research of your own. If you end up here, know that there is a community of porters, developers and enthusiasts who might be able to help you. Refer to Hilfe der Community erhalten.

Building the system image (system.img)

Once you have successfully built halium-boot.img you can proceed to directly to building system.img:

mka systemimage

Likelier than not, you will run into one or more errors along the way when building the system image. A number of possible errors are documented in the Halium guide. If yours is not listed, seek community help.