Comment : migrer un langage spécifique à un domaine vers une nouvelle versionHow to: Migrate a Domain-Specific Language to a New Version

Vous pouvez migrer des projets qui définissent et utilisent le langage spécifique à un domaine à Visual Studio 2010 à partir de la version de Outils DSL (langage spécifique à un domaine)Domain-Specific Language Tools qui a été distribué avec Visual Studio 2008Visual Studio 2008.You can migrate projects that define and use domain-specific language to Visual Studio 2010 from the version of Outils DSL (langage spécifique à un domaine)Domain-Specific Language Tools that was distributed with Visual Studio 2008Visual Studio 2008.

Un outil de migration est fourni dans le cadre de Kit de développement logiciel Visual StudioVisual Studio SDK.A migration tool is provided as part of Kit de développement logiciel Visual StudioVisual Studio SDK. L’outil convertit Visual StudioVisual Studio projets et solutions qui utilisent ou définissent des outils DSL.The tool converts Visual StudioVisual Studio projects and solutions that use or define DSL Tools.

Vous devez exécuter l’outil de migration de manière explicite : il n’est pas lancée automatiquement lorsque vous ouvrez une solution dans Visual StudioVisual Studio.You must run the migration tool explicitly: it is not launched automatically when you open a solution in Visual StudioVisual Studio. Vous trouverez l’outil et le document des instructions détaillées sur ce chemin d’accès :The tool and detailed guidance document can be found at this path:

% Programme Files%\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\DSLTools\DslProjectsMigrationTool.exe%Program Files%\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\DSLTools\DslProjectsMigrationTool.exe

Avant de migrer vos projets DSLBefore you Migrate your DSL Projects

L’outil de migration modifie Visual StudioVisual Studio fichiers projet (.csproj) et les fichiers solution (.sln).The migration tool modifies Visual StudioVisual Studio project files (.csproj) and solution files (.sln).

Pour préparer des projets pour la migration.To prepare projects for migration.

  • Assurez-vous que le .csproj et .sln fichiers peuvent être écrits.Make sure the .csproj and .sln files can be written. S’ils sont sous contrôle de code source, assurez-vous qu’ils sont extraits.If they are under source control, make sure that they are checked out.

  • Effectuez une copie des dossiers que vous voulez migrer.Make a copy of the folders you intend to migrate.

Migration d’une Collection de projetsMigrating a Collection of Projects

Pour migrer des Solutions et projets DSL pour Visual Studio 2010To Migrate DSL Projects and Solutions to Visual Studio 2010

  1. Démarrez l’outil de Migration de DSL.Start the DSL Migration Tool.

    • Double-cliquez sur l’outil dans l’Explorateur Windows (ou Explorateur de fichiers) ou de démarrer l’outil à partir d’une invite de commandes.You can double-click the tool in Windows Explorer (or File Explorer), or start the tool from a command prompt. L’outil se trouve dans cet emplacement :The tool is in this location:

      %ProgramFiles%\Microsoft visual Studio 2010 SDK\VisualStudioIntegration\Tools\DSLTools\DslProjectsMigrationTool.exe%ProgramFiles%\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\DSLTools\DslProjectsMigrationTool.exe

  2. Choisissez un dossier qui contient les solutions et projets que vous souhaitez convertir.Choose a folder that contains solutions and projects that you want to convert.

    • Entrez le chemin d’accès dans la zone située en haut de l’outil, ou cliquez sur Parcourir.Enter the path in the box at the top of the tool, or click Browse.

      L’outil de migration affiche une arborescence de projets qui définissent ou utiliser DSL.The migration tool displays a tree of projects that define or use DSLs. L’organigramme inclut chaque projet qui utilise le Microsoft.VisualStudio.Modeling.Sdk ou TextTemplating assemblys.The tree includes every project that uses the Microsoft.VisualStudio.Modeling.Sdk or TextTemplating assemblies.

  3. Passez en revue l’arborescence de projets et décochez les projets que vous ne souhaitez pas convertir.Review the tree of projects, and uncheck projects that you do not want to convert.

    • Sélectionnez un projet ou une solution pour afficher la liste des modifications pour rend l’outil.Select a project or solution to see a list of changes that the tool will make.

      Note

      Les cases à cocher qui apparaissent en regard des noms de dossier n’ont aucun effet.The checkboxes that appear next to folder names have no effect. Vous devez développer les dossiers pour inspecter les projets et solutions.You must expand the folders to inspect the projects and solutions.

  4. Convertir les projets.Convert the projects.

    1. Cliquez sur convertir.Click Convert.

      Avant de chaque fichier de projet est converti, une copie de projet.csproj est enregistré en tant que projet. vs2008.csprojBefore each project file is converted, a copy of project.csproj is saved as project.vs2008.csproj

      Une copie de chaque solution.sln est enregistré en tant que solution. vs2008.slnA copy of each solution.sln is saved as solution.vs2008.sln

    2. Examiner les échecs de conversion sont signalés.Investigate any failed conversions that are reported.

      Échecs sont signalés dans la fenêtre texte.Failures are reported in the text window. En outre, l’arborescence affiche un indicateur rouge sur chaque nœud qui n’a pas pu convertir.In addition, the tree view shows a red flag on each node that has failed to convert. Vous pouvez cliquer sur le nœud pour obtenir plus d’informations sur cet échec.You can click the node to get more information about that failure.

  5. Transformer tous les modèles dans les solutions contenant correctement converti des projets.Transform All Templates in solutions containing successfully converted projects.

    1. Ouvrez la solution.Open the solution.

    2. Cliquez sur le transformer tous les modèles bouton dans l’en-tête de l’Explorateur de solutions.Click the Transform All Templates button in the header of Solution Explorer.

      Note

      Vous pouvez effectuer cette étape inutiles.You can make this step unnecessary. Pour plus d’informations, consultez comment automatiser transformer tous les modèles.For more information, see How to Automate Transform All Templates.

  6. Mettre à jour votre code personnalisé dans les projets convertis.Update your custom code in the converted projects.

    • Tentez de générer les projets et examiner les échecs.Attempt to build the projects, and investigate any failures.

    • Tester votre concepteur.Test your designer.

Note

Dans Visual Studio 2017, le SDK de Transformation de modèle de texte et le SDK de modélisation de Visual Studio sont installés automatiquement lorsque vous installez des fonctionnalités spécifiques de Visual Studio.In Visual Studio 2017, the Text Template Transformation SDK and the Visual Studio Modeling SDK are installed automatically when you install specific features of Visual Studio. Pour plus d’informations, consultez ce billet de blog.For more details, see this blog post.

Voir aussiSee Also