Replicant

== Required Packages ==

 * bison

 * flex

 * git (git-core)

 * gperf

 * libncurses development headers (libncurses-dev)

 * make (build-essential)

 * mksquashfs (squashfs-tools)

 * openjdk

 * pngcrush - the build process will complain if it is not installed but builds will complete.

 * wget (or curl)

 * zip

 * zlib development headers (zlib1g-dev)

 * lzma

=== Additional requirements for amd64 ===

 * libc6-dev-i386

 * gcc-multilib

 * g++-multilib 

 * lib32z1-dev 

 * lib32readline5-dev

 * lib32ncurses5-dev

 * 32-bit compatibility libraries

 * If you see errors about incompatible library versions, you may need some symlinks. For example:

   * sudo ln -s /usr/lib32/libstdc++.so.6.0.14 /usr/lib32/libstdc++.so

   * sudo ln -s /usr/lib32/libz.so.1.2.3.4 /usr/lib32/libz.so

== Warning ==

 Do not build as root, always build as user.

== Setup ==

Get and install the repo tool

{{{

 mkdir bin

 cd bin

 wget http://android.git.kernel.org/repo

 chmod a+x repo

 cd ..

}}}

Get replicant 2.2

{{{

 mkdir replicant-2.2

 cd replicant-2.2

 ../bin/repo init -u git://gitorious.org/replicant/manifest.git -b replicant-2.2

 ../bin/repo sync

}}}

== Each time you want to build replicant 2.2 ==

{{{

cd ~/replicant-2.2

 ../bin/repo sync

source build/envsetup.sh

export ANDROID_JAVA_HOME=$JAVA_HOME

lunch replicant_dream_sapphire-eng 

make -j$(echo "$(grep 'processor' /proc/cpuinfo | wc -l ) + 1" | bc) distimages  #uses arguments like -j9 to speed up build in case of multi-core cpu

}}}

Note that you can use {{{bacon}}} instead of {{{distimages}}} to produce a more complete set of images, including zip files. 

Don't forget the {{{distimages}}}/{{{bacon}}} at the end, without that you will have some build errors.

You will find your built images in ./out/target/product/dream_sapphire/.

You will also find fastboot, needed to install the images, in ./out/host/linux-x86/bin/.

Now you are ready to [http://trac.osuosl.org/trac/replicant/wiki/Installation install!]