Project

General

Profile

SDK » History » Version 5

John Smith, 02/18/2012 08:03 PM

1 1 John Smith
h1. SDK
2
3
h2. Rationale
4
5
Replicant uses its own SDK, which differs notably from the default Android SDK, as the latter contains non-free components.
6
7
[TODO: it might be helpful to try to list those, and summarize their functionality]
8
9
h2. Obtaining the Replicant SDK
10
11
The Replicant SDK can be obtained via FTP from:
12
13
http://ftp.osuosl.org/pub/replicant/sdk/0001/
14
15
h2. Installing the Replicant SDK
16
17
h3. Dependencies
18
19 5 John Smith
h4. Java Development Kit (JDK)
20 1 John Smith
21
You need a computer with a Java SE (Standard Edition) development kit version 1.6 or greater installed.
22
23 2 John Smith
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.
24 1 John Smith
25 2 John Smith
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.
26
27 3 John Smith
h4. Eclipse
28 1 John Smith
29
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.
30
31 3 John Smith
h3. Installing the "Android Development Tools" plugin for Eclipse
32 1 John Smith
33
If you have Eclipse installed and running properly, you need to install the Android Development Tools plugin.
34
35
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.
36
37
A somewhat manual solution:
38
39
* download ADT 0.9.8 into a stable location in your computer
40
41
http://dl.google.com/android/ADT-0.9.8.zip
42
Size: 8301417 B
43
MD5: 27e0de800512f13feae46fb554e6ee2f
44
45
* in Eclipse 3.5
46
47
- select "Window" > "Preferences" > "Install/Update" > "Available Software Sites"
48
- click the "Add" button
49
- name your software site something recognizable, e.g. "ADT 0.9.8"
50
- click "Archive" and select the "ADT-0.9.8.zip" file
51
52
* in Eclipse 3.5
53
54
- select "Help" > "Install New Software"
55
- select the "ADT 0.9.8" software site from the dropdown menu
56
- select the "Developer Tools" software package
57
- verify that the "Android DDMS" and "Android Development Tools" sub-packages were selected
58
- click the "Next" to install Android Developer Tools
59
60 2 John Smith
* restart Eclipse
61
62 1 John Smith
h3. Pointing "Android Development Tools" to the SDK directory
63
64 3 John Smith
When you have installed ADT and restarted Eclipse, select "Window" > "Preferences".
65
66 4 John Smith
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).
67 2 John Smith
68
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".