Cannot change Javadoc Location for Google Maps Api in Eclipse

Question

I am trying in eclipse Indigo to change the JavaDoc location for Google APIs [4.0.3] maps.jar from [android-sdk-path]/add-ons/addon-google_apis-google_inc_-15/docs/reference/ to [android-sdk-path]/add-ons/addon-google_apis-google_inc_-15/docs/maps_apis/, where it is actually located. Klicking "Validating..." finds the JavaDoc.

But when I save an close the dialog, my changes are lost and next time, when I check the JavaDoc location, the original location is shown again.

Does anybody know how the location of the JavaDoc can be changed? Seems to be configured by the Google APIs [4.0.3] library container, but I have no idea how this can be changed.

I see the same behaviour in my Windows 7 and my Linux machine. And this also happens only, when I want to change the Javadoc Location of the maps.jar or effects.jar. Therefore I don't think, it is a Problem with my installation (eclispse platform 3.7.0, android devtools 16.0.1)

score 4 · Accepted Answer · answered Jun 08 '12 at 04:52

I have the same problem on multiple machines. I have no problems changing the JavaDoc path for other JARs, but if I try to change any of the "Google APIs" JAR files, the setting is not persisted. I'm able to set it, validate it, press Ok, go back in and it is reset back to the old setting.

I ended up just creating a folder link that mapped the new "maps_apis" folder to "reference" and now it works. On a Windows computer, you can go to the "add-ons\addon-google_apis-google_inc_-15\docs" folder in a console window and and run...

mklink reference maps_apis

I suppose you could also just copy all the files from the maps_apis folder to a reference folder. Until a better solution comes along, this is good enough for now.

This worked well for me (the other solutions did not) - thanks. — assylias, Jun 22 '12 at 23:48

score 2 · Answer 2 · answered Feb 03 '12 at 10:14

2

I have tried in the way suggested by @amit sharma you can download eclipse indigo again. there might be some issue with your version of eclipse.

answered Feb 03 '12 at 10:14

Aneesh Garg

522
1
6
16

score 1 · Answer 3 · answered Feb 02 '12 at 09:22

1

I am not sure as i am working on Helios but it seems that for Indigo also it will work.

Open the Java Build Path page of a project via Right click on a project → Properties → Java Build Path. On the "Libraries" tab expand the library's node, select the "Javadoc location" attribute and press Edit.Enter the location to the file which contains the Javadoc. Click "OK".

answered Feb 02 '12 at 09:22

amit sharma

210
2
9

I did exactly that, but when I save the changes and reopen the dialog, all changes are lost – Dominik Feb 02 '12 at 19:46
@Dominik Is there a 'references' folder in 'maps_apis' directory ? – Vivek Feb 04 '12 at 13:12
@sam no there isn't one, this is the root folder of the documentation (i.e. has package-list and index.html files in it) – Dominik Feb 04 '12 at 17:55

Vivek · Answer 4 · 2012-02-04T14:33:12.863

1

I had the same problem in Eclipse Indigo but i FIXED it. Use the following steps to solve this problem.

Open Eclipse | Project | Properties | Java Build Path | Select 'Libraries' Tab

Expand 'Android X.X' | then expand android.jar | Select '@ Javadoc location' | click Edit

Choose 'Javadoc URL' option, click Browse and select the path to Javadoc

Click Validate.

Note: The selected javadoc location path must have 'package-list' and 'index.html' file in it. Otherwise you will get following error while validating

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

Therefore, add the correct path and eclipse will validate the path.

If the above solution does not solve the problem, Try this

Close Eclipse

Locate your Eclipse Workspace.

Delete '.metadata' folder from eclipse Workspace path. (Backup before deleting)

Note: Deleting '.metadata' will erase your eclipse settings and preferences and Android ADT plugin will be removed. So you need to reinstall ADT plugin and reconfigure eclipse preferences.

But it should work.

edited Feb 04 '12 at 14:33

answered Feb 04 '12 at 13:08

Vivek

11,938
19
92
127

This is exactly what I did, inculding hitting the "validate" Button, which gave a positive result. My problem is, that the changes get lost after I close the dialog. – Dominik Feb 04 '12 at 13:55
@Dominik is your path validating successfully ? – Vivek Feb 04 '12 at 14:00
I'm not sure, that this is a problem with my eclipse installation, since I see the same behaviour in my Windows 7 and my Linux installation. – Dominik Feb 04 '12 at 17:42
@Dominik Javadoc location is configured by eclipse and not by 'Google APIs [4.0.3] library container', Try to move the original location directory to somewhere else on disk and see what happens. – Vivek Feb 06 '12 at 19:04
the original directory, as it is configured before I try to change it, does not exist. – Dominik Feb 07 '12 at 07:15

score 0 · Answer 5 · edited Jul 26 '20 at 14:30

0

The solution is very simple, you have to create the default path that has eclipse. In my case I had to rename the folder where it was index.html.

edited Jul 26 '20 at 14:30

Dharman

30,962
25
85
135

answered Feb 13 '13 at 05:55

jose gonzalez

1

Cannot change Javadoc Location for Google Maps Api in Eclipse

5 Answers5