How to get the Android API documentation in Eclipse-ThrowExceptions

Exception or error:

I’d like to be able to integrate Android api docs into Eclipse so that, for example, if hover over an Activity class you get the appropriate Javadoc in a popup.

So to add Javadoc to Android you open up any Android project in Eclipse. Location the “Android x.x” library. In this right click on the android.jar file and select Properties. Choose the Javadoc location entry.

In the JavadocURL section I entered http://developer.android.com/reference/packages.html and clicked Validate but it gives the usual error of

Location might be invalid. Files ‘package-list’ and ‘index.html’ that are typically available at the root of the documentation created by the Javadoc tool have not been found

I’ve tried lots of variations of that URL but to no avail.

I also don’t want to have to resort to downloading the source for Android.

How to solve:

In Eclipse right click the Android Library, and hit Configure Build Path. Then Select Android.jar and click Javadoc location. Click Edit then make sure Javadoc URL is selected. In the box, type in: “http://developer.android.com/reference/”.

###

BTW one possible (but unsatisfactory) solution is to get the Honeycomb API docs to access them offline.
In the AVD Manager download the “Documentation for Android ‘Honeycomb’ Preview SDK” package. This installs into your …/android-sdk-linux_x86/ directory under docs. You can then link the android.jar file to it as detailed above.

I wouldn’t mind being able to download the docs for the particular API version I use but I can’t find it anywhere. I’d still prefer to access the online version.

Leave a Reply

Your email address will not be published. Required fields are marked *