I remember to readers that there is a script to generate those on this blog post, where I also explain how to use those files.

For the ones that want to avoid to run my buggy script, in this blog post you can find some source bundles for android versions, ready for use.

Recently I'm very busy at work and in the spare time so I am not posting regularly; my todo list (or topost list) for this blog is getting long.

Just in case I'll not find time to write here before... Happy Christmas.

For myself usage I packed the android sources into some jar files. To have them linked properly in Eclipse, you need to download them and unpack in the proper directory under the Android SDK.

Here the files and the folder where they should be unpacked.

1. android-sdk-1.5_r3-src.jar unpack to ANDROID_SDK_HOME/platforms/android-3/sources
2. android-sdk-1.6_r2-src.jar unpack to ANDROID_SDK_HOME/platforms/android-4/sources
3. android-sdk-2.0.1_r1-src.jar unpack to ANDROID_SDK_HOME/platforms/android-6/sources
4. android-sdk-2.1_r1-src.jar unpack to ANDROID_SDK_HOME/platforms/android-7/sources

You don't need to unpack the files if you don't use Eclipse, as probably your IDE is able to reference source-jars for libraries in the CLASSPATH.

Very soon Android 2.2 will be released, you can build the source-jar with the utility I published yesterday, that is a bash script which runs in OSX and hopefully on Linux as well (the "find" utility may differ a little bit on Linux). Drop me a comment here, if you have problems, and I will pack it for you.

The trick, how explained here, is to download the sources and copy them into android-sdk/platforms/android-X/sources folder (where X is the API version).

For example, supposing I've installed the SDK into ~/opt/android-sdk-mac_86 on my Mac, and I am developing an application with Android 1.5 (API level 3). I should download the source files from Android website using git. Then I need to checkout the sources with tag name "android-sdk-1.5_r3", collect all the source files and move them into the directory ~/opt/android-sdk-mac_86/platforms/android-3/sources.

Here's my source tree under android-sdk-mac_86/platforms; in red color the directory where to put the sources:

luigi@hal9000:~/opt/android-sdk-mac_86$ tree -L 2  platforms
platforms/
|-- android-3
|   |-- android.jar
|   |-- build.prop
|   |-- data
|   |-- framework.aidl
|   |-- images
|   |-- samples
|   |-- skins
|   |-- source.properties
|   |-- sources
|   |-- templates
|   `-- tools
|-- android-4
|   `-- ...
|-- android-6
|   `-- ...
`-- android-7
    `-- ...

Creating a directory and copy some files inside it's not much complicate. But once you downloaded the sources, you'll discover that they are spread in several sub-directories. Also you need some practice with git command line utility to download the sources check available tags, switch to the proper source tree, then package all the source files into a folder or an archive.

I created following script, which runs on OSX (and hopefully on Linux as well).

luigi@hal9000:~$ cat bin/android-src-build.sh

#!/bin/sh 

SRC_DIR=/tmp/android-api

print_syntax() {
   echo "Syntax:\n\t$(basename $0) [option]"
   echo "\nOptions:"
   echo "\t-l prints available versions"
   echo "\t-v builds jar file with sources of specified version"
   echo "\t-c cleans up the sources from the temp directory\n"
   exit 1
}

error() {
   echo "Error:" $1
   exit 1
}

download_sources() {
    if [[ ! -d $SRC_DIR ]]; then
        git clone git://git.source.android.com/platform/frameworks/base $SRC_DIR
    fi
}

if ! which git > /dev/null ; then
    error "git not installed (or not in the PATH)"
fi

if ! which jar > /dev/null ; then
    error "jar not installed (or not in the PATH)"
fi

if [[ "$1" == "-l" ]]; then
    download_sources
    cd $SRC_DIR
    git tag -l
    exit 0;
fi

if [[ "$1" == "-c" ]]; then
    rm -rf $SRC_DIR
    exit 0;
fi

if [[ "$1" == "-v"  && ! -z "$2"  ]]; then
    JAR_FILE=$(pwd)/$2-src.jar
    download_sources
    cd $SRC_DIR
    if ! git tag -l | grep $2 ; then
        echo "Version \"$2\" not found"
        exit 1;
    fi
    git checkout $2
    touch $JAR_FILE
    find . -depth 2 -name "java" -type d -exec jar uf $JAR_FILE -C {} . \;
    exit 0
fi

print_syntax

You can download it here: android-src-build.sh.gz. (It's a bash script: download and execute it at your own risk!)

The script, is able to download the sources from the Android git repository, and, given the version number it packs it into a jar file, that can be lately be unpacked into the sources folder of the Android SDK, where indicated above.

When you run it without parameters it gives you following help:

luigi@hal9000:~$ android-src-build.sh 
Syntax:
        android-src-build.sh [option]

Options:
        -l prints available versions
        -v builds jar file with sources of specified version
        -c cleans up the sources from the temp directory

The -l parameter prints the list of available versions. If the sources have not been already downloaded, the -l will also download them. So the first time, it will take some minutes before displaying the available releases:

luigi@hal9000:~$ android-src-build.sh -l
Initialized empty Git repository in /private/tmp/android-api/.git/
remote: Counting objects: 106183, done.
remote: Compressing objects: 100% (35592/35592), done.
remote: Total 106183 (delta 61793), reused 104978 (delta 60893)
Receiving objects: 100% (106183/106183), 128.07 MiB | 1.52 MiB/s, done.
Resolving deltas: 100% (61793/61793), done.
Checking out files: 100% (8431/8431), done.
android-1.0
android-1.5
android-1.5r2
android-1.5r3
android-1.5r4
android-1.6_r1
android-1.6_r1.1
android-1.6_r1.2
android-1.6_r1.3
android-1.6_r1.4
android-1.6_r1.5
android-1.6_r2
android-2.0.1_r1
android-2.0_r1
android-2.1_r1
android-2.1_r2
android-2.1_r2.1p
android-2.1_r2.1p2
android-2.1_r2.1s
android-sdk-1.5-pre
android-sdk-1.5_r1
android-sdk-1.5_r3
android-sdk-1.6-docs_r1
android-sdk-1.6_r1
android-sdk-1.6_r2
android-sdk-2.0.1-docs_r1
android-sdk-2.0.1_r1
android-sdk-2.0_r1
android-sdk-2.1_r1
android-sdk-tools_r2
android-sdk-tools_r3
android-sdk-tools_r4
android-sdk-tools_r5

Now, let's say that we are developing on Android 1.5, we may want to create a jar file containing all the java sources for that version with:

luigi@hal9000:~$ android-src-build.sh -v android-sdk-1.5_r3
android-sdk-1.5_r3
Note: moving to 'android-sdk-1.5_r3' which isn't a local branch
If you want to create a new branch from this checkout, you may do so
(now or later) by using -b with the checkout command again. Example:
  git checkout -b 
HEAD is now at b69bed1... AI 150122: Merge from donut.   Fix permissions issue for uninstall of updated system applications.   If an existing update for a system application is uninstalled, when reverting back to the existing   version in system partition, permissions have to be granted again.   BUG=1893639
luigi@hal9000:~$ ls -l *.jar
-rw-r--r--  1 luigi  staff  4766477 May 17 15:59 android-sdk-1.5_r3-src.jar

As shown above, after issuing the command a file called android-sdk-1.5_r3-src.jar will be generated into the current directory.
Now the only thing remaining is to expand this file into the folder ~/opt/android-sdk-mac_86/platforms/android-3/sources:

luigi@hal9000:~$ rm -rf /Users/luigi/opt/android-sdk-mac_86/platforms/android-3/sources/
luigi@hal9000:~$ mkdir ~/opt/android-sdk-mac_86/platforms/android-3/sources
luigi@hal9000:~$ cd ~/opt/android-sdk-mac_86/platforms/android-3/sources
luigi@hal9000:~/opt/android-sdk-mac_86/platforms/android-3/sources$ jar xf ~/android-sdk-1.5_r3-src.jar

At this point, restarting eclipse should be enough to have the ADT linked with the source files.

About the platforms available into the Android SDK, under the platform directory, there are following folders: android-3, android-4, android-6, and adroid-7.
I am not 100% sure, but they should correspond to the source code identified respectively by following table:

android-3 = android-sdk-1.5_r3
android-4 = android-sdk-1.6_r2
android-6 = android-sdk-2.0.1_r1
android-7 = android-sdk-2.1_r1

Finally, if you want to remove the sources downloaded you can run the script with the -c (clean) option: it will remove the sources stored temporarily into the folder /tmp/android-api:

luigi@hal9000:~$ android-src-build.sh -c
(no output returned)

Alternatively, you may want to remove the files manually.

Now, after a refresh (or a restart) from Eclipse, the sources from Android classes should look much better:

Check the referenced articles for further information on how to download the android sources, and how the ADT plugin for Eclipse locates the sources for the Android SDK.

I really think that Google should release the sources nicely packed as per the android.jar and make sure they are properly referenced by the ADT. Since then, this is my way.

For questions, mistakes, etc. leave a comment.

References

- Browsing Android Source in Eclipse
- Android sources

-Dosgi.requiredJavaVersion=1.5

to:

-Dosgi.requiredJavaVersion=1.6

Of course, you need to have JDK 1.6 running eclipse.

After the change eclipse starts up very much faster and runs "smooth" as in Windows or Linux.

Additionally I doubled all the memory values in the eclipse.ini file, to grant eclipse more memory resources.

The update URLs to use are the followings:

• http://download.eclipse.org/releases/ganymede
• http://www.polarion.org/projects/subversive/download/eclipse/2.0/ganymede-site/

The first one is already present in Eclipse, the second one, you have to add.

From eclipse menu HELP => Software Updates...
Select Available software Tab.
Click on "Add Site" and specify the URL:

http://www.polarion.org/projects/subversive/download/eclipse/2.0/ganymede-site/

Open the polarion URL open the branch "Subversive SVN Connectors" and check "Subversive SVN Connectors" and "SVNKit 1.1.7 Implementation (Optional)"

Now, open "Ganymede Update Site" branch, then "Collaboration Tools", and check "SVN Team Provider":

Click on install and cross your fingers. It worked for me on Linux, and for one my collegue on Windows XP.

An error has occurred. See error log for more details.
java.lang.NoClassDefFoundError

And when I check the details I see which class is missing and the plugin that is using it:

java.lang.NoClassDefFoundError: org/eclipse/ui/internal/util/SWTResourceUtil
	at org.polarion.team.svn.ui.composite.ResourceSelectionComposite$2.getColumnImage(ResourceSelectionComposite.java:281)
	at org.eclipse.jface.viewers.TableColumnViewerLabelProvider.update(TableColumnViewerLabelProvider.java:71)
	at org.eclipse.jface.viewers.ViewerColumn.refresh(ViewerColumn.java:145)
	at org.eclipse.jface.viewers.AbstractTableViewer.doUpdateItem(AbstractTableViewer.java:386)
	at org.eclipse.jface.viewers.StructuredViewer$UpdateItemSafeRunnable.run(StructuredViewer.java:466)
	at org.eclipse.core.runtime.SafeRunner.run(SafeRunner.java:37)
	at org.eclipse.core.runtime.Platform.run(Platform.java:880)
	at org.eclipse.ui.internal.JFaceUtil$1.run(JFaceUtil.java:48)
	at org.eclipse.jface.util.SafeRunnable.run(SafeRunnable.java:175)
	at org.eclipse.jface.viewers.StructuredViewer.updateItem(StructuredViewer.java:2041)
	at org.eclipse.jface.viewers.AbstractTableViewer.createItem(AbstractTableViewer.java:264)
	at org.eclipse.jface.viewers.AbstractTableViewer.internalRefreshAll(AbstractTableViewer.java:741)
	at org.eclipse.jface.viewers.AbstractTableViewer.internalRefresh(AbstractTableViewer.java:633)
	at org.eclipse.jface.viewers.AbstractTableViewer.internalRefresh(AbstractTableViewer.java:620)
	at org.eclipse.jface.viewers.AbstractTableViewer$2.run(AbstractTableViewer.java:576)
	at org.eclipse.jface.viewers.StructuredViewer.preservingSelection(StructuredViewer.java:1365)
	at org.eclipse.jface.viewers.StructuredViewer.preservingSelection(StructuredViewer.java:1328)
	at org.eclipse.jface.viewers.CheckboxTableViewer.preservingSelection(CheckboxTableViewer.java:296)
	at org.eclipse.jface.viewers.AbstractTableViewer.inputChanged(AbstractTableViewer.java:574)
	at org.eclipse.jface.viewers.ContentViewer.setInput(ContentViewer.java:251)
	at org.eclipse.jface.viewers.StructuredViewer.setInput(StructuredViewer.java:1603)
	at org.polarion.team.svn.ui.composite.ResourceSelectionComposite.createControls(ResourceSelectionComposite.java:358)
	at org.polarion.team.svn.ui.composite.ResourceSelectionComposite.(ResourceSelectionComposite.java:119)
	at org.polarion.team.svn.ui.panel.local.CommitPanel.createControls(CommitPanel.java:205)
	at org.polarion.team.svn.ui.dialog.DefaultDialog.createMainPanel(DefaultDialog.java:329)
	at org.polarion.team.svn.ui.dialog.DefaultDialog.createContents(DefaultDialog.java:190)
	at org.eclipse.jface.window.Window.create(Window.java:431)
	at org.eclipse.jface.dialogs.Dialog.create(Dialog.java:1089)
	at org.polarion.team.svn.ui.dialog.DefaultDialog.create(DefaultDialog.java:218)
	at org.eclipse.jface.window.Window.open(Window.java:790)
	at org.polarion.team.svn.ui.dialog.DefaultDialog.open(DefaultDialog.java:131)
	at org.polarion.team.svn.ui.extension.impl.DefaultCommitActionFactory$1.open(DefaultCommitActionFactory.java:42)
	at org.polarion.team.svn.ui.action.local.CommitAction.runImpl(CommitAction.java:42)
	at org.polarion.team.svn.ui.action.AbstractSVNTeamAction$2.runImpl(AbstractSVNTeamAction.java:61)
	at org.polarion.team.svn.core.operation.AbstractActionOperation.run(AbstractActionOperation.java:70)
	at org.polarion.team.svn.core.operation.LoggedOperation.run(LoggedOperation.java:38)
	at org.polarion.team.svn.core.utility.ProgressMonitorUtility.doTask(ProgressMonitorUtility.java:105)
	at org.polarion.team.svn.core.utility.ProgressMonitorUtility.doTaskExternal(ProgressMonitorUtility.java:91)
	at org.polarion.team.svn.core.utility.ProgressMonitorUtility.doTaskExternal(ProgressMonitorUtility.java:82)
	at org.polarion.team.svn.ui.action.AbstractSVNTeamAction.run(AbstractSVNTeamAction.java:58)
	at org.eclipse.team.internal.ui.actions.TeamAction.runWithEvent(TeamAction.java:548)
	at org.eclipse.ui.internal.PluginAction.runWithEvent(PluginAction.java:241)
	at org.eclipse.jface.action.ActionContributionItem.handleWidgetSelection(ActionContributionItem.java:583)
	at org.eclipse.jface.action.ActionContributionItem.access$2(ActionContributionItem.java:500)
	at org.eclipse.jface.action.ActionContributionItem$5.handleEvent(ActionContributionItem.java:411)
	at org.eclipse.swt.widgets.EventTable.sendEvent(EventTable.java:84)
	at org.eclipse.swt.widgets.Widget.sendEvent(Widget.java:1158)
	at org.eclipse.swt.widgets.Display.runDeferredEvents(Display.java:3401)
	at org.eclipse.swt.widgets.Display.readAndDispatch(Display.java:3033)
	at org.eclipse.ui.internal.Workbench.runEventLoop(Workbench.java:2382)
	at org.eclipse.ui.internal.Workbench.runUI(Workbench.java:2346)
	at org.eclipse.ui.internal.Workbench.access$4(Workbench.java:2198)
	at org.eclipse.ui.internal.Workbench$5.run(Workbench.java:493)
	at org.eclipse.core.databinding.observable.Realm.runWithDefault(Realm.java:288)
	at org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Workbench.java:488)
	at org.eclipse.ui.PlatformUI.createAndRunWorkbench(PlatformUI.java:149)
	at org.eclipse.ui.internal.ide.application.IDEApplication.start(IDEApplication.java:113)
	at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:193)
	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:110)
	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:79)
	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:382)
	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:179)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
	at java.lang.reflect.Method.invoke(Method.java:597)
	at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:549)
	at org.eclipse.equinox.launcher.Main.basicRun(Main.java:504)
	at org.eclipse.equinox.launcher.Main.run(Main.java:1236)

Subversive is calling unexisting method. Probably also this version is outdated.
So, no way, I cannot manage to have Subversive working with Eclipse.
I will probably try to decompile that class and fix the method call, as it is impossible (for me) to find a working Subversive plugin for Ganymede.

I would use Subclipse, that never gave me so many problems, but the team that I recently joined are using features that are not provided by Subclipse (svn:externals property).
Other guys are using Eclipse Europa, I will probably switch back to Europa or keep the error popping on the screen at every commit. The problem, again, is that switching from Europa to Ganymede I had to do a fresh checkout of every project. Because, without doing that, Eclipse was loosing the meta information of subversion and was disabling the version control in the project...

What a nightmare!

The Secure Storage has been added in Eclipse Ganymede, it is compulsory, and this is why I really hate it. I tried to find out a way to disable it and having eclipse remembering my password as before, but no way. Now you have a password: if you want it or not, and you have to face it.

In firefox, the "master password" can be disabled. Having that possibility is not just luxury, and infact firefox always had this option.

Keeping the life easy to users should be a mission for software writers. Intrusive security is really boring, Windows Vista is an example:

Keep the life easy. Don't put a bodyguard behind the users if they don't require: it will be not welcome.

SVN: '0x00400006: Validate Repository Location' operation finished with error: Selected SVN connector library is not available or cannot be loaded.
If you selected native JavaHL connector, please check if binaries are available or install and select pure Java Subversion connector from the plug-in connectors update site.
If connectors already installed then you can change the selected one at: Window->Preferences->Team->SVN->SVN Client.
Selected SVN connector library is not available or cannot be loaded.
If you selected native JavaHL connector, please check if binaries are available or install and select pure Java Subversion connector from the plug-in connectors update site.
If connectors already installed then you can change the selected one at: Window->Preferences->Team->SVN->SVN Client.

...and in the SVN Client connector I get an empty combo box, so I cannot select anything. I already installed everything related to SVN in all the update repositories, and cannot find any "Java Subversion connector" or "JavaHL connector".
It is surprising that SVN integration doesn't come with Ganymede by default.
I am doing last attempts, but if I can't get it working, I'll probably give it a last chance with Subclipse, and if this also doesn't work, I'll go back to Europa. Very sad.

The network proxy management is completely broken. So you may find problem connecting eclipse to internet (and of course in the super buggy update manager), even if your proxy setting are correct. This can contribute wasting your time...

It's the first time I have a so bad feeling on an eclipse release.

Update: Subclipse 1.4.0 works on Ganymede. I give it a second chance.

I cannot live without the hot code replacement.

This is the result:

Just paste your java source code, or a snippet, select the desired style and submit the form.
You can take the generated html and the css for using on your blog.

The project website will be online soon.

Hope you like it.