XDA Developers Thread 
[TUTORIAL] Setting up and Compiling ICS from AOSP

Quite a few people have asked about compiling ROMs from source, so here's a guide.

This guide is directed mainly at compiling ICS for the GSM Galaxy Nexus.

It will show you how to set up the building environment really quickly with a few simple commands in the Terminal, then show you how to sync up with the repository and compile a ROM.


It can also be done in a Virtual Machine.

Thanks Nathan (nprussell) for the write up!


Here are the steps:
(There are additional things you can do via the link above).



- For the purposes of this guide, you MUST be running 64-bit Ubuntu. This can be set up on a VM (it will compile if set correctly).
- If using a VM, ensure you give it at LEAST 2gb RAM and 2xCores (it'll take 3-4 hours at best)
- The source download is approximately 6gb.. you're going to need 25gb HD space for a single build.

To learn how to setup a Ubuntu 64bit VM on your Windows PC, use THIS GUIDE. I recommend using 10.04.

So... let's assume you're running Ubuntu 64 bit for the first time, and start right from the beginning.

NOTE : You're probably better of copying and pasting these commands, as some are quite long! All commands are in RED!


1. Preparing your development environment

The very first thing you're going to need to do, is ensure you're working in a root terminal. Much like when using your Android phone, you'll want the # and not the $. In order to do this, open TERMINAL, and type:

sudo -i

Then type in your password. From this point forward, all of the commands in this guide assume you have root priviliges (saves typing sudo *superuser do* before everything!)

Next, we need to add a repository so that apt-get knows where to look for Java JDK:

add-apt-repository "deb http://archive.canonical.com/ lucid partner"

After that, you'll need to update the repository with the following command:

apt-get update

Now that your repository has been updated, you can proceed with installing the required packages to make building Android from source possible. The first thing you're going to need is the Java Development Kit 6:

apt-get install sun-java6-jdk

Followed by (and this may already be installed depending on which version of Ubuntu you went for):

apt-get install python

Now you're going to need Git. Git is the revision control system.

apt-get install git-core

Now, you're going to pull in all the required packages needed for the build process. As I have stated already, this guide is for 64 bit ONLY. Some of these will not work on 32-bit, so if you're using 32 bit, you're reading the wrong guide (sorry)!

apt-get install git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev libc6-dev lib32ncurses5-dev ia32-libs x11proto-core-dev libx11-dev lib32readline5-dev lib32z-dev libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils

IF YOU'RE USING UBUNTU 11.10, TYPE THIS COMMAND (if not, ignore this next one)

ln -s /usr/lib/i386-linux-gnu/libX11.so.6 /usr/lib/i386-linux-gnu/libX11.so

Congratulations; you now have all the required packages to proceed with the next step!


2. Installing and initialising the repo

Now we need to download repo, add it to our path and set the permissions . Please note that if you close terminal, you'll have to do this again. Type each command on a new line, pressing enter after each:

mkdir ~/bin
curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo
chmod a+x ~/bin/repo

Now we need to create a directory for where our source is going to be pulled to, and change directory to it:


Next, you'll need to initialize the repo. There are two commands below; the top one initializes the specific branch, and the bottom is the master.


repo init -u https://android.googlesource.com/platform/manifest -b android-4.0.3_r1


repo init -u https://android.googlesource.com/platform/manifest

You will now be prompted to provide your name and email address. Please give it real details; that way you can use the gerrit code review tool if your email is connected with a Google account.


3. Downloading the source (sync)

This is probably the most simple part, but depending on your connection speed, it could take a while. I am on 40mb download/10mb up, and it took about 25 mins. If you're on a typical DSL connection, expect to be waiting 60-120 minutes.

repo sync


4. Obtaining proprietary binaries

New for ICS, Android cannot just be compiled from source code only. It requires additional hardware-related proprietary libraries to run, specifically for graphics acceleration (and GSM/LTE).

The binaries must first be downloaded from here

Each set of binaries comes as a self-extracting script in a compressed archive. After uncompressing each archive, run the included self-extracting script from the root of the source tree, confirm that you agree to the terms of the enclosed license agreement, and the binaries and their matching makefiles will get installed in the vendor/ hierarchy of the source tree. For example... after extracting one of the files, you will have 'extract-imgtech-maguro.sh'. Simply run:

sh extract-imgtech-maguro.sh

From your ICS_Source directory.

IMPORTANT NOTE : If you are building for the Nexus S, you will need the Nexus S binaries.


5. It's build time!

If you're a JAVA developer, feel free to have a play with the source and make any changes you want to make at this stage. Be careful though, adding rubbish/old syntax code to the source (formatting is slightly different to gingerbread) will cause the build to fail.

Assuming that you just want to get on with building ICS, set the build environment up with:

source build/envsetup.sh

Next, you'll need to lunch. I don't mean go and have a sandwich, I mean... select which device you're building for.

NOTE - you can add other devices to this list PRIOR to proceeding with this step. If you're NOT building for the GNexus, go to the bottom of this guide and look at how to add devices to the list.

As previously stated, we're going to assume you're building for the Galaxy nexus, so type:


You'll be presented with a number of options (full-eng, etc).

If you're building for the Galaxy Nexus (codename: Maguro), type:


(7 for Nexus S and 6 for Nexus S 4G)

and hit enter. Now, we're ready to set the compile in motion, ladies and gentlemen. There's a lot of debate over the next bit. the -j part of the below command is technically not needed, but I have had MUCH more success compiling on a virtual machine with the -j1 added. Could be random... who knows...

Anyway, to set your build in motion, you now have TWO options. The first option will output the build as img files. The second option will output a flashable .zip file. I recommend the latter if you intent to use CWM over fastboot.

make -j1


make -j1 otapackage

Congratulations - in a few hours, you should have a working AOSP build for the Galaxy Nexus!