Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Starting Eclipse Commandline With Equinox Launcher
Launching Eclipse with the new Equinox jar is as easy as A, B, C.
Note that the initial releases of Eclipse 3.3 on Windows have a configuration bug preventing the following approach from working. See this mail thread for details.
Ant Script
<!-- set path to eclipse folder. If local folder, use '.'; otherwise, use c:\path\to\eclipse or /path/to/eclipse/ --> <property name="eclipse.home" value="."/> <nowiki><!-- get path to equinox jar inside ${eclipse.home} folder (copy/rename actual jar) --></nowiki> <copy tofile="''${eclipse.home}''/eclipse/plugins/org.eclipse.equinox.launcher.jar"> <fileset dir="''${eclipse.home}''/eclipse/plugins" includes="**/org.eclipse.equinox.launcher_*.jar"/> </copy> <nowiki><!-- start Eclipse w/ java --></nowiki> <java classpath="''${eclipse.home}''/eclipse/plugins/org.eclipse.equinox.launcher.jar" .../>
Or, if you are using Ant 1.7 and don't like copying resources around (or don't have permission to do so) this appears to work to set the path to the newest available equinox launcher jar in a property for later use:
<!-- set path to eclipse folder. If local folder, use '.'; otherwise, use c:\path\to\eclipse or /path/to/eclipse/ --> <property name="eclipse.home" value="."/> <!-- store path to newest launcher JAR in path id 'newest.equinox.launcher.path.id' --> <path id="newest.equinox.launcher.path.id"> <first count="1"> <sort> <fileset dir="${eclipse.home}/eclipse/plugins" includes="**/org.eclipse.equinox.launcher_*.jar"/> <nowiki><!-- Seems the default order is oldest > newest so we must reverse it. The 'reverse' and 'date' comparators are in the internal antlib org.apache.tools.ant.types.resources.comparators. --></nowiki> <reverse xmlns="antlib:org.apache.tools.ant.types.resources.comparators"> <nowiki><!-- 'date' inherits 'reverse's namespace --></nowiki> <date/> </reverse> </sort> </first> </path> <!-- turn the path into a property --> <property name="equinox.launcher.jar.location" refid="newest.equinox.launcher.path.id" /> <!-- you can now reference the jar through the property ${equinox.launcher.jar.location} --> <echo message="Using equinox launcher jar: ${equinox.launcher.jar.location}" />
Bash Shell Script
#!/bin/bash # set path to eclipse folder. If the same folder as this script, use the default; otherwise, use /path/to/eclipse/ eclipsehome=`dirname $BASH_SOURCE`; # get path to equinox jar inside $eclipsehome folder cp=$(find $eclipsehome -name "org.eclipse.equinox.launcher_*.jar" | sort | tail -1); # start Eclipse w/ java /opt/java50/bin/java -cp $cp org.eclipse.equinox.launcher.Main ...
Cmd/Bat Script
Save this as eclipse.cmd. This has been tested with Windows XP Pro (SP2) as well as Windows 8.1 Pro.
@echo off :: set path to eclipse folder. If local folder, use '.'; otherwise, use c:\path\to\eclipse set ECLIPSEHOME=. :: get path to equinox jar inside ECLIPSEHOME folder for /f "delims= tokens=1" %%c in ('dir /B /S /OD "%ECLIPSEHOME%\plugins\org.eclipse.equinox.launcher_*.jar"') do set EQUINOXJAR=%%c :: start Eclipse w/ java echo Using %EQUINOXJAR% to start up Eclipse... java -jar "%EQUINOXJAR%" ...
Variations
- If you're looking to run JUnit tests headlessly, see Headless JUnit Testing.
- If you're looking to the Equinox p2 Admin UI, see p2 Admin UI.