Getting Started The XPerience Project

You must be running a 64-bit Linux distribution and must have installed some packages to build The XPerience Project. Google recommends using Ubuntu for this and provides instructions for setting up the system (with Ubuntu-specific commands) on the Android Open Source Project website.

To initialize your local repository using the XPerience CAF trees, use a command like this:

  $ mkdir XPe
  $ cd XPe
  $ repo init -u https://github.com/TheXPerienceProject/Manifest -b xpe-20.0 --git-lfs
  $ sudo install /usr/bin/repo .repo/repo/repo

Then to sync up:

repo sync --force-sync --no-tags -j$(nproc --all) --optimized-fetch --prune

---

Options

You can build with stock google apps package or only essentials use:

• TARGET_ESSENTIAL_GAPPS:=true "for only Essengital (core package)"
• TARGET_STOCK_GAPPS:=true "for stock packages"

Building The XPerience Project for your device

Build Environment

• Tested and Working on any version of Ubuntu - 20.04 20.10 21.04 (64-bit)
• Tested and working on manjaro
• Any other distribution based of the Ubuntu Distro such as Lubuntu, Xubuntu and etc.
• A Terminal window
• A Good specs of hardware like 16 GB of RAM (32GB recomended) and an Intel octacore or amd ryzen 12cores
• A storage unit of any kind (minimum 500 GB). It would be better to use SSD because is more fast during the compliation process
• Some dependencies that should be installed

Dependencies for Linux or Dependencies for Mac

Building The XPerience Project ROM for your device

• Preparing Required Binaries and Device Drivers
• Set CCache for Faster Building (Optional)
• Build phase

Set CCache

  $ sudo apt-get install ccache
  $ export USE_CCACHE=1
  $ export CCACHE_DIR=~/.ccache
  $ ccache -M 50G

Congratulations,the sources are initialized!

To build The XPerience Project ROM

  $ . build/envsetup.sh
  $ lunch xperience_${DEVICE}-bp2a-userdebug
  $ make bacon -j$(nproc --all)

If you want build with GAPPS add this flag

  $ WITH_GMS := true

Credits to:

  * Android Open Source Project.
  * Cyanogenmod Team.
  * LineageOS
  * CodeAurora Forum
  * ParanoidAndroid (AOSPA)
  * And too much other's devs They do a lot for the community

  # bibliography:
  * http://tryge.com/2013/06/15/build-android-from-source-macosx/
  * https://source.android.com/source/initializing.html

Copyright (C) 2011-2025 The XPerience Project