Compartilhar via

Criar uma solução de Linguagem Específica de Domínio

  • Artigo

Uma DSL (linguagem específica de domínio) é criada usando uma solução especializada do Visual Studio.

Pré-requisitos

Antes de iniciar este procedimento, instale estes componentes:

  • Visual Studio
  • SDK do Visual Studio (instalado como parte da carga de trabalho de Desenvolvimento de extensões do Visual Studio)
  • Modelagem do SDK (instalado como um componente do Visual Studio)

Observação

O componente Transformação de Modelo de Texto é instalado automaticamente como parte da carga de trabalho de Desenvolvimento de extensões do Visual Studio. Você também pode instalá-lo na guia Componentes individuais do Instalador do Visual Studio, na categoria SDKs, bibliotecas e estruturas. Instale o componente SDK de Modelagem na guia Componentes individuais.

Criar uma solução de linguagem específica de domínio

  1. Inicie o Assistente de DSL criando um projeto de Designer de Linguagem Específica de Domínio.

    Observação

    Preferencialmente, o nome escolhido para o projeto deve ser um identificador válido do Visual C# porque ele pode ser usado para gerar código.

  2. Escolha um modelo de DSL.

    Na página Selecionar Opções de Linguagem Específica de Domínio, selecione um dos modelos de solução, como Linguagem Mínima. Escolha um modelo semelhante à DSL que você deseja criar.

    Para obter mais informações, confira Escolher um modelo de solução de linguagem específica de domínio.

  3. Insira uma extensão de nome de arquivo na página Extensão de Arquivo. Ela deverá ser exclusiva em seu computador e em todos os computadores nos quais você deseja instalar a DSL. Você deverá ver a mensagem Nenhum aplicativo ou editor do Visual Studio usa essa extensão.

    • Se você tiver usado a extensão de nome de arquivo em DSLs experimentais anteriores que não foram totalmente instaladas, poderá desmarcá-las usando a ferramenta Redefinir a Instância Experimental, que pode ser encontrada no menu do SDK do Visual Studio.

    • Se outra Extensão do Visual Studio que usa essa extensão de arquivo tiver sido totalmente instalada em seu computador, considere desinstalá-la. No menu Ferramentas, clique em Gerenciador de Extensões.

  4. Inspecione e, se necessário, ajuste os campos nas páginas restantes do assistente. Quando estiver satisfeito com as configurações, clique em Concluir. Para obter mais informações sobre as configurações, confira Páginas do Assistente do Designer de DSL.

    O assistente cria uma solução que tem dois projetos chamados Dsl e DslPackage.

    Observação

    Se você vir uma mensagem alertando para não executar modelos de texto de fontes não confiáveis, clique em OK. Você pode definir essa mensagem para não aparecer novamente.

As páginas do Assistente do Designer de Linguagem Específica de Domínio

Você pode deixar vários dos campos inalterados em relação aos respectivos valores padrão. No entanto, certifique-se de definir o campo Extensão de Arquivo.

Página Configurações da Solução

Em qual modelo você deseja basear a linguagem específica de domínio? Escolha um modelo semelhante à DSL que você deseja criar. Os diferentes modelos fornecem pontos de partida convenientes. Quando você seleciona um modelo de solução, o assistente exibe uma descrição. Para obter mais informações, confira Escolher um modelo de solução de linguagem específica de domínio.

Que nome você deseja dar à nova linguagem específica de domínio? O padrão é o nome da solução. O código é gerado com base nesse valor. Ele precisa ser válido como um nome de classe C#.

Página Extensão de Arquivo

Qual extensão os arquivos de modelo devem usar? Digite uma nova extensão de arquivo.

Verifique se essa extensão de arquivo ainda não foi registrada para uso neste computador, da seguinte maneira:

Procure em Outras ferramentas e aplicativos registrados para lidar com essa extensão. Se você vir a mensagem Nenhum aplicativo ou editores do Visual Studio usa essa extensão, poderá usar essa extensão de arquivo.

Se você vir uma lista de ferramentas ou pacotes, deverá fazer um dos seguintes procedimentos:

  • Digite uma extensão de arquivo diferente.

    - ou -

  • Redefina a instância experimental do Visual Studio. Isso cancelará o registro de todas as DSLs que você criou anteriormente. No menu Iniciar do Windows, digite redefinir o Visual Studio e, em seguida, execute o comando Redefinir a Instância Experimental do Microsoft Visual Studio correspondente à sua versão do Visual Studio. Você pode recompilar quaisquer outras DSLs que deseje usar novamente.

    - ou -

  • Se uma Extensão do Visual Studio que usa essa extensão de arquivo tiver sido totalmente instalada em seu computador, desinstale-a. No menu Ferramentas, clique em Gerenciador de Extensões.

Página de Configurações do Produto

Qual é o nome do produto ao qual a nova linguagem específica de domínio pertence? O padrão é o nome DSL.

Esse valor é usado no Windows Explorer (ou Explorador de Arquivos) para descrever arquivos que têm essa extensão de arquivo.

Qual é o nome da empresa à qual o produto pertence? O nome da sua empresa.

Esse valor é incorporado às propriedades AssemblyInfo do pacote DSL.

Qual é o namespace raiz para projetos nesta solução? Esse padrão é um nome composto de sua empresa e nomes de produto.

Página Assinatura

Criar um arquivo de chave de nome forte A opção padrão é criar uma chave para assinar o assembly DSL.

Usar a chave de nome forte existente Use essa opção se quiser integrar sua DSL a outro assembly.

Para saber mais sobre nomes fortes, confira Criar e usar assemblies com nomenclatura forte.

Conteúdo relacionado