Building ubports source

This guide covers the basics of building certain portions of Android as they relate to Ubuntu Touch. The example device used in this guide is a OnePlus One.

If you do not have a source tree yet, check out the "Setting up your source tree" heading on the UBports Development Information page.

Setting up the environment

Setting up the environment is necessary before porting any device. You should use Ubuntu for building any Android source, including this. To ensure that we can help you on the IRC or forums, ensure that you are using Ubuntu. If you do not use Ubuntu as your host OS, you should look into virtualizing a Ubuntu environment via LXC or a VM.

Add the phablet-tools repository:

Install build tools:

Build

Initialize

First we need to Initialize the environment using the envsetup.sh tool:

This will give you an output that looks like this:

Choose you target

Now we need to choose the target to build using the lunch command;

The output of this command will look something like this:

Here you need to choose your device cm[your device]-userdebug, example if you were to build the oneplus one you would choose cm_bacon-userdebug or 9

Building your device

Here comes the fun part, building the device it self using the command make

for building faster, you can use the -j[n] option for doing parallel operations. it's common to use a number of tasks N that's between 1 and 2 times the number of hardware threads on the computer being used for the build.

The output will be in out/target/[device]