How to: Migrate a Domain-Specific Language to a New Version

  • Article

You can migrate a domain-specific language to Visual Studio 2008 from the version of Domain-Specific Language Tools that was distributed with Visual Studio 2005 or from the version that was distributed with the Visual Studio 2008 Beta release.

Migrating a Domain-Specific Language from Visual Studio 2005

This procedure uses as an example the domain-specific language that is created in Walkthrough: Creating a Domain-Specific Language Solution.

To migrate a domain-specific language from Visual Studio 2005

  1. Create a domain-specific language solution in Visual Studio 2008 that has the same name, file name extension, and company name as the original solution. For example, in the FamilyTree solution, the name of the solution is FamilyTree, the file name extension is .ftree, and the company name is Fabrikam.

  2. Copy the DslDefinition.dsl file in the Dsl project of the original solution and paste it in the Dsl project of the new solution. If you see errors in the Output window, ignore them at this point.

  3. If the original solution has custom code files or a custom resource file, copy them and paste them in the new solution.

  4. Transform all templates and rebuild the solution. There should be no errors in the generated code.

  5. If you want to deploy the domain-specific language, add a setup project to the new solution.

  6. If the original solution has a customized .dslsetup file, copy it and paste it in the new solution.

  7. Transform all templates and rebuild the solution.

  8. The installation file is the .msi file in the \bin\Debug\ folder in the setup project.

Migrating a Domain-Specific Language from Visual Studio 2008 Beta

The following steps are required to migrate a domain-specific language that was created by using the Beta version of Visual Studio 2008 SDK.

To migrate a domain-specific language from Visual Studio 2008 Beta

  1. Select the DslPackage project, right-click the project name, click Properties, and on the Debug page add /ranu to the Command line arguments box.

  2. Before the solution is loaded, in the DslPackage.csproj file, change the RegisterWithCodeBase value to true and the GacTargetOutput value to false.

  3. Before the solution is loaded, in the Dsl.csproj file, change the GacTargetOutput value to false.

See Also

Concepts

What's New in Domain-Specific Language Tools

Change History

Date

History

Reason

July 2008

New topic.

Information enhancement.