Android and the RTC rich client both operate within Eclipse. This gives us a great platform for seamlessly developing Android-based software, managing projects, controlling assets, and performing continuous builds. Android and RTC play well together, but there are a few extra setup steps required to introduce them to each other. This post describes those steps.
Android likes the JDK from the Java organization. When you select the version of the JDK to download, use the 32-bit version for for Windows.
Download the RTC client from jazz.net. This installation procedure was tested using the Standard version so I recommend using that one. Download the version that uses the Installation Manager (IM), as provided in the link.
The Android SDK must be available to RTC to do Android development.
Install JDK 1.6
Install JDK 1.6 per the instructions for that software.
Install the Android SDK
Unzip the SDK directory and place it wherever you want.
Install RTC 22.214.171.124
Unzip the RTC installation download and start launchpad.exe in the RTC directory. Select the option to Launch IBM Installation Manager to Update Existing Product Components even though you’re installing from scratch.
IM will be installed if necessary. Restart IM when asked to do so.
RTC must be installed using at least version 1.3.3 of Installation Manager (IM) to make sure we’re getting all the plug-ins we need. The version of IM (as of this writing) that ships with 126.96.36.199 is earlier than that, and the most recent version is 1.4. So first thing we do in IM is tell it to upgrade itself.
- Select File>Preferences>Update>Search for Installation Manager Updates, then select OK.
- Select Update on the main IM screen.
- Update IM when prompted.
- Restart IM when prompted.
- Add the RTC installation repository to IM by selecting File>Preferences>Repositories>Add Repository.
- Navigate to the directory where the RTC installation files are, go into the im-repo directory, and selectrepository.config. Select OK to all the dialogs until you’re back to the main window in IM.
- Select Install.
- Select Rational Team Concert – Client for Eclipse IDE Version 188.8.131.52 iFix3 and select Next.
- Accept the terms of the license agreement and select Next.
- Select Create a new package group and enter the installation directory (the default will usually be fine). Select Next.
- Do not extend the existing Eclipse installation. Select Next.
- Select your languages, then select Next.
- If you want to use Sametime with RTC, select Sametime Integration Update Site. If you’re not sure, leave it blank. Select Next.
- Select Install.
After RTC is installed you can close IM and Launchpad.
Change the JRE
- Launch the RTC Eclipse Client.
- Select Windows>Preferences>Java>Installed JREs.
- Select Add.
- Select Standard VM, then Next.
- Select Directory… and navigate to the root directory where you installed JDK 1.6, for example c:\program files\java\jdk1.6.1_21.
- Select Finish.
- Select the checkmark next to the location you just created, then select OK.
Install the Android Developer Tools Plugin
Add the ADT installation site to the list of Eclipse install sites and install the plugins.
- Select Help>Software Updates>Available Software
- Select Add Site…
- Enter the location https://dl-ssl.google.com/android/eclipse (use http: if https: doesn’t work).
- Select everything under the site you just entered, then select Install.
- Restart RTC when prompted.
If you get a message that you are unable to install the ADT plugin because of dependencies that are not present, do the following:
- Add http://download.eclipse.org/eclipse/updates/3.4 as an update site in Available Software.
- Select everything under Eclipse SDK.
- Select Install, and restart RTC when prompted.
- Repeat the procedure described above to install the ADT plugin.
This issue has been seen when installing ADT in RTC under 64-bit Windows 7.
Add the location of the Android SDK
- Select Window>Preferences>Android>Browse.
- Navigate to where you placed the Android SDK directory.
- Select OK.
- Select the AVD Manager (toolbar or menu option) and load the Android platforms you want.
- Exit RTC.
Go to the RTC installation directory and open the eclipse.ini file in a text editor. Edit the line that specifies the virtual machine so it points to the directory that holds the JVM for JDK 1.6. This is the line after the -vm command. The lines in the eclipse.ini file should look something like this:
Remove IBM JVM arguments from eclipse.ini by deleting lines that have xjit:exclude…in them.
Edit RTC Command Line Options
There are a few useful (and necessary) command line options that should be set when you launch RTC for Android development. The easiest way to do this is to create a Windows shortcut and add the options to the command line of the Target field.
It’s usually desirable, though not required, to specify our own Eclipse workspace. You can have any number of workspaces. Each maintains information such as window positions, current projects, etc. If you don’t specify a workspace you’ll always work in the default workspace. Keep things clean by managing your own workspaces instead.
Specify a workspace directory by using the -data option on the command line. The following example of a command line would launch Eclipse (or RTC) and use the myworkspace directory as the workspace instead of the default workspace:
c:\eclipse\eclipse.exe -data “c:\My Workspaces\myworkspace”
The full command line of your shortcut should look something like this:
“c:\program files\ibm\team concert\eclipse.exe” -data “c:\my workspaces\android project” -product com.ibm.team.concert.product -vmargs -Xmx512M -XX:MaxPermSize=128M
Launch RTC using the shortcut. You’re now ready to develop Android applications within RTC.
If you create and run an Android application and you get the message Unable to find [filename].adk, you have probably not identified the correct JDK and JRE. Go to Window>Preferences>Java>Installed JREs and add the path to JDK 1.6 (see the section Install RTC 184.108.40.206 for instructions).
If you get errors that indicate dependent plug-ins are not present when installing the ADT plugin, you have probably performed the steps out of order. In particular, you may have edited the eclipse.ini file before installing the ADT plugin. Revert to the original config.ini, start RTC, install the ADT plugin, then revert back to the modified config.ini.
This article applies to: RTC 220.127.116.11 Standard Client ifix 3, Eclipse 3.4, Android Development Toolkit (ADT) 0.9.7Windows XP SP3, Windows 7 (64-bit). The installation steps were tested under Windows XP SP3 and Windows 7 (64-bit). Linux hasn’t been verified at this time, but the steps should be similar.
This entry was posted in Uncategorized
and tagged android
. Bookmark the permalink