Créer une solution de langage spécifique à un domaine

  • Article

Un langage spécifique à un domaine (DSL) est créé à l’aide d’une solution Visual Studio spécialisée.

Prérequis

Avant de commencer cette procédure, installez les composants suivants :

  • Visual Studio
  • Kit SDK Visual Studio (installé dans le cadre de la charge de travail de développement de l’extension Visual Studio)
  • Kit SDK de modélisation (installé en tant que composant de Visual Studio)

Notes

Le composant Transformation de modèle de texte est automatiquement installé dans le cadre de la charge de travail Développement d’extensions Visual Studio. Vous pouvez aussi l’installer à partir de l’onglet Composants individuels de Visual Studio Installer, sous la catégorie SDK, bibliothèques et frameworks. Installez le composant SDK de modélisation à partir de l’onglet Composants individuels.

Création d’une solution de langage spécifique à un domaine

  1. Démarrez l’Assistant DSL en créant un projet Concepteur de langage dédié.

    Notes

    Le nom que vous choisissez pour le projet doit, de préférence, être un identificateur Visual C# valide, car il peut être utilisé pour générer du code.

  2. Choisissez un modèle DSL.

    Dans la page Sélectionner les options DSL, sélectionnez l’un des modèles de solution comme Langage minimal. Choisissez un modèle similaire au DSL que vous souhaitez créer.

    Pour plus d’informations sur les modèles de solutions, consultez Choix d'un modèle de solution de langage spécifique à un domaine.

  3. Entrez une extension de nom de fichier dans la page Extension de fichier. Elle doit être unique sur votre ordinateur et sur tous les ordinateurs où vous souhaitez installer le DSL. Le message Aucune application ou aucun éditeur Visual Studio n’utilise cette extension doit s’afficher.

    • Si vous avez utilisé l’extension de nom de fichier dans des DSL expérimentaux précédents qui n’ont pas été entièrement installés, vous pouvez les effacer à l’aide de l’outil Réinitialiser l’instance expérimentale, qui se trouve dans le menu du SDK Visual Studio.

    • Si une autre extension Visual Studio qui utilise cette extension de fichier a été entièrement installée sur votre ordinateur, envisagez de la désinstaller. Dans le menu Outils, cliquez sur Gestionnaire d’extensions.

  4. Inspectez et, si nécessaire, ajustez les champs dans les autres pages de l’Assistant. Si les paramètres vous conviennent, cliquez sur Terminer. Pour plus d’informations sur les paramètres, consultez Pages de l’Assistant Concepteur DSL.

    L’Assistant crée une solution qui contient deux projets, nommés Dsl et DslPackage.

    Notes

    Si vous voyez un message qui vous avertit de ne pas exécuter des modèles de texte à partir de sources non approuvées, cliquez sur OK. Vous pouvez configurer ce message pour qu’il ne s’affiche plus.

Pages de l’Assistant Concepteur DSL

Vous pouvez conserver plusieurs champs tels quels, avec leurs valeurs par défaut. Toutefois, veillez à définir le champ Extension de fichier.

Page Paramètres de solution

Sur quel modèle souhaitez-vous baser votre langage dédié ? Choisissez un modèle similaire au DSL que vous souhaitez créer. Les différents modèles fournissent des points de départ pratiques. Lorsque vous sélectionnez un modèle de solution, l’Assistant affiche une description. Pour plus d’informations sur les modèles de solutions, consultez Choix d'un modèle de solution de langage spécifique à un domaine.

Quel nom souhaitez-vous donner à votre langage dédié ? Par défaut, le nom de la solution est utilisé. Le code est généré à partir de cette valeur. Il doit s’agir d’un nom de classe C# valide.

Page Extension de fichier

Quelle extension les fichiers de modèles doivent-ils utiliser ? Saisissez une nouvelle extension de fichier.

Vérifiez que cette extension de fichier n’a pas déjà été inscrite pour une utilisation sur cet ordinateur, comme suit :

Effectuez une recherche sous Autres outils et applications inscrits pour gérer cette extension. Si le message Aucune application ou aucun éditeur Visual Studio n’utilise cette extension s’affiche, vous pouvez utiliser cette extension de fichier.

Si vous voyez une liste d’outils ou de packages, vous devez effectuer l’une des opérations suivantes :

  • Saisissez une autre extension de fichier.

    - ou -

  • Réinitialisez l’instance expérimentale de Visual Studio. Cela permet d’annuler l’inscription de tous les DSL que vous aviez précédemment créés. Dans le menu Démarrer de Windows, tapez réinitialiser Visual Studio, puis exécutez la commande Réinitialiser l’instance expérimentale Microsoft Visual Studio correspondant à votre version de Visual Studio. Vous pouvez reconstruire tous les autres DSL que vous souhaitez utiliser.

    - ou -

  • Si une extension Visual Studio qui utilise cette extension de fichier a été entièrement installée sur votre ordinateur, désinstallez-la. Dans le menu Outils, cliquez sur Gestionnaire d’extensions.

Page Paramètres du produit

Quel est le nom du produit auquel appartient le nouveau langage dédié ? Par défaut, le nom DSL est utilisé.

Cette valeur est utilisée dans l’Explorateur Windows (ou Explorateur de fichiers) pour décrire les fichiers qui ont cette extension de fichier.

Quel est le nom de la société à laquelle le produit appartient ? Nom de votre société.

Cette valeur est incorporée dans les propriétés AssemblyInfo de votre package DSL.

Quel est l’espace de noms racine des projets dans cette solution ? Par défaut, il s’agit d’un nom composé à partir des noms de votre entreprise et de votre produit.

Page Signature

Créer un fichier de clé à nom fort L’option par défaut consiste à créer une nouvelle clé pour signer votre assembly DSL.

Utiliser une clé à nom fort existante Utilisez cette option si vous souhaitez intégrer votre DSL à un autre assembly.

Pour plus d’informations sur les noms forts, consultez Création et utilisation d’assemblys à nom fort.

Contenu connexe