-
Notifications
You must be signed in to change notification settings - Fork 77
A Brief Overview of Building at Eclipse
This page is about building Eclipse- and RCP-based products (including Eclipse itself). This document is focused on using Tycho Build directly by Eclipse projects. Tycho is part of a Common Build Infrastructure.
Eclipse projects can use the Eclipse Foundation's build server
(build.eclipse.org) to run automated builds. If you're a committer with
a shell account, you should already have access to the server. If not,
your project lead should send a note to the Eclipse
Webmaster. Once you have access to the
build.eclipse.org server, you can move your build scripts to the
'shared' directory (i.e. /shared/[top-level project]/[project]/[component]). For example, the build scripts for the
aforementioned IDE4EDU are run from the
/shared/technology/soc/ide4edu/releng directory. If this directory
doesn't exist for your project, please ask the webmaster to create it
for you.
For more information, please see [Hudson](https://wiki.eclipse.org/Jenkins.
Tycho is The Way to headlessly build Eclipse- and RCP-based products.
See The Eclipse Platform Build with Tycho and Maven.
PDE Build was The Way to headlessly build Eclipse- and RCP-based products. The online documentation provides a good foundation of knowledge, but does fall short in on some specifics, including the use of Pack200 and JAR signing using the Eclipse Foundation's certificate. This document addresses these issues. PDE can still be used to build your RCP applications.
The following guides are available:
- PDE Build from Markus Barchfeld's Build and Test Automation for plug-ins and features. It's getting a bit old (having been written for eclipse-3.0).
-
Eclipse Headless build with PDE
Build
- Tutorial by Lars Vogel based on Eclipse 3.4
Ant is heavily used in the PDE build infrastructure that ships with the Plug-in Development Environment. Ant is used to run the build, with adequate plug-points where in you can perform custom tasks such as instrumentation of code.
To get comfortable with ant:-
http://ant.apache.org/manual - If you are new to ant
Eclipse provides a very usable interface for writing ant files(yes, with auto-complete and the stuff) as well as run the ant files from within the IDE. But, for headless(without UI, from command line) builds, you'll need to use the antRunner application provided by eclipse. For more help, peek into the help documentation of eclipse that you are using.
http://www.pluginbuilder.org - Something to make your life even easier
Some old articles were written related to this mentioned in and .
Plugins (including features and fragments) must specify their own versions as well as the versions of their dependencies appropriately.
See the eclipse team's plugin-versioning guidelines. You can also ask Pascal Rapicault or John Arthorne for their "Plug-in versioning" presentation.
Pascal Rapicault has created an application (org.eclipse.core.runtime.versionchecker.dependencyChecker) to "specify the ranges on all [your] required plug-ins."
Eclipse RCP applications can be cross-built for several platforms using any platform on which eclipse runs.
Previously, before the Mars release, you could install the RCP delta pack in your Target Platform (which was downloadable as a zip file, from the download page).
In the Mars release, that delta pack zip file is no longer available on the download page. The reason for removing it was that p2 can be used instead, so it saves complications in the Platform build, and does not take up redundant space making the same stuff available in multiple ways.
The preferred way of getting the platform specific artifacts is to just add them to the target platform. There is no need to look-up and download the "DeltaPack" if you follow these instructions.
This is works not only with the Mars release, but also previous releases, as well.
- Open Window/Preferences.
- Find PDE/Target Platform
- Select your (active) target platform
- Click Edit
- Click Add
- Select "Software Site"
- Click Next
- In "Work With" type: http://download.eclipse.org/eclipse/updates/4.3 (replace 4.3 with your current version)
- Check "Eclipse RCP Target Components"
- Check "Equinox Target Components"
- Uncheck "Include required software"
- Check "Include all environments"
- Press Finish
- Press Finish
- Press OK
Open your product file and select the "Export" option. You will see that the "Export for multiple platforms" checkbox is available.
The key to doing multi-platform builds is to have the equinox executable
feature in your target (but, none of your features should "include" it
directly). The "p2 name" for this feature (IU) is
org.eclipse.equinox.executable.feature.group and it's human readable
name is Eclipse Platform Launcher Executables. It may be useful to
also have the rcp configuration feature in your target. Its p2 IU is
named org.eclipse.rcp.configuration.feature.group and its human
readable name is Eclipse Product Configuration. They are both
available in the Eclipse Project's software repository, and the
executable feature is in the ../releases/mars repository, but the rcp
config feature is not (). It is the executable feature that enables the
PDE wizard to enable "Export for Multiple Platforms".
Of course, in addition to those key features, you need all the other prerequisite features, bundles, and platform specific fragments in your target. That's why, in the steps above, large "categories" of prerequisites are given. As your build gets more refined, it is typically better to select only exactly what you need, but this takes some knowledge and experience to know that those are.
The community of previous delta pack users are welcome to add to this wiki any tips and tricks they learn ... and provide concrete working examples. I have opened to track making improvements to these instructions in the future.
It is easy to make your own. There are a number of blogs, stackoverflow answers, and similar sources of invormation devoted to the topic. There is even an example in Eclipse Help about p2 tasks that shows how to make one.
Plus, there is an ant script in our Git repository that will create one simply by executing the script in your IDE. (That one is very similar to the one we used to create as part of our download page, in the past). You'll need to make your own copy of that file, and edit it, putting in your own values for some of the variables (or, overriding them via the command line. Of course, you only need to make it one, to use as many product builds for which it is suitable.
One advantage of creating your own delta pack, is that there are a number of ways to create one, things to include, or not, so you can pretty much pick what you need, instead of being locked in to the exact one that was previously provided on the download page.
Note: The download is no longer available as of 4.5.0. Older releases still provide that download.
The DeltaPack is a distribution from Eclipse that contains platform specific files for all supported platforms and widget sets. It contains:
-
Various plugins to handle connection to the native OS widgets. -
Files to launch Eclipse from the command line -
Hooks into secure storage, native networking and native Eclipse filesystem hooks
In total there are some 70 plugins to support the complete range of supported operating systems (around a dozen).
The DeltaPack is used to get platform specific artifacts so that you can export your RCP product for multiple platforms.
You need it if you want to export your RCP application to multiple targets (a combination of OS/ARCH/WIDGETSET: e.g. linux/ppc64/gtk ). This is typically done from the product configuration file.
You can get it from: http://download.eclipse.org/eclipse/downloads/
Click on any of the builds and look for DeltaPack. Please note that [there are discussions on removing the DeltaPack](https://bugs.eclipse.org/bugs/show_bug.cgi?id=419246) and getting it the preferred way.
- Download the DeltaPack as described above
- Unzip it to a location .e.g. "C:\eclipse-4.4M7-delta-pack"
- Open Window/Preferences.
- Select PDE/Target Platform
- Select your (active) target platform
- Click Edit
- Click Add
- Select "Directory"
- Click Next
- In "Location" type: "C:\eclipse-4.4M7-delta-pack\eclipse"
- Press Next
- Press Finish
- Press Finish
- Press OK
Open your product file and select the "Export" option. You will see that the "Export for multiple platforms" checkbox is available.