Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Linux Tools Project/Eclipse Build"
(→Prerequisites for building with eclipse-build) |
(→How to build Eclipse SDK from checked out eclipse-build trunk) |
||
| Line 33: | Line 33: | ||
* Download SDK sources as above and put them in the eclipse-build directory | * Download SDK sources as above and put them in the eclipse-build directory | ||
* Optional: download the test sources and test scripts as above and put them in the eclipse-build directory. | * Optional: download the test sources and test scripts as above and put them in the eclipse-build directory. | ||
| − | * Run <tt> | + | * Run <tt>ant</tt> |
* Check for successful build in <tt>build/eclipse-$YOUR_BUILD_ID-src/installation</tt> | * Check for successful build in <tt>build/eclipse-$YOUR_BUILD_ID-src/installation</tt> | ||
* Optional: <tt>ant -DbuildArch={x86 OR x86_64 OR ppc} runTests</tt>. Look for test results (a few hours running time) in <tt>testResults-${timestamp}/html/org.eclipse.sdk.tests.html</tt>. | * Optional: <tt>ant -DbuildArch={x86 OR x86_64 OR ppc} runTests</tt>. Look for test results (a few hours running time) in <tt>testResults-${timestamp}/html/org.eclipse.sdk.tests.html</tt>. | ||
Revision as of 05:34, 7 July 2010
{{#eclipseproject:technology.linux-distros}}
Eclipse-build aims to ease the building of the Eclipse SDK for Linux distributions.
Contents
Prerequisites for building with eclipse-build
- A 1.6 JDK installed in a standard place (see build.properties)
- Ensure JAVA_HOME is set (e.g., export JAVA_HOME=/usr/lib/jvm/java)
- Ant version 1.7.1 or newer
- bash, sh, perl, sed, below requirements for particular distro
- icu4j; jsch; java.servlet 2.5; javax.servlet.jsp 2.0; Apache Commons: codec, EL, httpclient, logging; jasper; lucene; hamcrest; jetty; ASM; SAT4J
- At least 3 GB of storage available
- Xvnc (Fedora: tigervnc-server package) if you want the tests to run and not touch your main display (Debian xvfb version in the works)
How To build Eclipse SDK with eclipse-build released tarballs
- Download and extract the latest eclipse-build*.tar.gz (0.5.* work with 3.5.2, R0_4* work with 3.5.1, R0_3* work with 3.5.0)
- Download Eclipse 3.5.2 SDK sources (http://www.eclipse.org/downloads/download.php?file=/technology/linuxtools/eclipse-build/eclipse-R3_5_1-fetched-src.tar.bz2 3.5.1], 3.5.0) in the eclipse-build* directory. NOTE: eclipse-build provides source tarball created from the same tag as the official releases but with additional sources needed for the build.
- Optional: download the test sources and test scripts (3.5.1 test sources and 3.5.1 test scripts, 3.5.0 test sources, 3.5.0 test scripts).
- Run ./build.sh
If the build finishes without error there will be a build/eclipse-$YOUR_BUILD_ID-src/installation directory containing a ready-to-use Eclipse SDK. Eclipse-build is verified to work on x86, x86_64 and ppc architectures. Eclipse-build has been successfully tested on Fedora, Debian, and Ubuntu. Refer to distribution-specific instructions below. We are interested in reports of success on other distributions. Please let us know via linuxtools-dev@eclipse.org.
Optional: ant -DbuildArch={x86 OR x86_64 OR ppc} runTests. Look for test results (a few hours running time) in tests_<timestamp>/results/html/org.eclipse.sdk.tests.html.
How to build Eclipse SDK from checked out eclipse-build trunk
- The following SVN commands can easily be replaced with checking things out in Eclipse (say, with this handy PSF (help on PSFs)). The command-line actions afterwards can be executed from a terminal. It is preferred that patches are generated from within Eclipse. All patches must be submitted via http://bugs.eclipse.org eclipse.org bugzila
- svn co http://dev.eclipse.org/svnroot/technology/org.eclipse.linuxtools/eclipse-build/trunk/eclipse-build
- svn co http://dev.eclipse.org/svnroot/technology/org.eclipse.linuxtools/eclipse-build/trunk/eclipse-build-config
- svn co http://dev.eclipse.org/svnroot/technology/org.eclipse.linuxtools/eclipse-build/trunk/eclipse-build-feature
- cd eclipse-build
- ln -s ../eclipse-build-config
- ln -s ../eclipse-build-feature
- Download SDK sources as above and put them in the eclipse-build directory
- Optional: download the test sources and test scripts as above and put them in the eclipse-build directory.
- Run ant
- Check for successful build in build/eclipse-$YOUR_BUILD_ID-src/installation
- Optional: ant -DbuildArch={x86 OR x86_64 OR ppc} runTests. Look for test results (a few hours running time) in testResults-${timestamp}/html/org.eclipse.sdk.tests.html.
Submitting patches
- Check out from SVN (PSF (help on PSFs), location)
- It is preferred that patches are generated from within Eclipse. All patches must be submitted via http://bugs.eclipse.org eclipse.org bugzila
Debian/Ubuntu Build Requirements
On Ubuntu 9.10 "Karmic Koala" (and later) you can simply run "sudo apt-get build-dep eclipse && sudo aptitude install build-essential" to install those packages.
The list of build dependencies (excluding build-essential) can be found here (see Build-Depends).
Fedora Build Requirements
On Fedora, just run yum-builddep eclipse to get the build dependencies (including the dependencies to which the Fedora package is symlinked). You must also ensure you have the following installed (the latter to run the tests): patch tigervnc-server.
To-do list
- See eclipse-build open bugs
- Add an item
- In Eclipse bugzilla, watch linux.packagingtools-inbox@eclipse.org if you want to be notified of new bugs
Planned items
- Provision every feature separately so we can move them in dropins
- Add ability to build only given feature e.g org.eclipse.swt (Maybe)
Testing
See tests for how to build and run the SDK tests and to report results and check if others are working on common failures.