View source for SDK Known Issues

== Installing ==

=== I downloaded and extracted the ZIP file - how do I install Eclipse? ===
You don't need to install Eclipse.  In the extracted folder, simply double-click the eclipse.exe executable file.

== Windows issues ==

=== I am prompted for a password when extracting the ZIP file ===
This is a known issue with the Windows extraction utility. Try using a third-party extraction tool:
* GUI: [http://www.7-zip.org/ 7-zip], [http://www.winzip.com/ WinZIP] or [http://www.win-rar.com/ WinRAR]
* commandline: [http://www.info-zip.org/UnZip.html#Win32 info-zip]

You can also extract Eclipse using the jar utility that comes with the Java development kit (JDK):

  jar xf eclipse-SDK-4.2-win32-x86_64.zip

=== Extracting the ZIP file fails ===
This could be caused by the the Windows built-in extraction utility (as with the password problem above). Try using a third-party extraction tool as described above.

If still get errors such as the "The filename is too long" or similar wording, it is most likely because you are trying to extract Eclipse into a root directory that has a lengthy path. The Eclipse packages have some deeply nested paths in them, and when combined with a long root installation path, the resulting final path for some files can exceed limits set by Windows' file system. To avoid this problem, try extracting the ZIP file to a shorter root location, such as c:\Eclipse.

[https://bugs.eclipse.org/bugs/show_bug.cgi?id=166597 Bug 166597] has a lengthy discussion about this issue.

== Linux issues ==

=== Eclipse using GCJ ===
Most Linux distributions ship with the GNU Compiler for Java ([http://gcc.gnu.org/java/ GCJ]). Although Eclipse is known to run on GCJ, it is not a reference platform for Eclipse, and therefore it is not tested. It is recommended that a [http://www.eclipse.org/downloads/moreinfo/jre.php Oracle, IBM, or OpenJDK JVM] be used instead.  See also the Eclipse platform 4.2 [http://www.eclipse.org/eclipse/development/readme_eclipse_4.2.html#TargetOperatingEnvironments reference platforms] list.

See also '''[[Eclipse.ini]]''' for instructions on how to specify a particular JVM (because on many Linux systems gcj is picked up as the default JVM even when Sun's is installed).

=== General UI problems such as buttons not being clickable or the update system not showing anything in its tree ===
Are you using running on GTK+ 2.17.x/2.18.x? Try declaring the <code>GDK_NATIVE_WINDOWS</code> environment variable and see how that goes.

<pre>
$ export GDK_NATIVE_WINDOWS=true
$ ./eclipse
</pre>

The latest version of GTK+ has altered the way it creates and handles windows on the X windowing system. This has introduced some problems due to the way SWT was managing the Z order of windows. See {{bug|291257}} and {{bug|290395}} for more information. If your menu items don't have any icons, see {{bug|293720}}.

== Crashes and other Major Issues ==
Please see the [[IRC FAQ#Crashers, Freezing, and other Major Issues|IRC FAQ]] for some known suggested solutions to the problems described below.
*Eclipse is constantly crashing for me on Sun's Java 6 VM...
*Eclipse gets past the splash screen but then an empty window appears / Eclipse is crashing on me whenever I initiate a browser component such as hovering over Java methods for javadoc tooltips...
*The JEE build for Eclipse does not run for me but the Eclipse Classic build starts up just fine...
*Why does Eclipse hang for an extended period of time after opening an editor in Linux/gtk+?
*Eclipse is crashing for me when performing Subversion operations on Windows. I am using Subclipse.
*I'm having memory, heap, or permgen problems, what can I do?
*Eclipse is constantly crashing for me on Linux and I have a lot of plug-ins installed.