The platform.xml file

Since:

3.0

Description:

The primary update manager configuration information is maintained by the platform.xml file located in the configuration directory (usually, eclipse/configuration/org.eclipse.update/platform.xml). This file format is internal and can change any time, but, in practice, it should not change much, if at all.

As some people would like to take advantage of shipping an eclipse based product with a pre-defined installation configuration, this document provides some syntax and semantics info for this configuration file.

Given that the platform.xml originated from the old platform.cfg and installConfig*.xml file, there are still some deprecated elements/attributes that will not be mentioned in this doc, as well as some relatively convoluted way of specifying the configuration info. If platform.xml is to become API, then some re-work is needed (both syntax and semantics).

Configuration Markup:

<!ELEMENT extension EMPTY>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT config EMPTY>

<!ATTLIST config

version   CDATA #IMPLIED

date      CDATA #IMPLIED

transient (true | false) "false"

shared_ur CDATA #IMPLIED>

describes the current install configuration.



<!ELEMENT site EMPTY>

<!ATTLIST site

url        CDATA #REQUIRED

enabled    (true | false)

updateable (true | false)

policy     (USER-EXCLUDE|USER-INCLUDE|MANAGED-ONLY)

linkfile   CDATA #IMPLIED

list       CDATA #IMPLIED>

defines an installation location, which is a location that contains features and plugins.



<!ELEMENT feature EMPTY>

<!ATTLIST feature

id      CDATA #REQUIRED

version CDATA #REQUIRED

url     CDATA #REQUIRED>

defines a feature installed on this site.



<?xml version="1.0" encoding="UTF-8"?>
<config date="1119300698390" transient="false" version="3.0">
<site enabled="true" policy="USER-EXCLUDE" updateable="true" url="platform:/base/">
<feature id="org.eclipse.platform" url="features/org.eclipse.platform_3.1.0/" version="3.1.0"> </feature>
<feature id="org.eclipse.platform.source" url="features/org.eclipse.platform.source_3.1.0/" version="3.1.0"> </feature>
<feature id="org.eclipse.rcp" url="features/org.eclipse.rcp_3.1.0/" version="3.1.0"> </feature>
<feature id="org.eclipse.jdt" url="features/org.eclipse.jdt_3.1.0/" version="3.1.0">
</feature>
<feature id="org.eclipse.jdt.source" url="features/org.eclipse.jdt.source_3.1.0/" version="3.1.0">
</feature>
<feature id="org.eclipse.pde" url="features/org.eclipse.pde_3.1.0/" version="3.1.0">
</feature>
<feature id="org.eclipse.sdk" url="features/org.eclipse.sdk_3.1.0/" version="3.1.0">
</feature>
<feature id="org.eclipse.pde.source" url="features/org.eclipse.pde.source_3.1.0/" version="3.1.0">
</feature>
<feature id="org.eclipse.rcp.source" url="features/org.eclipse.rcp.source_3.1.0/" version="3.1.0">
</feature>
</site>
<site enabled="true" policy="USER-EXCLUDE" updateable="true" url="file:/d:/extensions/org.eclipse.core.tools/eclipse/"> </site>
</config>