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 CDATA #REQUIRED
name CDATA #REQUIRED
home CDATA #REQUIRED
javadocURL CDATA #IMPLIED
vmArgs CDATA #IMPLIED>
- id - Unique identifier for this VM install
- vmInstallType - References a registered VM install type via the corresponding vmInstallType's id
- name - Human readable name for this VM install
- home - Path to the home installation directory for this VM install. Paths must be absolute and may use string substitution variables such as ${eclipse_home}.
- javadocURL - URL referencing the default javadoc location for all libraries in this VM install.
- vmArgs - Default VM arguments used when launching this VM install as they should appear on the command line.
<!ELEMENT library EMPTY>
<!ATTLIST library
path CDATA #REQUIRED
sourcePath CDATA #IMPLIED
packageRootPath CDATA #IMPLIED
javadocURL CDATA #IMPLIED>
- path - File system path to a system library, relative to the VM install's home directory.
- sourcePath - File system path to the source archive associated with this libaray, relative to the VM install's home directory. When unspecified, this library has no source attachment.
- packageRootPath - Path within the source archive where package names begin. For example, if the source for java.lang.Object is located at "src\java\lang\Object" the package root path would be "src". When unspecified the package root path is automatically detected.
- javadocURL - URL referencing the javadoc location for this library. Overrides the javadoc URL specified for the VM install.
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>
Supplied Implementation:
JDT does not provide any specific VM installs.