[Tutorial] Compile Kit-Kat on Ubuntu - Android

NOTICE: I'm fine with this tutorial being posted on other sites, as long as I am given credit and have your thread point back to here for the pieces that I have specifically written. I do not condone near verbatim or verbatim copy and pasting of my work or others work without credit. Please give credit where credit is due. Thank you.
07-17-12: I have not, nor shall I ever claim copyright.
To compile Kit-Kat on Ubuntu I'm going to first give you steps to set up your computer to get this thing rolling.
You MUST be running a 64 bit version of Ubuntu, 32 bit is not supported.
This will NOT make a fully functional ROM, but will give you a place to start. Also I CANNOT fix every error you run into.
READ the entire OP and make sure to properly follow instructions. Don't forget to search the thread as your question may have already been answered.
Please use Pastebin for all errors you run into. Posting a link is much easier than a long list of errors in the thread. Thank you.
You will need 25GB (or more) free to complete a single build, and up to 80GB (or more) for a full set of builds.
1) You need the following:
-JDK 6 if you wish to build Kit-Kat.
Code:
$ sudo add-apt-repository ppa:webupd8team/java
$ sudo apt-get update && sudo apt-get install oracle-java6-installer
-Python, which you can download from python.org. Or:
Code:
$ sudo apt-get install python
-Git, which you can find it at git-scm.com. Or:
Code:
$ sudo apt-get install git-core
-Android SDK:
Download the SDK here: http://developer.android.com/sdk/index.html
Extract the SDK and place it in your home directory.
I renamed my SDK to android-sdk to make it easier to navigate to.
Go to your home folder, press Ctrl+H to show hidden files, and open up your .bashrc file.
Add these lines at the bottom of the file:
Code:
# Android tools
export PATH=${PATH}:~/android-sdk/tools
export PATH=${PATH}:~/android-sdk/platform-tools
export PATH=${PATH}:~/bin
Find your .profile file and add this at the bottom of the file:
Code:
PATH="$HOME/android-sdk/tools:$HOME/android-sdk/platform-tools:$PATH"
You have now successfully installed the Android SDK.
To check for updates issue this into your terminal:
Code:
$ android
2) Installing required packages (Ubuntu 13.04+)
Code:
$ sudo apt-get install git-core gnupg flex bison gperf build-essential \
zip curl zlib1g-dev zlib1g-dev:i386 libc6-dev lib32ncurses5-dev lib32z1 \
lib32ncurses5 lib32bz2-1.0 x11proto-core-dev libx11-dev:i386 libreadline6-dev:i386 \
lib32z1-dev libgl1-mesa-glx:i386 libgl1-mesa-dev g++-multilib mingw32 tofrodos \
python-markdown libxml2-utils xsltproc readline-common libreadline6-dev libreadline6 \
lib32readline-gplv2-dev libncurses5-dev lib32readline5 lib32readline6 libreadline-dev \
libreadline6-dev:i386 libreadline6:i386 bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev \
lib32bz2-dev libsdl1.2-dev libesd0-dev squashfs-tools pngcrush schedtool libwxgtk2.8-dev python lzop
$ sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so
Installing required packages (Ubuntu 12.04)
Code:
$ sudo apt-get install git gnupg flex bison gperf build-essential \
zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev \
libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 \
libgl1-mesa-dev g++-multilib mingw32 tofrodos \
python-markdown libxml2-utils xsltproc zlib1g-dev:i386
$ sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so
Installing required packages (Ubuntu 10.04 -- 11.10)
Code:
$ sudo 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 xsltproc
On Ubuntu 10.10:
Code:
$ sudo ln -s /usr/lib32/mesa/libGL.so.1 /usr/lib32/mesa/libGL.so
On Ubuntu 11.10:
Code:
$ sudo apt-get install libx11-dev:i386
3) Configure your USB.
Code:
$ gksudo gedit /etc/udev/rules.d/51-android.rules
Inside of this blank text file insert:
Code:
#Acer
SUBSYSTEM=="usb", ATTR{idVendor}=="0502", MODE="0666"
#ASUS
SUBSYSTEM=="usb", ATTR{idVendor}=="0b05", MODE="0666"
#Dell
SUBSYSTEM=="usb", ATTR{idVendor}=="413c", MODE="0666"
#Foxconn
SUBSYSTEM=="usb", ATTR{idVendor}=="0489", MODE="0666"
#Garmin-Asus
SUBSYSTEM=="usb", ATTR{idVendor}=="091E", MODE="0666"
#Google
SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666"
#HTC
SUBSYSTEM=="usb", ATTR{idVendor}=="0bb4", MODE="0666"
#Huawei
SUBSYSTEM=="usb", ATTR{idVendor}=="12d1", MODE="0666"
#K-Touch
SUBSYSTEM=="usb", ATTR{idVendor}=="24e3", MODE="0666"
#KT Tech
SUBSYSTEM=="usb", ATTR{idVendor}=="2116", MODE="0666"
#Kyocera
SUBSYSTEM=="usb", ATTR{idVendor}=="0482", MODE="0666"
#Lenevo
SUBSYSTEM=="usb", ATTR{idVendor}=="17EF", MODE="0666"
#LG
SUBSYSTEM=="usb", ATTR{idVendor}=="1004", MODE="0666"
#Motorola
SUBSYSTEM=="usb", ATTR{idVendor}=="22b8", MODE="0666"
#NEC
SUBSYSTEM=="usb", ATTR{idVendor}=="0409", MODE="0666"
#Nook
SUBSYSTEM=="usb", ATTR{idVendor}=="2080", MODE="0666"
#Nvidia
SUBSYSTEM=="usb", ATTR{idVendor}=="0955", MODE="0666"
#OTGV
SUBSYSTEM=="usb", ATTR{idVendor}=="2257", MODE="0666"
#Pantech
SUBSYSTEM=="usb", ATTR{idVendor}=="10A9", MODE="0666"
#Philips
SUBSYSTEM=="usb", ATTR{idVendor}=="0471", MODE="0666"
#PMC-Sierra
SUBSYSTEM=="usb", ATTR{idVendor}=="04da", MODE="0666"
#Qualcomm
SUBSYSTEM=="usb", ATTR{idVendor}=="05c6", MODE="0666"
#SK Telesys
SUBSYSTEM=="usb", ATTR{idVendor}=="1f53", MODE="0666"
#Samsung
SUBSYSTEM=="usb", ATTR{idVendor}=="04e8", MODE="0666"
#Sharp
SUBSYSTEM=="usb", ATTR{idVendor}=="04dd", MODE="0666"
#Sony Ericsson
SUBSYSTEM=="usb", ATTR{idVendor}=="0fce", MODE="0666"
#Toshiba
SUBSYSTEM=="usb", ATTR{idVendor}=="0930", MODE="0666"
#ZTE
SUBSYSTEM=="usb", ATTR{idVendor}=="19D2", MODE="0666"
4) Save the file and close it and then issue this command:
Code:
$ sudo chmod a+r /etc/udev/rules.d/51-android.rules
4a) [OPTIONAL] Setting up ccache
You can optionally tell the build to use the ccache compilation tool. Ccache acts as a compiler cache that can be used to speed-up rebuilds. This works very well if you do "make clean" often, or if you frequently switch between different build products.
Put the following in your .bashrc or equivalent.
Code:
export USE_CCACHE=1
By default the cache will be stored in ~/.ccache. If your home directory is on NFS or some other non-local filesystem, you will want to specify the directory in your .bashrc as well.
Code:
export CCACHE_DIR=<path-to-your-cache-directory>
The suggested cache size is 50-100GB. You will need to run the following command once you have downloaded the source code:
Code:
prebuilts/misc/linux-x86/ccache/ccache -M 50G
This setting is stored in the CCACHE_DIR and is persistent.
5) Install the repo:
Code:
$ mkdir ~/bin
$ PATH=~/bin:$PATH
$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
6) Initialize the repo:
Code:
$ mkdir WORKING_DIRECTORY
$ cd WORKING_DIRECTORY
6a) For AOSP:
Code:
$ repo init -u https://android.googlesource.com/platform/manifest -b android-4.4.4_r2
6.1) For people who have already done a repo init:
Code:
$ cd WORKING_DIRECTORY
AOSP:
Code:
$ repo init -b android-4.4.4_r2
$ repo sync
7) When prompted, enter your real name and email address.
8) Gather the files:
Code:
$ repo sync
9) Continue onto adding a device
~How To Add A Device To The List~
1) Find the github for your device you wish to add. (For me it is the Asus Nexus 7 (2013) [codename: flo]
2) Now navigate to the location you are going clone the device tree to:
Code:
$ cd WORKING_DIRECTORY/device
$ mkdir asus
3) Clone the github device tree from remote to local: (The name after the branch would be whatever you want that folder to be named so make sure it is whatever standard name would be for your device, example: Nexus One [passion], Nexus S [crespo], Motorola Droid [sholes], HTC Incredible [inc], etc.)
Code:
$ git clone https://android.googlesource.com/device/asus/flo -b kitkat-dev flo
4) Now navigate into the folder:
Code:
$ cd flo
5) Connect phone to computer and make sure USB debugging is enabled and you have adb set up.
6) Extract Device Proprietary Files (if extract script is present):
Code:
$ ./extract-files.sh
Or:
Code:
./proprietary-files.sh
Or: See use your device's provided proprietary blobs (like flo): Download the binaries from: https://developers.google.com/android/nexus/drivers
Extract the blobs and place them in the directory from the root of your working directory (ex. vendor/asus/flo): vendor/MANUFACTUROR/CODENAME
7) Navigate back to your home directory for building:
Code:
$ cd ~/WORKING_DIRECTORY
8) Prepare To Compile:
Code:
$ source build/envsetup.sh
Or:
Code:
$ . build/envsetup.sh
9) Get your list of devices:
Code:
$ lunch
10) Pick your poison.
11) Now compile ('#' being the number of cores in your processor +1):
Code:
$ make -j#
Or for a flashable zip:
Code:
$ make -j# otapackage
~FIXES~
If you are running into issues such as:
Code:
Which would you like? [full-eng] 5
build/core/product_config.mk:209: *** No matches for product "full_d710". Stop.
Device d710 not found. Attempting to retrieve device repository from CyanogenMod Github (http://github.com/CyanogenMod).
Repository for d710 not found in the CyanogenMod Github repository list. If this is in error, you may need to manually add it to your local_manifest.xml.
build/core/product_config.mk:209: *** No matches for product "full_d710". Stop.
** Don't have a product spec for: 'full_d710'
** Do you have the right repo manifest?
What you need to do is to edit your blob to match the PRODUCT_NAME to the file name. For example with mine I have full_d710.mk therefore in this file I need to have PRODUCT_NAME to match it. Whatever error it is looking for you just need to change the PRODUCT_NAME line to match what the error shows.
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
If you run into issues with Java being the incorrect version here is the fix:
Make sure Java 6 JDK is installed by typing in:
Code:
$ java -version
Open the file main.mk in build/core and delete this line from the java error code section:
Code:
$(error stop)
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Android 4.1+ needs an insecure kernel to use adb: http://forum.xda-developers.com/showthread.php?t=1687590
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
This tutorial is based off this one: http://source.android.com/index.html

---

First
Great tut bro...thanks

---

And it returns
Team Nocturnal Developer

---

Nice d, well written for sure
Sent from my EVO using Tapatalk

---

You help me so much with this completly guide, did you think that work good with Zorin OS? I wanna try this distro based on Ubuntu.

---

So I'm a straight up beginner here, so bear with me...
I followed your guide to get everything setup, and I've learned so much already! I've gotten to the point of running the make command for my device, but I'm getting stuck on an error. I've tried to search this up as best as I could before posting here, but I'm at a loss lol.
make: *** No rule to make target `out/target/product/vs980/kernel', needed by `out/target/product/vs980/boot.img'. Stop.
make: *** Waiting for unfinished jobs....
Click to expand...
Click to collapse
Obviously this has to do with the kernel, but I believe I have all my files in the correct place. Maybe someone can point me in the right direction?

---

WARNING!!! I am about to ask 2 stupid and nooby questions:
1.This tutorial is for building a KIt Kat ROM right?
2.After repo sync I am stuck. I have an HTC Flyer and it's pretty much abandoned by HTC. Very few devs are working on it. So my question is are these the right files i need to clone?
https://github.com/FlyerICS/android_device_htc_flyer
Thank you for your time? And sorry if these are stupid question but I am still learning

---

I'm syncing 4.4-r1(kitkat) sources from aosp after the sync tree is 100% complete i got this error.
Syncing work tree: 100% (407/407), done.
error: device/google/accessory/demokit/: device/google/accessory/demokit checkout f414529d6ff582a1d3f739710fb668587dfb4461
[email protected]:~/WORKING_DIRECTORY$
Click to expand...
Click to collapse
any idea what should i do ??

---

And for Mako use proprietary binaries from your mako extract and in lunch menu select 8 it will build for KitKat for mako.
all features working and initial screen captures @ plus.google.com/u/0/109701627813546607713/posts
---------- Post added at 09:43 AM ---------- Previous post was at 09:39 AM ----------
aviz1911 said:
I'm syncing 4.4-r1(kitkat) sources from aosp after the sync tree is 100% complete i got this error.
any idea what should i do ??
Click to expand...
Click to collapse
i was also getting some error, now able to recall, but i suggest go ahead and build. that will be ultimate test.
Also instead of just "repo sync " to save time use "repo sync -c -d"
~Amit

---

hello.i have a ubuntu 13.10,but your guide is only for ubuntu 12 and below,so what is the command to install required package?

---

try this :
http://www.scottsroms.com/showthrea...vices-Build-AOSP-from-Scratch-on-Ubuntu-13-10
hisname said:
hello.i have a ubuntu 13.10,but your guide is only for ubuntu 12 and below,so what is the command to install required package?
Click to expand...
Click to collapse

---

Thanks. Nice guide..

---

Hi everybody!!
A question for all developpers:
Why since android 4.1, i cannot compile correctly executable files (like adb, adbd etc etc)? (4.0.4 no problem)
I have found that executable.mk in build/core folder is in cause:
Code:
ifeq ($(LOCAL_FORCE_STATIC_EXECUTABLE),true)
$(linked_module): $(my_target_crtbegin_static_o) $(all_objects) $(all_libraries) $(my_target_crtend_o)
$(transform-o-to-static-executable)
else
$(linked_module): $(my_target_crtbegin_dynamic_o) $(all_objects) $(all_libraries) $(my_target_crtend_o)
$(transform-o-to-executable)
endif
When LOCAL_FORCE_STATIC_EXECUTABLE is include in Android.mk of executable, the file in correct in output, but if the option is not present, my files are compiled like Share Lib.......?
What's the cause of this problem?
-toolchain?
-version of ubuntu (10.04 updated)?
-version of gcc/gxx from my computer (don't know if it uses any part of it)?
-if y try to compile it with another toolchain, will my files be correct in output?
Maybe Dastin can help me?
Many thanks for your help.
Bizcuite

---

Hello, I made a build for mako today... Bootloop...
I think these lines of the log are the issue
Code:
F/libEGL ( 804): couldn't find an OpenGL ES implementation
F/libc ( 804): Fatal signal 6 (SIGABRT) at 0x00000324 (code=-6), thread 804
I haven't touched the original code. Built as is
Full logcat has been attached.
Thank you for your help.
EDIIT: Lol, I was missing binary files it turns out.

---

hi, can someone help me with this error
Code:
target thumb C++: content_content_common_gyp <= external/chromium_org/content/common/android/device_telephony_info.cc
target thumb C++: content_content_common_gyp <= external/chromium_org/content/common/android/hash_set.cc
In file included from external/chromium_org/content/common/android/hash_set.cc:5:0:
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:10:26: error: extra tokens at end of #ifndef directive [-Werror]
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:11:26: error: missing whitespace after the macro name [-Werror]
target thumb C++: content_content_common_gyp <= external/chromium_org/content/common/android/surface_texture_peer.cc
In file included from external/chromium_org/content/common/android/hash_set.cc:5:0:
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:24:20: error: expected initializer before '<' token
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:26:17: error: expected initializer before '<' token
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:29:22: error: expected '{' before '<' token
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:29:22: error: expected unqualified-id before '<' token
external/chromium_org/content/common/android/hash_set.cc:30:1: error: expected '}' at end of input
cc1plus: all warnings being treated as errors
make: *** [/root/sagaCM/cm11/target/product/saga/obj/STATIC_LIBRARIES/content_content_common_gyp_intermediates/content/common/android/hash_set.o] Error 1
thanks

---

kylon said:
hi, can someone help me with this error
Code:
target thumb C++: content_content_common_gyp <= external/chromium_org/content/common/android/device_telephony_info.cc
target thumb C++: content_content_common_gyp <= external/chromium_org/content/common/android/hash_set.cc
In file included from external/chromium_org/content/common/android/hash_set.cc:5:0:
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:10:26: error: extra tokens at end of #ifndef directive [-Werror]
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:11:26: error: missing whitespace after the macro name [-Werror]
target thumb C++: content_content_common_gyp <= external/chromium_org/content/common/android/surface_texture_peer.cc
In file included from external/chromium_org/content/common/android/hash_set.cc:5:0:
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:24:20: error: expected initializer before '<' token
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:26:17: error: expected initializer before '<' token
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:29:22: error: expected '{' before '<' token
/root/sagaCM/cm11/target/product/saga/obj/GYP/shared_intermediates/content/jni/HashSet_jni.h:29:22: error: expected unqualified-id before '<' token
external/chromium_org/content/common/android/hash_set.cc:30:1: error: expected '}' at end of input
cc1plus: all warnings being treated as errors
make: *** [/root/sagaCM/cm11/target/product/saga/obj/STATIC_LIBRARIES/content_content_common_gyp_intermediates/content/common/android/hash_set.o] Error 1
thanks
Click to expand...
Click to collapse
You're using jdk 7, switch to 6

---

I m using oracle j7 and it s working with cm10x.
Why cm11 would need an older version
Inviato dal mio Desire S utilizzando Tapatalk

---

kylon said:
I m using oracle j7 and it s working with cm10x.
Why cm11 would need an older version
Inviato dal mio Desire S utilizzando Tapatalk
Click to expand...
Click to collapse
Because the jni header files, based on generic java classes, are messed with jdk 7, you for sure can alter the python file instead which generates them, but most roms use aosp of chromium and no fork, so there isn't really anything you can push this change to (except you do your own fork).
Also at every rom jdk 6 is recommended, jdk 7 fixes are just included as nice to have, when the whole thing got stable enough.

---

dastin1015 said:
6a) For AOSP:
Code:
$ repo init -u https://android.googlesource.com/platform/manifest -b android-4.4_r1
Click to expand...
Click to collapse
When doing this step I get this error:
Code:
[B]fatal: unable to auto-detect email address (got '[email protected](none)')[/B]
How to fix?

---

You need to use the git config command to set your name and email. Look up the syntax, I'm not at home just now.
Sent from my SAMSUNG-SGH-I717 using XDA Premium 4 mobile app