• Git 1.5.4 or newer. Instructions for how to install and configure Git are below.
• Python 2.4, which you candownload from python.org.
• JDK 5.0, update 12 or higher, which you candownload from java.sun.com.
• The following packages:flex, bison, gperf, libsdl-dev, libesd0-dev, libwxgtk2.6-dev (optional), build-essential. To make sure you have all these packages, run
  $ sudo apt-get install flex bison gperflibsdl-dev libesd0-devlibwxgtk2.6-dev build-essential
  
• You might also want Valgrind, a tool that will help you find memory leaks, stack corruption, array bounds overflows, etc. To install it, run
  $ sudo apt-get install valgrind
  

Mac OS

Requirements:

• To build the Android files in a Mac OS environment, you need an Intel/x86 machine. The Android build system and tools do not support the obsolete PowerPC architecture.
• We recommend that you build Android on a partition that has been formatted with the "Case-sensitive Journaled HFS+" file system:
  • A case-sensitive file system is required because the sources contain files that differ only in case.
  • Journaled systems are more robust. (This is optional, but recommended.)
  • HFS+ is required to successfully build Mac OS applications such as the Android Emulator for OS X.

1. Install the XCode version 2.4 or later fromhttp://developer.apple.com. We recommend version 3.0 or newer.
2. Install MacPorts. To do this:
   1. Download the tar file fromhttp://www.macports.org/and untar the files.
   2. Run the following:
      $ ./configure
      $make
      $sudo make install
      $sudo port selfupdate
   3. View your path:
      $echo $PATH
      Make sure that/opt/local/binis in your path before/usr/bin. If not, edit$HOME/.bash_profileand add the line "export PATH=/opt/local/bin:$PATH" (or the equivalent for other shells) after any other PATH-related lines.To verify that your path is now correct, open a new terminal andrunecho $PATHagain.
3. Upgrade GNU make to 3.81 or later by running
   $ sudo port install gmake
   $ sudo ln -s gmake /opt/local/bin/make
4. Install libsdl by running
   $ sudo port install libsdl
5. Set an appropriate per-process file descriptor limit. To do this, add the following lines to your.bash_profilefile:
   # set the number of open files to be 1024
   ulimit -S -n 1024
6. Install these optional packages, if you want to:
   $ sudo port install xemacs +sumo
   $ sudo port install gimp

Installing Git

To work with the Android source files, you will need to use the Git open-source version control system and several complementary tools:

• Repois a wrapper script that makes it easier to work with Git in the context of Android.
• Gerritis a visual interface for tracking, commenting on, and approving changes to the code.

To install Git and set up your files for the installation of Repo, follow these steps:

1. Make sure you have a~/bindirectory in your home directory, and check to be sure that this bin directory is in your path:
   $ cd~
   $ mkdir bin
   $ echo $PATH
   
2. Install Git and the GNU Privacy Guard:
   - For Linux, runsudo apt-get install git-core gnupg
   - For Mac OS:
   1. Runsudo port install gnupg
   2. Download the latest Git fromhttp://git.or.cz/.
   3. Untar the file, then cd into the Git directory.
   4. Runmake install.

Installing Repo

Getting the files

To pull down files to your working directory from the repositories as specified in the default manifest, run

$ repo sync

For more aboutrepo syncand other Repo commands, seeUsing Repo.

The Android source files will be located in your working directory under theirprojectnames.

Building the code

To build the files, runmakefrom within your working directory:
$ cd ~/mydroid
$ make