Java VM Installs

Identifier:
org.eclipse.jdt.launching.vmInstalls

Since:
3.2

Description:
Allows specific configurations of Java runtime environments and development kits to be contributed to the Java development tooling.

Configuration Markup:

<!ELEMENT extension (vmInstall+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED

>


<!ELEMENT vmInstall (library*)>

<!ATTLIST vmInstall

id            CDATA #REQUIRED

vmInstallType IDREF #REQUIRED

name          CDATA #REQUIRED

home          CDATA #REQUIRED

javadocURL    CDATA #IMPLIED

vmArgs        CDATA #IMPLIED

>


<!ELEMENT library EMPTY>

<!ATTLIST library

path            CDATA #REQUIRED

sourcePath      CDATA #IMPLIED

packageRootPath CDATA #IMPLIED

javadocURL      CDATA #IMPLIED

>


Examples:
Following is an example vm install definition.


<extension point="org.eclipse.jdt.launching.vmInstalls">
 <vmInstall
  home="${eclipse_home}/jre"
  id="com.example.vm.id"
  name="JRE-1.4"
  vmInstallType="com.example.vm.type"/>
</extension> 

The following example will create a JRE definition based on the contents of the specified execution environment description file. When an execution environment description file is provided as the home location the "Execution Environment Description" VM type must be specified for the vmInstallType attribute.


<extension point="org.eclipse.jdt.launching.vmInstalls">
 <vmInstall
  home="${eclipse_home}/jre-def.ee"
  id="com.example.ee.id"
  name="Default JRE"
  vmInstallType="org.eclipse.jdt.launching.EEVMType"/>
</extension> 

Supplied Implementation:
JDT does not provide any specific VM installs.


Copyright (c) 2007 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html