Also plugins for working with SWT, OSGi, p2, and Eclipse RCP
It is possible to have many installations of the Eclipse IDE share a common set of installed artifacts, called a "bundlepool". This means it is fast and efficient to get a purpose-built IDE for every project, preconfigured with all the plugins and settings appropriate for the project at hand.
When you run gradlew ide
, it builds and downloads an IDE into build/oomphIde
with just the features you need. Takes ~15 seconds and 1MB of disk space once all the common artifacts have been cached at ~/.goomph
.
apply plugin: 'com.diffplug.oomph.ide'
oomphIde {
repoEclipseLatest()
jdt {}
eclipseIni {
vmargs('-Xmx2g') // IDE can have up to 2 gigs of RAM
}
style {
classicTheme() // oldschool cool
niceText() // with nice fonts and visible whitespace
}
}
See the plugin's javadoc for a quickstart, and HOW_TO_AUTOMATE_IDE.md for examples and more in-depth details.
It turns out that the tooling required to implement "IDE-as-build-artifact" is the same tooling required to manipulate eclipse project files, and also to build Eclipse plugins and RCP applications in the first place. That is Goomph's other side. For an example project, see the Gradle and Eclipse RCP talk.
Real world Eclipse software built with Goomph:
Below is an index of Goomph's capabilities, along with links to the javadoc where you can find usage examples.
apt
fixes eclipse project to work with Gradle annotation processing.mavencentral
makes it easy to add dependency jars from an eclipse release.buildproperties
usesbuild.properties
to control a gradle build, and fixes eclipse project classpath to include binary assets specified inbuild.properties
.excludebuildfolder
excludes the gradlebuild
folder from Eclipse's resource indexing.projectdeps
fixes an intermittent problem where dependencies on other projects within the workspace aren't always resolved correctly within Eclipse.resourcefilters
adds resource filters to the eclipse project.
bndmanifest
generates a manifest using purely bnd, and outputs it for IDE consumption.equinoxlaunch
can configure and run equinox applications as part of the build, such as a code generator.OsgiExecable
makes it easy to run a chunk of code within an OSGi container, and get the result from outside the container.
asmaven
downloads dependencies from a p2 repository and makes them available in a local maven repository.P2Model
models a set of p2 repositories and IUs, and provides convenience methods for running p2-director or the p2.mirror ant task against these.P2AntRunner
runs eclipse ant tasks.CategoryPublisher
models the CategoryPublisher eclipse application.FeaturesAndBundlesPublisher
models the FeaturesAndBundlesPublisher eclipse application.Repo2Runnable
models the Repo2Runnable eclipse application.
PdeBuildTask
runs PDE build to build an RCP product.PdeAntBuildTask
runs PDE on an ant file.
CmdLineTask
runs a series of shell commands, possibly copying or moving files in the meantime.JavaExecable
makes it easy to run a chunk of code in a separate JVM, and get the result back in this one.JavaExecWinFriendly
overcomes limitations in Windows' commandline length and long classpaths.
- Used to power the infrastructure above.
com.diffplug.configuration-cache-for-platform-specific-build
allows you to useOS.getNative()
andOS.getRunning()
in your gradle build without breaking the configuration cache.
- Thanks to Jérémie Bresson for multiple fixes to the
eclipseMavenCentral
plugin. - Thanks to Thomas Broyer for the excellent
net.ltgt.apt-eclipse
plugin.- It is no longer maintained at its original home, so we will continue to maintain it here at
com.diffplug.eclipse.apt
.
- It is no longer maintained at its original home, so we will continue to maintain it here at
- Thanks to ralfgrossklaus for fixes to Gradle 6.7, CmdLine hanging, and opening dialogs on buildservers.
- Thanks to Kelvin Glaß for adding the
CategoryPublisher
application (#126). - Thanks to hacki11 for slicingOptions and append in p2asmaven, as well as every improvement in the
3.10.0
release. - Andrey Hihlovskiy's excellent Wuff and Unpuzzle libraries have been a huge boon to everyone trying to get Gradle and Eclipse to collaborate.
- Thanks to Peter Kriens for the excellent bnd.
- Thanks to JRuyi and Agemo Cui for osgibnd-gradle-plugin, which inspired
BndManifestPlugin
. - Thanks to Scott Resnik for installed jre functionality, line number and whitespace configuration, and jdt config enhancements.
- Thanks to Stefan Oehme for his feedback on Goomph's design.
- Thanks to Neil Fraser of Google for diff-match-patch which is very helpful for testing.
- Thanks to Thipor Kong for his handy windows cmdline length workaround for the classpath.
- Formatted by spotless.
- Bugs found by findbugs.
- Built by gradle.
- Tested by junit.
- Maintained by DiffPlug.