Jump to: navigation, search

Difference between revisions of "SDK Known Issues"

(Link to the IRC FAQ to direct users about major problems such as crashers.)
(I am prompted for a password when extracting the ZIP file)
 
(8 intermediate revisions by 4 users not shown)
Line 10: Line 10:
 
* GUI: [http://www.7-zip.org/ 7-zip], [http://www.winzip.com/ WinZIP] or [http://www.win-rar.com/ WinRAR]
 
* 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]
 
* 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 ===
 
=== 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.
 
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, for example c:\JavaDevelopment\Eclipse\3.4. 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.
+
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.
 
[https://bugs.eclipse.org/bugs/show_bug.cgi?id=166597 Bug 166597] has a lengthy discussion about this issue.
Line 21: Line 25:
  
 
=== Eclipse using GCJ ===
 
=== 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 Sun, IBM, or BEA JVM] be used instead.  See also the Eclipse platform 3.3 [http://www.eclipse.org/eclipse/development/readme_eclipse_3.3.html#TargetOperatingEnvironments reference platforms] list.
+
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).
 
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).
  
=== Eclipse on Gentoo Linux ===
+
=== General UI problems such as buttons not being clickable or the update system not showing anything in its tree ===
If you are running Gentoo Linux, you may see the following error message when you start Eclipse:
+
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.
  
* run-java-tool is not available for sun-jdk-1.6 on i686
+
<pre>
* IMPORTANT: some Java tools are not available on some VMs on some architectures
+
$ export GDK_NATIVE_WINDOWS=true
 +
$ ./eclipse
 +
</pre>
  
This is a known bug, please see [http://www.eclipse.org/eclipse/development/readme_eclipse_3.3.1.1.html#I-Platform-Core here] and {{bug|176021}}.
+
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}}.
  
== Crashers and other Major Issues ==
+
== Crashes and other Major Issues ==
Please see the [[IRC FAQ#Crashers, Freezing, and other Major Issues|IRC FAQ]] for some known problems.
+
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.

Latest revision as of 10:18, 4 July 2012

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:

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.

Bug 166597 has a lengthy discussion about this issue.

Linux issues

Eclipse using GCJ

Most Linux distributions ship with the GNU Compiler for 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 Oracle, IBM, or OpenJDK JVM be used instead. See also the Eclipse platform 4.2 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 GDK_NATIVE_WINDOWS environment variable and see how that goes.

$ export GDK_NATIVE_WINDOWS=true
$ ./eclipse

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 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.