SDK » History » Revision 11

Revision 10 (John Smith, 03/18/2012 12:53 PM) → Revision 11/61 (John Smith, 03/18/2012 12:56 PM)

h1. SDK 

 h2. Rationale 

 Replicant uses its own SDK, which differs notably from the default Android SDK, as the latter contains non-free components. 

 [TODO: it might be helpful to try to list those, and summarize their functionality] 

 h2. Obtaining the Replicant SDK 

 The Replicant SDK can be obtained via FTP from: 

 h2. Installing the Replicant SDK 

 h3. Dependencies 

 h4. Java Development Kit (JDK) 

 You need a computer with a Java SE (Standard Edition) development kit version 1.6 or greater installed. 

 Unless the Java installer for your platform does this automatically (installing an OpenJDK package from a repository under most Linux distributions does this) you may need to add your Java SDK's "bin" directory into your "PATH" environment variable, so that the command "javac" starts when issued from command line. 

 In some unlikely cases, creating a "JAVA_HOME" environment variable and pointing it to your JDK's true install location (not the "bin" directory but one level upward) may prove necessary. 

 h4. Eclipse 

 You also need the Eclipse development environment -- preferably version 3.5. Version 3.6 is cautioned against in SDK documentation, mentioning that it currently has known isses. 

 h3. Installing the "Android Development Tools" plugin for Eclipse 

 If you have Eclipse installed and running properly, you need to install the Android Development Tools plugin. 

 A solution for Eclipse 3.6 (not advised): some documentation recommends adding "" as a software update site in Eclipse, and pulling ADT from there. People have observed that this currently results in getting an ADT version which requires Eclipse 3.6, which has known issues and is not available in some widespread Linux distributions (e.g. Debian) at the moment. 

 A somewhat manual solution: 

 * download ADT 0.9.8 into a stable location in your computer 
 Size: 8301417 B 
 MD5: 27e0de800512f13feae46fb554e6ee2f 

 * in Eclipse 3.5 

 - select "Window" > "Preferences" > "Install/Update" > "Available Software Sites" 
 - click the "Add" button 
 - name your software site something recognizable, e.g. "ADT 0.9.8" 
 - click "Archive" and select the "" file 

 * in Eclipse 3.5 

 - select "Help" > "Install New Software" 
 - select the "ADT 0.9.8" software site from the dropdown menu 
 - select the "Developer Tools" software package 
 - verify that the "Android DDMS" and "Android Development Tools" sub-packages were selected 
 - click the "Next" to install Android Developer Tools 

 * restart Eclipse 

 h3. Pointing "Android Development Tools" to the SDK directory 

 When you have installed ADT and restarted Eclipse, select the "Window" menu. You should see a menu entry named "Android SDK and AVD Manager". Then select "Preferences" from the "Window" menu. A menu item named "Android" should be available on the left panel. 

 If not, something is wrong. You might have the wrong flavour of Eclipse installed (the Classic, Java or RCP flavours are recommended). For example, it has been observed that the default Eclipse version which installs under Debian 6.0 ("squeeze") does not install ADT correctly, while an installation of Eclipse Classic 3.5.2 ("Galileo") basing on a downloaded from "eclipse-SDK-3.5.2-linux-gtk.tar.gz" (MD5: bde55a2354dc224cf5f26e5320e72dac) file, works fine.  

 Once the "Android" menu item is available in the "Window" > "Preferences" dialog, select it. In the main panel, click the "Browse" button for the "SDK Location" field, and point it to the directory where you unzipped your Replicant SDK. Then click "Apply" and "OK".