Build Environment

For my fork (codename "HydraX") of LeaOS for Huawei P20 lite aka ANE-LX1.

OS information & scope

• Based on Android 13→LineageOS 20→LeaOS
• Shipped with microG and F-Droid
• Some minor additional patches to improve usability and the build process
• The build aims to be
  • Platform-independent (using Docker)
  • Automated so that security updates can be shipped more often

Installation guide

based on the original guide from XDA

Requirements

• Huawei P20 lite
• A PC with ADB installed and a USB cable to connect the phone

INITIAL installation

• Create a backup of all your data on the phone, it will be lost otherwise!
• Unlock the bootloader
• Boot up your phone, go into developer settings, enable ADB and make sure OEM unlock is active
• Enter fastboot
  • Connect your phone with a PC
  • Hold Vol Down + Power
• Flash TWRP (recovery): fastboot flash recovery_ramdisk <twrp.img>
  • Can be downloaded from: https://dl.twrp.me/anne/
• Flash TureX's phenix kernel since Huawei ships an outdated kernel
• Flash system: fastboot flash <system.img>
  • Can be downloaded from the releases
  • The image is compressed with zstd. You have to unpack it first!
    • On Windows you can do this e.g. with 7-Zip-zstd
• Boot into recovery/TWRP
  • Remove USB cable
  • Hold Vol Up + Power
  • Allow modifications, DO NOT choose "read-only"! You may brick your phone!
• Resize system: Wipe > Advanced Wipe > System > Repair or Change File System > Resize File System > Swipe
• Wipe
  • cache
  • dalvik/art cache
  • internal storage
  • data
• (optional) Install DRM (see XDA forum/guide for details)
• Reboot your system
• First start assistant should show up

Updating an existing installation

• Enter fastboot
  • Connect your phone with a PC
  • Hold Vol Down + Power
• Flash system: fastboot flash <system.img>
  • Can be downloaded from the releases
  • The image is compressed with zstd. You have to unpack it first!
    • On Windows you can do this e.g. with 7-Zip-zstd
• Boot into recovery/TWRP
  • Remove USB cable
  • Hold Vol Up + Power
  • Allow modifications, DO NOT choose "read-only"! You may brick your phone!
• Resize system: Wipe > Advanced Wipe > System > Repair or Change File System > Resize File System > Swipe
• Wipe
  • cache
  • dalvik/art cache
  • DO NOT WIPE internal storage or data or you will use all your apps/data
• Reboot your system

General troubleshooting help

If the installation is not working / randomly crashing you can try the following:

• Reinstall it with above steps
• Pick an older release

Encountered/Known problems

• There are multiple problems inside the media decoder firmware:
  • Frequent exceptions (MediaCodecError) occur when playing/streaming videos (on average every 10 min)
    • This also occurs on EMUI/Android 9 however not as often.
  • Frame-drops sometimes occurs as the GPU seems to be overloaded (hardware-acceleration not working?)
  • Interacting with full-screen videos causes white flashes
• Notch is not properly recognized in landscape mode
• Call recording doesn't seem to work at all

Notes for maintaining/building

Requirements

• x64 Processor
• ~200GB of disk space
• ~22GB of RAM (depends on amount of Threads) for Docker
• Patience (even on a 16 core CI server with a 1Gb/s connection the build needs ~2h)

How to update

• Update forked repositories
• Update vendor/hardware_overlay revision in anne.xml so that it matches with upstream

Further references

• https://xdaforums.com/t/rom-huawei-13-leaos-lineage-20-0-for-huawei-device-emui-9-1-version.4558665/
• https://github.com/lineageos4microg/docker-lineage-cicd
• https://github.com/testflows/TestFlows-GitHub-Hetzner-Runners