Getting Started

In order to build XOSP for your device, first of all you need to get familiar with Git and Repo.

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

repo init -u git://github.com/XOSP-Project/platform_manifest.git -b xosp-mm

Then to sync up:

repo sync --force-sync

---

Building XOSP for your device

Build Environment

• Tested and Working on any version of Ubuntu - 14.04, 14.10, 15.04, 15.10 & 16.04 (64-bit)
• Any other distribution based of the Ubuntu Distro such as Lubuntu, Xubuntu and etc.
• A Terminal window
• A Good specs of hardware like 4 GB of RAM and an Intel I3 dual core
• A storage unit of any kind (minimum 100 GB). It would be better to use SSD because is more fast during the compliation process
• Some dependencies that should be installed

###Building XOSP ROM for your device

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

###Set CCache

  $ export USE_CCACHE=1
  $ prebuilts/misc/linux-x86/ccache/ccache -M 100G

Congratulations,the sources are initialized!

Preparing XOSP for your device

• To know how to include propietary vendors files from your device, follow this guide which explains everything you need to know: (http://forum.xda-developers.com/showpost.php?p=54118631&postcount=4)

• Once you finish modifying the vendor files for your device, you will need to add this line into the xosp.mk of your device:

  $(call inherit-product, vendor/xosp/config/xosp.mk)
  

• Don't forget to build the ROM in permissive mode or else the ROM will not boot!

To build XOSP ROM

  $ cd ~/XOSP
  $ source build/./envsetup.sh
  $ brunch <device>

Obtaining the zip created from the build process

To get the zip file that has been built, navigate to the out directory and find for the zip file there. If you found it, then congratulations! If you didn't, try retrying the build process but before doing so, ensure you do the following:

  $ cd ~/XOSP
  $ make clean

When you done the initialization once you're free to build now without making that again.

For those who finally get the compilation process done

Well you made it my friend, after all these hours passed now you finally got the ROM ready to be flashed through the recovery of your device. Share it on XDA or on every forum,blog site etc... (as you wish). We expect you to contribute as well and to give credits to the XOSP Team and their contributors! Don't forget to sync your repo everytime and build XOSP more than just one because the source get changed almost everyday with new fixes or new features. Don't esitate to make pull requests because we will take them all in consideration.

Don't know what XOSPApps are?

If you don't know what XOSPApps are take a look over here: https://github.com/XOSP-Project/xosp_apps