From Fedora Project Wiki

(Improving grammar)
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Eclipse =
[http://www.eclipse.org '''Eclipse'''] is an open-source (under the Eclipse Public License, or EPL) powerful [[Integrated development environment|IDE]] with tooling for various languages. It has a GTK+ user interface and is written in Java. As it is written in Java it is cross-platform and capable of running on Linux, macOS and Windows NT. It is maintained and used by a large community of volunteers and companies.


== What is Eclipse? ==
It is shipped in Fedora (>= 4). Plugins are continuously being added to Fedora. The Fedora packaging team aims to take care of Eclipse plugin review requests quickly. Packaging guidelines for Eclipse plugins can be found here: [[Packaging/EclipsePlugins]].
[http://www.eclipse.org Eclipse] is an awesome IDE with tooling for various languages.  It has a GTK+ UI that is much more accesible to regular programmers from a Windows environment than the tools traditionally used by FOSS hackers.


It was originally a (very) large body of code that IBM open-sourced.  There is now a large community of companies and developers using and extending Eclipse.
== Installation ==
It can be installed via merely running:


It has its own Open Source license (the Eclipse Public Library, or EPL).
<pre>
 
sudo dnf install eclipse
It is shipped in Fedora (>= 4).  Plug-ins are continuously being added to Fedora.  We aim to take care of Eclipse plugin review requests quickly.  Packaging guidelines for Eclipse plugins can be found here:  [[Packaging/EclipsePlugins]].
</pre>


== Fedora Eclipse ==
== Fedora Eclipse ==
Fedora Eclipse is a community project encompassing everything Eclipse-related in Fedora. We ship the Eclipse SDK along with many plugins (see below).  We are working on making plugin packaging easier (see [http://www.eclipse.org/linuxtools/projectPages/rpmstubby RPM Stubby] and [http://fedorahosted.org/eclipse-fedorapackager Fedora Packager for Eclipse]).
Fedora Eclipse is a community project encompassing everything Eclipse-related in Fedora. We ship the Eclipse SDK along with many plugins (see below).  We are working on making plugin packaging easier (see [http://www.eclipse.org/linuxtools/projectPages/rpmstubby RPM Stubby] and [http://fedorahosted.org/eclipse-fedorapackager Fedora Packager for Eclipse]).


Would you like to help?
Would you like to help?


Talk to us on IRC or the [https://admin.fedoraproject.org/mailman/listinfo/java-devel/ java-devel mailing list].  Package a plug-in for Fedora!
Talk to us on IRC or the [https://admin.fedoraproject.org/mailman/listinfo/java-devel/ java-devel mailing list].  Package a plugin for Fedora!


== Plug-ins We Ship ==
== Plugins We Ship ==
<!-- Please keep these in alphabetical order -->
<!-- Please keep these in alphabetical order -->


Line 25: Line 24:
[http://www.eclipse.org/birt BIRT]
[http://www.eclipse.org/birt BIRT]


[http://cmakeed.sourceforge.net/ CMakeed] -- Editor for CMake files
[http://cmakeed.sourceforge.net/ CMakeed] &mdash; editor for CMake files


[http://www.eclipse.org/cdt CDT] -- C/C++ Development Tooling
[http://www.eclipse.org/cdt CDT] &mdash; C/C++ Development Tooling.


[http://www.eclipse.org/linuxtools/projectPages/changelog/ ChangeLog]  
[http://www.eclipse.org/linuxtools/projectPages/changelog/ ChangeLog]  


[http://desktop-eclipse.open.collab.net/servlets/ProjectProcess?pageID=MEuUjb&freeformpage=Merge%20Client CollabNet Merge Client for Subclipse] -- Take advantage of the new merge cleverness in Subversion 1.5+
[http://desktop-eclipse.open.collab.net/servlets/ProjectProcess?pageID=MEuUjb&freeformpage=Merge%20Client CollabNet Merge Client for Subclipse] &mdash; take advantage of the new merge cleverness in Subversion 1.5+.


[http://eclipse.org/dltk Dynamic Language Toolkit] -- Complete with TCL and Ruby IDEs
[http://eclipse.org/dltk Dynamic Language Toolkit] &mdash; complete with TCL and Ruby IDEs.


[http://www.eclipse.org/datatools DTP] -- Database Development Tools
[http://www.eclipse.org/datatools DTP] &mdash; database Development Tools.


[http://www.eclemma.org/ EclEmma] -- Code coverage tool to help you enhance your unit tests.
[http://www.eclemma.org/ EclEmma] &mdash; code coverage tool to help you enhance your unit tests.


[http://git.or.cz/gitwiki/EclipsePlugin EGit] -- Support for working with Git repositories
[http://git.or.cz/gitwiki/EclipsePlugin EGit] &mdash; support for working with Git repositories.


[http://www.eclipse.org/emf EMF] -- Eclipse Modeling Framework
[http://www.eclipse.org/emf EMF] &mdash; Eclipse Modeling Framework.


[http://www.epic-ide.org/ EPIC] -- Perl tooling
[http://www.epic-ide.org/ EPIC] &mdash; Perl tooling.


[http://www.eclipse.org/gef GEF] -- Eclipse Graphical Editing Framework (''not'' the [http://www.eclipse.org/vep Visual Editor] )
[http://www.eclipse.org/gef GEF] &mdash; Eclipse Graphical Editing Framework (''not'' the [http://www.eclipse.org/vep Visual Editor]).


[http://eclipse.org/m2e/ M2E] -- Maven integration for Eclipse
[http://eclipse.org/m2e/ M2E] &mdash; Maven integration for Eclipse.


[http://moreunit.sourceforge.net/ MoreUnit] -- Helper for writing more and better unit tests.
[http://moreunit.sourceforge.net/ MoreUnit] &mdash; Helper for writing more and better unit tests.


[http://www.eclipse.org/mylyn Mylyn] -- a task-focused UI for Eclipse with bugzilla and trac integration. See also [[Eclipse/MylynRedHatBugzillaSetupGuide | Eclipse Mylyn Red Hat Bugzilla setup instructions]] and [[Eclipse/MylynPackaging | Eclipse Mylyn packaging guide]] for more Mylyn related information.
[http://www.eclipse.org/mylyn Mylyn] &mdash; a task-focused UI for Eclipse with bugzilla and trac integration. See also [[Eclipse/MylynRedHatBugzillaSetupGuide | Eclipse Mylyn Red Hat Bugzilla setup instructions]] and [[Eclipse/MylynPackaging | Eclipse Mylyn packaging guide]] for more Mylyn related information.


[http://www.eclipse.org/linuxtools/projectPages/oprofile OProfile]
[http://www.eclipse.org/linuxtools/projectPages/oprofile OProfile]


[http://www.eclipse.org/ptp Parallel Tools Platform (PTP)] -- Parallel and Fortran programming support for Eclipse
[http://www.eclipse.org/ptp Parallel Tools Platform (PTP)] &mdash; Parallel and Fortran programming support for Eclipse


[http://www.eclipse.org/linuxtools/projectPages/perf/ Perf]
[http://www.eclipse.org/linuxtools/projectPages/perf/ Perf]


[http://www.phpeclipse.com/ PHPEclipse] -- PHP Development Tooling
[http://www.phpeclipse.com/ PHPEclipse] &mdash; PHP Development Tooling.


[http://pydev.sf.net PyDev] -- Python IDE for Eclipse
[http://pydev.sf.net PyDev] &mdash; Python IDE for Eclipse.


[http://bastian-bergerhoff.com/eclipse/features/web/QuickREx/toc.html QuickREx] -- Regular expression tester
[http://bastian-bergerhoff.com/eclipse/features/web/QuickREx/toc.html QuickREx] &mdash; regular expression tester.


[http://www.eclipse.org/linuxtools/projectPages/specfile/ RPM Specfile Editor]
[http://www.eclipse.org/linuxtools/projectPages/specfile/ RPM Specfile Editor]


[http://www.eclipse.org/linuxtools/projectPages/rpmstubby/ RPM Specfile Generator] -- This plugin makes packaging other plugins really easy.
[http://www.eclipse.org/linuxtools/projectPages/rpmstubby/ RPM Specfile Generator] &mdash; this plugin makes packaging other plugins really easy.


[http://oss.tresys.com/projects/setools Eclipse SETools] -- SELinux policy analysis tools
[http://oss.tresys.com/projects/setools Eclipse SETools] &mdash; SELinux policy analysis tools.


[http://sourceforge.net/projects/shelled Shelled] -- Editor for shell scripts
[http://sourceforge.net/projects/shelled Shelled] &mdash; editor for shell scripts.


[http://oss.tresys.com/projects/slide SLIDE] -- SLIDE is an integrated development environment (IDE) for Security Enhanced Linux (SELinux) developers and integrators
[http://oss.tresys.com/projects/slide SLIDE] &mdash; SLIDE is an integrated development environment (IDE) for Security Enhanced Linux (SELinux) developers and integrators.


[http://subclipse.tigris.org Subclipse] -- Support for working with Subversion repositories
[http://subclipse.tigris.org Subclipse] &mdash; support for working with Subversion repositories.


[http://www.eclipse.org/linuxtools/projectPages/valgrind SystemTap GUI]
[http://www.eclipse.org/linuxtools/projectPages/valgrind SystemTap GUI]


[http://www.eclipse.org/swtbot/ SWTBot] -- UI and functional testing tool for SWT and Eclipse based applications
[http://www.eclipse.org/swtbot/ SWTBot] &mdash; UI and functional testing tool for SWT and Eclipse based applications.


[http://www.eclipse.org/linuxtools/projectPages/valgrind Valgrind]
[http://www.eclipse.org/linuxtools/projectPages/valgrind Valgrind]


== Plug-ins Which Need Packaging Work ==
[http://eclipse.org/webtools/ Webtools] &mdash; Eclipse WTP project (mostly packaged).
* BIRT
 
** all of it needs  WTP
== Plugins Which Need Packaging Work ==
** Tracker bug to get WTP built (filed against BIRT since that's what needs it) [https://bugzilla.redhat.com/486369 486369]
[https://bugzilla.redhat.com/show_bug.cgi?id=970145 Mylyn Reviews (RFE)]


== Contact ==
== Contact ==
Line 126: Line 125:


<pre>
<pre>
rpm -qV eclipse-rcp eclipse-platform
rpm -qV eclipse-platform
</pre>
</pre>
Make sure that there is no output when you run the above command. Next, run:
Make sure that there is no output when you run the above command. Next, run:
Line 179: Line 178:
----
----
[[Category:Documentation]]
[[Category:Documentation]]
[[Category:Integrated development environments]]

Revision as of 00:09, 14 December 2016

Eclipse is an open-source (under the Eclipse Public License, or EPL) powerful IDE with tooling for various languages. It has a GTK+ user interface and is written in Java. As it is written in Java it is cross-platform and capable of running on Linux, macOS and Windows NT. It is maintained and used by a large community of volunteers and companies.

It is shipped in Fedora (>= 4). Plugins are continuously being added to Fedora. The Fedora packaging team aims to take care of Eclipse plugin review requests quickly. Packaging guidelines for Eclipse plugins can be found here: Packaging/EclipsePlugins.

Installation

It can be installed via merely running:

sudo dnf install eclipse

Fedora Eclipse

Fedora Eclipse is a community project encompassing everything Eclipse-related in Fedora. We ship the Eclipse SDK along with many plugins (see below). We are working on making plugin packaging easier (see RPM Stubby and Fedora Packager for Eclipse).

Would you like to help?

Talk to us on IRC or the java-devel mailing list. Package a plugin for Fedora!

Plugins We Ship

Autotools (part of CDT SRPM)

BIRT

CMakeed — editor for CMake files

CDT — C/C++ Development Tooling.

ChangeLog

CollabNet Merge Client for Subclipse — take advantage of the new merge cleverness in Subversion 1.5+.

Dynamic Language Toolkit — complete with TCL and Ruby IDEs.

DTP — database Development Tools.

EclEmma — code coverage tool to help you enhance your unit tests.

EGit — support for working with Git repositories.

EMF — Eclipse Modeling Framework.

EPIC — Perl tooling.

GEF — Eclipse Graphical Editing Framework (not the Visual Editor).

M2E — Maven integration for Eclipse.

MoreUnit — Helper for writing more and better unit tests.

Mylyn — a task-focused UI for Eclipse with bugzilla and trac integration. See also Eclipse Mylyn Red Hat Bugzilla setup instructions and Eclipse Mylyn packaging guide for more Mylyn related information.

OProfile

Parallel Tools Platform (PTP) — Parallel and Fortran programming support for Eclipse

Perf

PHPEclipse — PHP Development Tooling.

PyDev — Python IDE for Eclipse.

QuickREx — regular expression tester.

RPM Specfile Editor

RPM Specfile Generator — this plugin makes packaging other plugins really easy.

Eclipse SETools — SELinux policy analysis tools.

Shelled — editor for shell scripts.

SLIDE — SLIDE is an integrated development environment (IDE) for Security Enhanced Linux (SELinux) developers and integrators.

Subclipse — support for working with Subversion repositories.

SystemTap GUI

SWTBot — UI and functional testing tool for SWT and Eclipse based applications.

Valgrind

Webtools — Eclipse WTP project (mostly packaged).

Plugins Which Need Packaging Work

Mylyn Reviews (RFE)

Contact

Most of the Fedora "free java" people hang out on #fedora-java on Freenode . There are also people on #classpath also on Freenode. Community around the Eclipse Linux Tools project is emerging now and developers are hanging out on #eclipse-linux on Freenode.

Fedora Java Mailing list

Eclipse (upstream)

Planet Eclipse

GNU Classpath Wiki

Planet Classpath

GCJ - GNU Compiler for Java

Testing

Eclipse ships it's tests as a subpackage called eclipse-tests. Install it via yum install eclipse-tests and launch /usr/bin/eclipse-runEclipsePackageTests.

All test results will be saved and available for later analysis. Note: Not all tests finish successfully for now.

Troubleshooting Eclipse in Fedora

The way Eclipse and its plugins are installed in Fedora differs from the way this is done upstream. This can sometimes lead to installation problems in Fedora. We are working on a solution to make installations more robust in future Fedora releases. In the meantime however, this section is meant to help you troubleshoot those problems. The main theme is "I updated eclipse and my plugins no longer show up".

1. The first thing you want to do is to make sure that you have a bundles.info file in your ~/.eclipse directory

find ~/.eclipse -name bundles.info

If you find one then you can move on to step 2. If you don't find a file that means that there is a problem occurring early on during the startup of Eclipse. To start with you need to make sure that you have a standard Eclipse installation. To do so run the following:

rpm -qV eclipse-platform

Make sure that there is no output when you run the above command. Next, run:

rpm -qf /usr/lib*/eclipse/p2/org.eclipse.equinox.p2.engine/profileRegistry/PlatformProfile.profile/*.profile.gz

Make sure that there are no files which are not owned by any RPMs.

If the result of the above commands is not clean that means that you don't have a clean Eclipse installation. It is possible that you may have run eclipse as root at some point. You can clean that up by removing all files which are not owned by any RPMs, and removing and reinstalling the eclipse RPMs.

If both of the above outputs are clean, you will need to file a bug. Collect the following information and file a bug here: https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=eclipse

Create a file ~/.options and add the following flags to it:

org.eclipse.equinox.p2.core/debug=true
org.eclipse.equinox.p2.core/reconciler=true
org.eclipse.equinox.p2.garbagecollector/debug=true

Then run eclipse from a terminal with the following flags:

eclipse -consolelog -debug -clean >& log

Attached this log to the bug you file.

2. If you have found a bundles.info you will need to do is do a diff between your system bundles.info and user bundles.info:

diff `find /usr/lib*/eclipse -name bundles.info` `find ~/.eclipse -name bundles.info`

If there are any bundles present in the system bundles.info and not in the user bundles.info, these bundles are the source of the problem. If the bundles are installed and have the correct versions (the path to the bundles in stated relative to /usr/lib/eclipse or /usr/lib64/eclipse) then that means that things have been upgraded in a way that contradicts the previous installation. Adding those bundles to your user bundles.info will solve the problem. Before doing so backup your ~/.eclipse directory just in case. Here is a script wich will do that:

diff `find /usr/lib*/eclipse/ -name bundles.info` `find ~/.eclipse/ -name bundles.info` | grep "<" | sed s/"< "/""/ >> `find ~/.eclipse/ -name bundles.info`

If the extra bundles are not present or have different versions than what is in the system bundles.info, that means that the bundles.info is faulty and needs to be updated. Please file a bug which includes the diff.

Plans

We ship the Eclipse SDK (eclipse SRPM) version 4.3.0 in Fedora 19. Other Kepler release train projects are also updated to their Helios versions.

The other plugins we ship should work with Eclipse 4.3 without problems. We will of course have to coordinate testing them all.

References