SDK¶

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]

Obtaining the Replicant SDK¶

The Replicant SDK can be obtained via FTP from:

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

Installing the Replicant SDK¶

Dependencies¶

JDK (Java Development 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.

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.

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

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 insalled (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".