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 les 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ée 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 Visual Studio SDK.A migration tool is provided as part of Visual 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 explicitement : il n’est pas lancé 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 la migration de vos projets de 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 écrites.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 souhaitez effectuer la migration.Make a copy of the folders you intend to migrate.

Migration d’une Collection de projetsMigrating a Collection of Projects

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

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

    • Double-cliquez sur l’outil dans l’Explorateur Windows (ou l’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 est à 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 les projets que vous voulez convertir.Choose a folder that contains solutions and projects that you want to convert.

    • Entrez le chemin d’accès dans la zone 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ésélectionnez 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 qui permettront à 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 à 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é sous la forme 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é sous la forme solution ***.vs2008.slnA copy of each *solution.sln is saved as solution.vs2008.sln

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

      Erreurs sont signalées dans la fenêtre de 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 convertis les 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.

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

    • Testez 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