Generic Halium Install instructions

- Note: This guide uses halium-install, a customs cript that only works with Linux. Until the installer support is there, you cannot install with any other OS

- If not stated otherwise, put all downloaded artifacts together into a subfolder e.g. called halium-install

- Download the latest root file system: wget https://ci.ubports.com/job/xenial-hybris-android9-rootfs-arm64/lastSuccessfulBuild/artifact/ubuntu-touch-android9-arm64.tar.gz

- Download the device customization: halium-boot, system and vendor image given to you by the porter

- Download your device´s TWRP recovery from https://twrp.me/Devices/ - nOte: You only need the img file for a/b devices, non need to download the ZIP file, this wont work with UT anyways

- Download Android´s platform tools: https://developer.android.com/studio/releases/platform-tools
  Extract the subfolder platform-tools and cd inside
  sudo cp adb /usr/bin && sudo cp fastboot /usr/bin

- Install additional packages: sudo apt install qemu-user-static qemu-system-arm e2fsprogs simg2img

- Download halium-install: wget https://github.com/JBBgameich/halium-install/releases/download/continuous/halium-install-standalone.sh
  Set it to executable: chmod 755 halium-install-standalone.sh

- Add udev rules for Android devices (this is also done by Ubports Installer):
  sudo curl --create-dirs -L -o /etc/udev/rules.d/51-android.rules https://raw.githubusercontent.com/snowdream/51-android/master/51-android.rules
  sudo chmod a+r /etc/udev/rules.d/51-android.rules
  sudo service udev restart

- Enable developer mode in Android, allow USB debugging and OEM unlock: https://www.howtogeek.com/129728/how-to-access-the-developer-options-menu-and-enable-usb-debugging-on-android-4.2/
  On the same page, enable OEM unlocking

- Connect your device
  Confirm the security warning on the Android device
  Check with adb devices if the device is listed

- Shut down your Android and boot into fastboot mode
  Press and hold Vol-Down and Power until the robot appears
  Check with fastboot devices if the device is listed

- Unlock the bootloader with fastboot flashing unlock
  Confirm the warning on the device

- Flash partitions
  Issue fastboot flash boot twrp-xy.img
  Issue fastboot flash vendor vendor.img

- Select boot to Recovery from the bootloader´s menu and confirm
- Issue adb shell
- inside the shell, issue mount data to ensure data partition is mounted
- Install the actual UT OS
  Issue ./halium-install-standalone -p ut -s -i ubuntu-touch-android9-arm64.tar.gz system.img

- Issue adb reboot bootloader

- Overwrite TWRP by issuing fastboot flash boot halium-boot.img (Note later you can use fastboot boot twrp-xy.img to temporarily boot into recovery)


Finished, with a bit of luck Ubuntu Touch is now booting ;) - Note that first boot can take a while, also it might happen that the device reboots, the reason is unclear, but be patient :) Allow 1 or 2 reboots to happen. More reboots however indicate something went wrong.