Skip to content

Latest commit

 

History

History
100 lines (70 loc) · 5.59 KB

README.md

File metadata and controls

100 lines (70 loc) · 5.59 KB
Raw

Android 13 for Qualcomm MSM8909/MSM8916/MSM8939 devices based on the GloDroid project

GloDroid ProjectStatus License

⚠️ Warning ⚠️

This project is a free and open-source initiative maintained by a group of volunteers. It is provided "as is" without any warranties or guarantees. The user is fully responsible for any issues arising from using the project.

About

This project builds upon lk2nd, msm8916-mainline kernel and postmarketOS (pmOS) for MSM8909, MSM8916 and MSM8939. If your device appears in those wiki pages with Mainline Y, adding support for it in this GloDroid repo should be fairly easy (example: vknecht@1fad6476fc3cd22cd818486c8f56f74b5627d44e). Otherwise, see MSM8916 Mainlining page first.

Supported devices

Name Codename SoC Downloads News Informations
Alcatel OneTouch Idol 3 4.7" (6039*) idol347 MSM8916 AndroidFileHost XDA thread pmOS wiki
Alcatel OneTouch Idol 3 5.5" (6045*) idol3 MSM8939 AndroidFileHost XDA thread pmOS wiki
Huawei Honor 5X kiwi MSM8939v2 AndroidFileHost pmOS wiki

Flashing

  • device off, go to lk2nd menu by pressing Power + Vol- buttons
  • fastboot flash boot boot.img
  • fastboot flash cache vendor.img
  • fastboot flash userdata userdata.img
  • fastboot flash system system.img
  • select START using Vol+ or Vol- buttons if needed, then press Power button

First boot might take 2 or 3 minutes... Please ignore the Contact the manufacturer message on boot. Android shows it because we're using a kernel that is not supported officially for Android-13.

Building from source

Before building, ensure your system has at least 32GB of RAM, a swap file is at least 8GB, and 300GB of free disk space available. We recommend using the latest laptops to get good performance. E.g., the HP ENVY x360 model15-ds1083cl takes about 5 hours to build the project.

Install system packages

Only Ubuntu 22.04 LTS is supported, but one can use Docker on other distros. See this Dockerfile and add git-lfs package to the list if you want to build LineageOS.

sudo apt-get install -y git-core gnupg flex bison build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig
  • Install additional packages
sudo apt-get install -y swig libssl-dev flex bison device-tree-compiler mtools git gettext libncurses5 libgmp-dev libmpc-dev cpio rsync dosfstools kmod gdisk lz4 meson cmake libglib2.0-dev git-lfs
  • Install additional packages (for building mesa3d, libcamera, and other meson-based components)
sudo apt-get install -y python3-pip pkg-config python3-dev ninja-build
sudo pip3 install mako jinja2 ply pyyaml pyelftools
  • Install the repo tool
sudo apt-get install -y python-is-python3 wget
wget -P ~/bin http://commondatastorage.googleapis.com/git-repo-downloads/repo
chmod a+x ~/bin/repo

NOTE: After this step, you may need to log out and log in to the system to make $HOME/bin added to the PATH environment variable.

Fetching the sources and building the project

git clone https://github.com/GloDroidCommunity/qcom-msm8916-series.git
cd qcom-msm8916-series

Building AOSP

./unfold_aosp.sh && ./build.sh codename-of-your-device

NOTE: If you're using git for the first time, it may ask you to configure the user name and email address and confirm the colored terminal. Please follow the suggestion you see on the screen in this case.

Building LineageOS

To enable GMS (microg), set the environment variable export WITH_GMS=true.

./unfold_lineageos.sh && ./build.sh codename-of-your-device

Notes

  • Depending on your hardware and internet connection, downloading and building may take 8h or more.
  • After the successful build, find the fastboot images at ./out/codename-of-your-device.
  • To enable GloDroid's prebuild apps (like F-Droid, skytube, Firefox, etc.), set the environment variable before building export GD_NO_DEFAULT_APPS=false.