Difference between revisions of "ATL Compatibility"

Latest revision as of 13:40, 11 December 2007

This page is related to the compatibility changes between ATL 2.0.0RC2 and newer versions.

The ids issue

ATL 2.0.0RC2 (and previous versions) has the current issue : main of internal ids are in an old formalism, which doesn't meet Eclipse's practices.

Changes for versions > 2.0.0RC2

Some of those ids are "internal" and can be changed without side-effects for ATL users. But there are three problematic ids :

• ATL nature id
• ATL builder id
• ATL launch configuration id
• ATL Perspective id

Note that if you develop some code around ATL, you may have compatibility issues with "internal" ids. If you are in that case, the only thing you must know is that "org.atl.eclipse..." ids have been replaced by their "org.eclipse.m2m.atl..." equivalent.

Be careful : the ATL perspective id has also changed, so to apply this change, simply close the ATL perspective and reopen it.

ATL Compatibility Tool

To make easier transition to new ATL versions, we provide a tool which allows you to convert your previous ATL work. This tool is available under the ATL perspective (the new one) into the "ATL Compatibility" menu. Then you can choose the projects and the launch configurations you want to convert. By clicking "OK", the tool will :

• change the .project file : update the builder and nature
• change every ATL .launch files by updating the launch configuration type.

Manual conversion

All the changes done by the tool can be done / reverted manually.

Nature and builder modification

To change builder and nature on a project you must edit the .project file of your project. You can see it into the navigator view. Here is an old .project file :

<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
	<name>UML2Relational</name>
	<comment></comment>
	<projects>
	</projects>
	<buildSpec>
		<buildCommand>
			<name>org.atl.eclipse.adt.builder.atlBuilder</name>
			<arguments>
			</arguments>
		</buildCommand>
	</buildSpec>
	<natures>
		<nature>org.atl.eclipse.adt.builder.atlNature</nature>
	</natures>
</projectDescription>

Then here is a new one :

<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
	<name>UML2Relational</name>
	<comment></comment>
	<projects>
	</projects>
	<buildSpec>
		<buildCommand>
			<name>org.eclipse.m2m.atl.adt.builder.atlBuilder</name>
			<arguments>
			</arguments>
		</buildCommand>
	</buildSpec>
	<natures>
		<nature>org.eclipse.m2m.atl.adt.builder.atlNature</nature>
	</natures>
</projectDescription>

Launch configuration type modification

A .launch file is an XML file, so its type is stored into the root element as an XML attribute. Here is the old value of this attribute :

<launchConfiguration type="org.atl.eclipse.adt.launching.atlTransformation">

And the new one :

<launchConfiguration type="org.eclipse.m2m.atl.adt.launching.atlTransformation">