Project

This projects aims to create an upgradable AOSP build system for the OnePlus 5 (Cheeseburger) and the OnePlus 5T (Dumpling). No repository from AOSP is changed: no commit over AOSP is at the moment present on these sources.

All the changes are provided in separate repositories: this allows to upgrade Android with minimal effort, potentially also for future major versions.

Most of the added repositories is provided by LineageOS or CAF, so thanks to them for those repos.

Build instructions

Follow the instructions from Google to setup a machine to build Android 14: https://source.android.com/setup/build/initializing

Then, sync all the sources:

$ repo init -u https://android.googlesource.com/platform/manifest -b <AOSP tag> --depth=1
$ cd .repo
$ git clone --branch a14/gl https://github.com/OnePlus-5-T/local_manifests.git local_manifests
$ cd ..
$ repo sync -c --no-clone-bundle --no-tags

then:

$ source build/envsetup.sh
$ lunch aosp_cheeseburger-ap2a-user
$ make -j12

the images will be available in out/target/product/cheeseburger.

To build an OTA, from the Android sources root directory:

$ bash vendor/rs/ota_build/ota_build.sh aosp_cheeseburger-ap2a-user
$ bash vendor/rs/ota_build/ota_build.sh aosp_dumpling-ap2a-user

and the OTA zip will be available in out/target/product/<product>.

Flash instructions

The images can be flashed using fastboot:

$ fastboot flash boot out/target/product/cheeseburger/boot.img
$ fastboot flash recovery out/target/product/cheeseburger/recovery.img
$ fastboot flash system out/target/product/cheeseburger/system.img
$ fastboot flash vendor out/target/product/cheeseburger/vendor.img

Format data if this is a first flash:

$ fastboot format userdata

Note that not all the fastboot versions support the 'format' command.

The OTA can be flashed from the recovery (using the 'ADB sideload' feature) or using third party recoveries like TWRP.

To build for Dumpling, run the same commands with 'dumpling' instead of 'cheeseburger' in commands and paths.

Sign with custom keys

By default, the keys used to sign system components are the AOSP keys.

To use custom keys, just replace the keys in the vendor/rs/config/security directory.

If the ota_build.sh script is used to generate the OTAs (as described above) the system will automatically be signed. OTA 'dirty' migrations are supported.

If there is no need for OTA ('dirty') upgrade, there is no need to use the ota_build.sh script as the system is signed with the new keys anyway: the ota script makes sure that the migration from AOSP keys to the new keys is managed at first boot after the upgrade, but there is no need for a 'migration' is case of clean flash.

Look at vendor/rs/config/keys_migration.sh and vendor/rs/ota_build/ota_build.sh (and related commits) for the details of the implementation.

Build the kernel

The ROM sources include a prebuilt kernel. To build a kernel from sources and update it in the Android sources, follow these instructions.

Download the sources and the cross compilers (needed only the first time):

$ cd ~
$ mkdir kernel_build
$ cd kernel_build
$ git clone --single-branch --branch 4.14.348/msm8998_oneplus https://github.com/OnePlus-5-T/4.14-kernel-oneplus-msm8998 kernel_oneplus_msm8998
$ git clone --depth 1 -b android12L-release --single-branch https://android.googlesource.com/platform/prebuilts/gcc/linux-x86/aarch64/aarch64-linux-android-4.9/ prebuilt_aarch64
$ git clone --depth 1 -b android12L-release --single-branch https://android.googlesource.com/platform/prebuilts/gcc/linux-x86/arm/arm-linux-androideabi-4.9/ prebuilt_arm
$ git clone --depth 1 -b android-13.0.0_r0.70 --single-branch https://android.googlesource.com/platform/prebuilts/clang/host/linux-x86 prebuilt_clang
$ git clone --depth 1 -b android-13.0.0_r0.70 --single-branch https://android.googlesource.com/platform/prebuilts/gas/linux-x86 prebuilt_clang_triple
$ git clone --depth 1 -b android-13.0.0_r6 --single-branch https://android.googlesource.com/platform/prebuilts/build-tools prebuilt_tools

Build the kernel:

$ CC_ARM32_PATH=~/kernel_build/prebuilt_arm/bin
$ CC_ARCH64_PATH=~/kernel_build/prebuilt_aarch64/bin
$ CLANG_PATH=~/kernel_build/prebuilt_clang/clang-r458507/bin
$ CLANG_BIN=${CLANG_PATH}/clang
$ CLANG_TRIPLE_BIN=~/kernel_build/prebuilt_clang_triple/aarch64-linux-gnu-
$ MAKE_PATH=~/kernel_build/prebuilt_tools/linux-x86/bin
$ PATH="${PATH}:${CLANG_PATH}"
$ DEFCONFIG=msm8998_oneplus_android_defconfig

$ cd ~/kernel_build/kernel_oneplus_msm8998
$ git pull
$ ${MAKE_PATH}/make O=out ARCH=arm64 CC=${CLANG_BIN} LLVM=1 LLVM_IAS=1 ${DEFCONFIG} -j8
$ ${MAKE_PATH}/make O=out ARCH=arm64 CROSS_COMPILE_COMPAT=${CC_ARM32_PATH}/arm-linux-androidkernel- CROSS_COMPILE=${CC_ARCH64_PATH}/aarch64-linux-androidkernel- CC=${CLANG_BIN} LLVM=1 LLVM_IAS=1 CLANG_TRIPLE=${CLANG_TRIPLE_BIN} -j6

Kernel headers can be generated with the following (after configuring the environment with the same variables used to build the kernel) (assuming that the Android build directory is ~/android_build_directory/):

$ ${MAKE_PATH}/make headers_install ARCH=arm64 LLVM=1 LLVM_IAS=1 INSTALL_HDR_PATH=~/android_build_directory/vendor/rs/kernel-headers/
$ cp -r ~/android_build_directory/vendor/rs/kernel-headers/include/* ~/android_build_directory/vendor/rs/kernel-headers/
$ rm -rf ~/android_build_directory/vendor/rs/kernel-headers/include
$ rm -rf ~/android_build_directory/vendor/rs/kernel-headers/techpack
$ cd ~/android_build_directory/vendor/rs/kernel-headers/
$ find . -name "*.cmd" -type f -delete
$ cd -

Extra patches

Some patches are needed over AOSP to fix specific issues. The patches can be applied with the following commands, after the repo sync:

$ cd aosp_patches
$ ./apply_patch.sh <AOSP tag>

The patches currently available:

1. To avoid crashes with some Gapps versions: https://github.com/crdroidandroid/android_external_setupcompat/commit/0450c92cbe5c75cc31d4cdc0958918836b28ca53
2. To fix issues with SIM 2: https://github.com/crdroidandroid/android_frameworks_opt_telephony/commit/cbded5de818d1d23ea8ac7a67f178a95da64a9f0 https://review.lineageos.org/c/LineageOS/android_frameworks_opt_telephony/+/385445
3. To enable the styles and colors selection under Settings -> Wallpaper & style: https://github.com/Flamingo-OS/packages_apps_Launcher3/commit/e6d6b64264ef45a72791347d9f39d85ff412e58f
4. A patch to fix DAC/USB host device recognition when connected after boot (system/core).
5. A patch to support DSU (system/core).
6. A patch to fix a Dialer crash when opening Settings -> Display options: -https://github.com/CarbonROM/android_packages_apps_Dialer/commit/e2b6a46f1f477d68e83210823fef1e4c85cddb3f

These patches are not necessary to boot or use Android.

There are two patches available from Google but not yet merged which are needed to build Android:

1. https://android-review.googlesource.com/c/platform/prebuilts/sdk/+/3168781
2. https://android-review.googlesource.com/c/platform/packages/modules/common/+/3174459

These two patches should be merged soon by Google.