Project

General

Profile

SDK » History » Revision 5

Revision 4 (John Smith, 02/18/2012 08:02 PM) → Revision 5/62 (John Smith, 02/18/2012 08:03 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: 

 http://ftp.osuosl.org/pub/replicant/sdk/0001/ 

 h2. Installing the Replicant SDK 

 h3. Dependencies 

 h4. Java JDK (Java Development Kit (JDK) Kit) 

 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 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 Eclpse 3.6 (not advised): some documentation recommends adding "https://dl-ssl.google.com/android/eclipse/" 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 

 http://dl.google.com/android/ADT-0.9.8.zip 
 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 "ADT-0.9.8.zip" 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 "Window" > "Preferences". 

 Verify that a menu item named "Android" is 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). 

 If the "Android" menu item is available, 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".