From Fedora Project Wiki

(Add section about JIRA plugin for Mylyn)
(→‎Troubleshooting: read only eclipse.ini)
 
(58 intermediate revisions by 12 users not shown)
Line 1: Line 1:
= Eclipse =
[https://www.eclipse.org/ide '''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. It is maintained and used by a large community of volunteers and companies.


== What is Eclipse? ==
== Installation ==
[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.
=== Eclipse ===
[https://www.eclipse.org/downloads/packages/ Eclipse Packages] offers their own installers and tarballs for different editions.


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.
=== Flathub ===
The Java IDE can also be installed as a Flatpak package from [https://flathub.org/apps/org.eclipse.Java Flathub]:


It has its own Open Source license (the Eclipse Public Library, or EPL).
<pre>
flatpak install org.eclipse.Java
</pre>


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]].
You may also install it using Gnome Software or KDE Discover; look for ''Eclipse IDE for Java Developers''.


== Fedora Eclipse ==
== Troubleshooting ==
See [https://github.com/flathub/org.eclipse.Java Eclipse on Flathub] for bug reports and pull requests on the Flatpak manifest.


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].
=== Read Only Eclipse.ini ===
You can reference a custom <code>eclipse.ini</code> with
<pre>flatpak run org.eclipse.Java --launcher.ini /home/user/custom/eclipse.ini</pre>


Would you like to help?
It is also possible to start Eclipse with command line parameters:
<pre>flatpak run org.eclipse.Java -vmargs -Xmx4g -Dmy.sysprop=some_value</pre>


Talk to us on IRC or the [https://www.redhat.com/archives/fedora-devel-java-list/ fedora-devel-java mailing list].  Package a plug-in for Fedora!
=== No Splashscreen Image ===
 
As the splash is stored as legacy BMP try
== Plug-ins We Ship ==
<pre>yum install gdk-pixbuf2-modules-extra</pre>
<!-- Please keep these in alphabetical order -->
to fix it when using an Eclipse supplied installer.
 
[http://www.eclipse.org/linuxtools/projectPages/autotools Autotools] (part of CDT SRPM)
 
[http://cmakeed.sourceforge.net/ CMakeed] -- Editor for CMake files
 
[http://www.eclipse.org/cdt CDT]
 
[http://www.eclipse.org/linuxtools/projectPages/changelog/ ChangeLog]
 
[http://www.eclemma.org/ EclEmma] -- Code coverage tool to help you enhance your unit tests.
 
[http://git.or.cz/gitwiki/EclipsePlugin EGit] -- git support
 
[http://www.eclipse.org/emf EMF]  -- Eclipse Modeling Framework
 
[http://www.epic-ide.org/ EPIC] -- Perl tooling
 
[http://www.eclipse.org/gef GEF]  -- Eclipse Graphical Editing Framework (''not'' the [http://www.eclipse.org/vep Visual Editor] )
 
[http://moreunit.sourceforge.net/ MoreUnit] -- 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.
 
[http://www.eclipse.org/photran Photran] -- Fortran support for Eclipse
 
[http://www.phpeclipse.com/ PHPEclipse] -- PHP tooling
 
[http://pydev.sf.net PyDev]
 
[http://bastian-bergerhoff.com/eclipse/features/web/QuickREx/toc.html QuickREx] -- Regular expression tester
 
[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://oss.tresys.com/projects/setools Eclipse SETools] -- SELinux policy analysis tools
 
[http://sourceforge.net/projects/shelled Shelled] -- 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://subclipse.tigris.org Subclipse]  -- support for working with Subversion repositories
 
 
Coming soon in rawhide:
 
[http://www.eclipse.org/birt BIRT] [https://bugzilla.redhat.com/show_bug.cgi?id=485424 review request]
 
[http://www.eclipse.org/datatools DTP] <s>[https://bugzilla.redhat.com/show_bug.cgi?id=484676 review request]</s>
 
[http://www.eclipse.org/linuxtools/projectPages/oprofile OProfile]
 
[http://stapgui.sourceforge.net/ SystemTap GUI] [https://bugzilla.redhat.com/show_bug.cgi?id=483205 review request]
 
[http://www.eclipse.org/linuxtools/projectPages/valgrind Valgrind]
 
== Plug-ins We'd Like To Ship ==
* WTP
** needs some non-Eclipse deps, all of which may not be in Fedora
** tracker bug:  [https://bugzilla.redhat.com/486369 486369]
** old SRPM and .spec uploaded here (most likely won't build, needs work):
*** http://overholt.fedorapeople.org/eclipse-webtools.spec
*** http://overholt.fedorapeople.org/eclipse-webtools-1.5.0-2.fc10.src.rpm
* <s>Valgrind</s>
** <s>needs BIRT</s>
** <s>review request:  [https://bugzilla.redhat.com/485941 485941]</s>
** see [[Features/EclipseProfilingTools]]
* <s>OProfile</s>
** see [[Features/EclipseProfilingTools]]
* [http://eclipse.org/vep VE]
** requested [https://bugzilla.redhat.com/show_bug.cgi?id=473779 here]
** it seems kind of dead upstream
* [http://wiki.eclipse.org/index.php/Mylyn_Extensions#Atlassian_JIRA_.28Mylyn_Project.29 Mylyn's JIRA plugin]
** [https://bugzilla.redhat.com/show_bug.cgi?id=251747 bug to ship JIRA plugin]
** needs axis 1.4 with OSGi metadata ([https://bugzilla.redhat.com/show_bug.cgi?id=497126 bug #497126])
*** needs org.apache.commons.discovery_0.2.0 (hopefully 0.4 we have is acceptable) ([https://bugzilla.redhat.com/show_bug.cgi?id=497128 bug to add OSGi metadata])
*** needs javax.wsdl_1.5.1 ([https://bugzilla.redhat.com/show_bug.cgi?id=497130 bug to add OSGi metadata])
*** needs javax.xml.soap_1.2.0 ([https://bugzilla.redhat.com/show_bug.cgi?id=497139 bug to add OSGi metadata])
*** javax.xml.rpc_1.1.0 ([https://bugzilla.redhat.com/show_bug.cgi?id=497141 bug to add OSGi metadata])
 
== Plug-ins Which Need Packaging Work ==
* BIRT
** all of it needs <s>DTP and</s> WTP
** Tracker bug to get WTP built (filed against BIRT since that's what needs it) [https://bugzilla.redhat.com/486369 486369]
* DTP
** Tracker bug to get all of DTP built:  [https://bugzilla.redhat.com/show_bug.cgi?id=485460 485460]
** Package of [http://sourceforge.net/projects/lpg/ lpgjavaruntime] [https://bugzilla.redhat.com/486365 486365]
** <s>Fix build with lucene 2 and submit it upstream [https://bugzilla.redhat.com/486366 486366]</s>
** <s>Fix build with java 6 - Fixed in latest build in rawhide.
** <s>review request:  https://bugzilla.redhat.com/show_bug.cgi?id=484676</s> package built with just a few features


== Contact ==
== Contact ==
Most of the Fedora "free java" people hang out on [ircs://irc.libera.chat#fedora-java #fedora-java] on [http://libera.chat Libera]. The [https://www.eclipse.org/linuxtools/ Eclipse Linux Tools] upstream project is also responsible for packaging across distributions.


<!-- [http://sourceware.org/eclipse Fedora Eclipse Website] -->
* [https://lists.fedoraproject.org/archives/list/java-devel@lists.fedoraproject.org/ Fedora Java Mailing list]  
 
* [https://www.eclipse.org Eclipse foundation] (upstream)
Most of the Fedora "free java" people hang out on #fedora-java on [http://freenode.net Freenode] .  There are also people on #classpath also on Freenode. Community around the [http://www.eclipse.org/linuxtools/ Eclipse Linux Tools] project is emerging now and developers are hanging out on #eclipse-linux on Freenode.
* [https://chat.eclipse.org/ Eclipse Foundation Chat Community] (Matrix based)
 
* [https://planet.eclipse.org Planet Eclipse] (Blogs)
[http://www.redhat.com/mailman/listinfo/fedora-devel-java-list/ Fedora Java Mailing list]  
 
[http://www.eclipse.org Eclipse (upstream)]
 
[http://planet.eclipse.org Planet Eclipse]
 
[http://developer.classpath.org/mediation/ GNU Classpath Wiki]
 
[http://planet.classpath.org Planet Classpath]
 
[http://gcc.gnu.org/java GCJ - GNU Compiler for Java]
 
== Testing ==
 
It has [https://www.redhat.com/archives/fedora-devel-java-list/2005-July/msg00088.html automated tests] .  You can also run [https://www.redhat.com/archives/fedora-devel-java-list/2005-April/msg00010.html individual plug-in tests] .
 
Running the Eclipse SDK automated tests against the installed RPMs can be done using the following steps:
 
# <tt>$ svn co http://dev.eclipse.org/svnroot/technology/org.eclipse.linuxtools/sdktests/3.4.1/Fedora eclipse-sdk-tests</tt>
# <tt>$ cd eclipse-sdk-tests</tt>
# <tt>$ ./build.sh</tt>
# (... wait for build)
# <tt># rpm -Uvh RPMS/{x86_64,i386,etc.}/eclipse-tests-3.4*.rpm</tt>
# <tt>$ cd <somewhere you can write></tt>
# <tt>$ /usr/lib (or lib64) /eclipse/dropins/eclipse/runtests</tt>
# (... wait for tests to run)</tt>
# <tt>$ ls /tmp/eclipseSDKtests/results/html</tt>
# View results in browser:  file:///tmp/eclipseSDKtests/results/html
 
We appreciate any and all reports of success or failure with the SDK tests.  The fedora-devel-java-list mailing list is a fine place to send them.
 
== Plans ==
We plan to ship the Eclipse SDK (<tt>eclipse</tt> SRPM) version [http://www.eclipse.org/eclipse/development/freeze_plan_3_4_2.php 3.4.2] in Fedora 11.  A Fedora 10 update will also follow.  Other [http://www.eclipse.org/ganymede/ Ganymede] release train projects should be updated to their [http://wiki.eclipse.org/index.php/Ganymede_Simultaneous_Release#Coordinated_Service_Releases Ganymede "Service Release 2"] releases when they are available.  We are using the following tracker bug for updating to 3.4.2:
 
[https://bugzilla.redhat.com/show_bug.cgi?id=486350 https://bugzilla.redhat.com/486350]
 
According to [[Releases/11/Schedule]], Fedora 11 is currently scheduled to be released on 2009-05-26.  This is before the schedule release of Eclipse 3.5 which will be some time after 2009-06-12, according to [http://www.eclipse.org/projects/project-plan.php?projectid=eclipse#release_milestones http://www.eclipse.org/projects/project-plan.php?projectid=eclipse#release_milestones].  We would like to avoid having 5 months of a gap between the release of Eclipse 3.5 and it being available in a Fedora release.  As such, we plan on doing an upgrade to 3.5 some time in the Fedora 11 life cycle.  See this tracker bug for getting Eclipse 3.5 ready:
 
There are also the following tracker bugs for various packages we ship and for upgrading them to their [http://wiki.eclipse.org/Galileo Galileo] version:
 
* [https://bugzilla.redhat.com/show_bug.cgi?id=485488 Autotools] (included under CDT umbrella)
* [https://bugzilla.redhat.com/show_bug.cgi?id=486356 BIRT]
* [https://bugzilla.redhat.com/show_bug.cgi?id=485488 CDT]
* [https://bugzilla.redhat.com/show_bug.cgi?id=485492 DTP]
* [https://bugzilla.redhat.com/show_bug.cgi?id=485490 EMF]
* [https://bugzilla.redhat.com/show_bug.cgi?id=485493 GEF]
* [https://bugzilla.redhat.com/show_bug.cgi?id=485494 Mylyn]
 
The other plugins we ship '''should''' work with Eclipse 3.5 without problems.  We will of course have to coordinate testing them all.
 
In order to coordinate this effort, we will be requesting a koji tag (and repo?) to use for our builds and so that others can easily consume this work and report errors.
 
=== Fedora Eclipse Branding ===
 
This is of interest to maintainers.  We have a branding plugin to ensure people file bugs at Red Hat bugzilla first and not at bugs.eclipse.org.  Of course, we aim to have as few divergences as possible from upstream but it's easy enough to ferry bugs to upstream as maintainers.  The branding plugin does things like setting the application name ("Fedora Eclipse" vs. "Eclipse SDK" or "Eclipse Platform"), setting a custom splash screen, etc.
 
==== Updating the branding for a new version ====
 
The splash screen itself was originally done by Diana Fong and given to us as a PSD file.  It is kept with the rest of the branding plugin in CVS:
 
<tt>:pserver:anonymous@sources.redhat.com:/cvs/eclipse</tt>
 
<tt>branding/org.fedoraproject.ide.platform</tt>
 
People wishing to commit will have to have a Sourceware account.  We should probably move this to Fedora Hosted.  In the meantime, use this form to request an account (project:  eclipse, sponsor:  Andrew Overholt):
 
http://sourceware.org/cgi-bin/pdw/ps_form.cgi
 
When updating the branding to a new version, you will need to:
 
* update the product file <tt>fedoraeclipse.product</tt> to include the build ID matching upstream's release build (ex. <tt>http://download.eclipse.org/eclipse/downloads/drops/R-3.4.2-200902111700</tt> gives a build ID of 20090211-1700)
* be sure to hit the synchronize link on the "Overview" page of the product editor to sync up the various generated files
* make a new <tt>splash.bmp</tt> (yes, it is an actual BMP):
** open the <tt>.psd</tt> file in the Gimp
** adjust the visible layers of the numbering in the Gimp to have the correct version shown
*** for versions that are not present in the PSD, you will need to use the Gimp to draw a number that looks very close to the font originally used
** export the visible layers you want to <tt>splash.bmp</tt>; do '''not''' include the Fedora logo layer in the resulting <tt>splash.bmp</tt>
** refresh the <tt>splash.bmp</tt> file in your workspace and open it to ensure it is what you want
* commit your changes.  Comparing two previous tags (ex. <tt>fedoraeclipse-3_4_1</tt> vs. <tt>fedoraeclipse-3_4_2</tt>) is a helpful indicator to guarantee you've made all of the necessary changes.
** do '''not''' include the PSD file in build.properties; it should not be shipped in the SRPM/RPM
* branch and tag for the new version; follow previous tags and branch names to be consistent
* update <tt>eclipse.spec</tt> to reflect the new locations and generate a new <tt>org.fedoraproject.ide.platform-%{version}.zip</tt>
 
== References ==
 
* [http://www.redhat.com/magazine/018apr06/features/eclipse_foox/ Introduction to Eclipse on Fedora]
* [http://www.redhat.com/magazine/018apr06/features/eclipse_tromey/ Confessions of an Eclipse convert]
* [http://www.gotmono.com/docs/ide/eclipse.html Eclipse for developing Mono applications]


----
----
[[Category:Documentation]]
[[Category:Documentation]]
[[Category:Integrated development environments]]

Latest revision as of 08:49, 9 January 2025

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. It is maintained and used by a large community of volunteers and companies.

Installation

Eclipse

Eclipse Packages offers their own installers and tarballs for different editions.

Flathub

The Java IDE can also be installed as a Flatpak package from Flathub: 

flatpak install org.eclipse.Java

You may also install it using Gnome Software or KDE Discover; look for Eclipse IDE for Java Developers.

Troubleshooting

See Eclipse on Flathub for bug reports and pull requests on the Flatpak manifest.

Read Only Eclipse.ini

You can reference a custom eclipse.ini with 

flatpak run org.eclipse.Java --launcher.ini /home/user/custom/eclipse.ini

It is also possible to start Eclipse with command line parameters: 

flatpak run org.eclipse.Java -vmargs -Xmx4g -Dmy.sysprop=some_value

No Splashscreen Image

As the splash is stored as legacy BMP try 

yum install gdk-pixbuf2-modules-extra

to fix it when using an Eclipse supplied installer.

Contact

Most of the Fedora "free java" people hang out on #fedora-java on Libera. The Eclipse Linux Tools upstream project is also responsible for packaging across distributions.

Retrieved from "https://fedoraproject.org/w/index.php?title=Eclipse&oldid=728223"