Partilhar via

MSI e a implantação de VSIX de uma DSL

  • Artigo

Você pode instalar um idioma específico do domínio no seu próprio computador ou em outros computadores.Visual Studiojá deve estar instalado no computador de destino.

Escolhendo entre VSIX e implantação MSI

Há dois métodos de implantação de uma linguagem específica de domínio:

Método

Benefícios

VSX (Visual Studio extensão)

Muito fácil de implantar: copiar e executar o .vsix o arquivo do projeto DslPackage.

Para obter mais informações, consulte instalar e desinstalar uma DSL, usando o VSX.

MSI (arquivo instalador)

  • Permite que o usuário abra Visual Studio clicando duas vezes em um arquivo DSL.

  • Associa um ícone com o tipo de arquivo DSL no computador de destino.

  • Associa um XSD (esquema XML) com o tipo de arquivo DSL.Isso evita avisos quando o arquivo é carregado em Visual Studio.

Você deve adicionar um projeto de instalação à sua solução para criar um MSI.

Para obter mais informações, consulte Implantando uma DSL, usando um arquivo MSI.

Instalando e Desinstalando uma DSL, usando o VSX

Quando seu DSL é instalado por esse método, o usuário pode abrir um arquivo DSL a partir do Visual Studio, mas o arquivo não pode ser aberto a partir do Windows Explorer.

Para instalar uma DSL, usando o VSX

  1. No seu computador, localize o .vsix arquivo foi criado pelo seu projeto de pacote de DSL.

    1. Em Solution Explorer, com o botão direito do DslPackage de projeto e, em seguida, clique em Abrir pasta no Windows Explorer.

    2. Localize o arquivo bin\*\YourProject.DslPackage.vsix

  2. Cópia do .vsix arquivo para o computador de destino no qual deseja instalar o DSL.Isso pode ser o seu próprio computador ou outro.

  3. No computador de destino, clique duas vezes o .vsix arquivo.

    Instalador de extensão de Visual Studio abre e instala a extensão.

  4. Iniciar ou reiniciar Visual Studio.

  5. Para testar a DSL, use Visual Studio para criar um novo arquivo com a extensão que você definiu para seu DSL.

Para desinstalar uma DSL que foi instalada usando VSX

  1. Sobre o Ferramentas menu, clique em Extension Manager.

  2. Expanda as extensões instaladas.

  3. Selecione a extensão em que a DSL é definido e clique desinstalar.

Raramente, uma extensão com defeito não for carregado e cria um relatório na janela de erros, mas não aparece no Gerenciador de extensão.Nesse caso, você pode remover a extensão, excluindo o arquivo a partir:

LocalAppData**\Microsoft\VisualStudio\10.0\Extensions**

Implantando uma DSL em um MSI

Definindo um arquivo MSI (Windows Installer) para seu DSL, você pode permitir que os usuários abram arquivos DSL do Windows Explorer.Você também pode associar um ícone e uma breve descrição com sua extensão de nome de arquivo.Além disso, o MSI pode instalar um XSD que pode ser usado para validar os arquivos DSL.Se desejar, você pode adicionar outros componentes no MSI que será instalado ao mesmo tempo.

Para obter mais informações sobre arquivos MSI e outras opções de implantação, consulte Implantação de aplicativos e componentes.

Para construir um MSI, você pode adicionar um projeto de instalação para seu Visual Studio solução.O método mais fácil de criar um projeto de instalação é usar o modelo de CreateMsiSetupProject.tt, que você pode baixar do o site VMSDK.

Para implantar uma DSL em um MSI

  1. Definir InstalledByMsi no manifesto da extensão.Isso impede que o VSX sendo instalado e desinstalado, exceto pelo MSI.Isso é importante se você incluirá outros componentes do MSI.

    1. Abra DslPackage\source.extension.tt

    2. Insira a seguinte linha antes de <SupportedProducts>:

      <InstalledByMsi>true</InstalledByMsi>

  2. Criar ou editar um ícone que representará o DSL no Windows Explorer.Por exemplo, editarDslPackage\Resources\File.ico

  3. Certifique-se de que os seguintes atributos de seu DSL estão corretos:

    • No Explorer DSL clique no nó raiz e na janela Propriedades, consulte:

      • Descrição

      • Versão

    • Clique no Editor nó e na janela Properties, clique em ícone.Defina o valor para fazer referência a um arquivo de ícone em DslPackage\Resources, comoFile.ico

    • Sobre o Build menu, abrir Configuration Managere selecione a configuração que você deseja criar, como Release ou Depurar.

  4. Vá para home page de visualização e modelagem SDKe a partir do Downloads guia, faça download de CreateMsiSetupProject.tt.

  5. Adicionar CreateMsiSetupProject.tt ao seu projeto de Dsl.

    Visual Studiocriará um arquivo chamado CreateMsiSetupProject.vdproj.

  6. No Windows Explorer, copie o Dsl\ * .vdproj para uma nova pasta chamado Setup.

    (Se você desejar, você pode excluir CreateMsiSetupProject.tt do seu projeto de Dsl.)

  7. Em Solution Explorer, adicione Setup\*.vdproj como um projeto existente.

  8. Sobre o projeto menu, clique em Dependências do projeto.

    No Dependências do projeto caixa de diálogo, selecione o projeto de instalação.

    Marque a caixa ao lado de DslPackage.

  9. Recrie a solução.

  10. No Windows Explorer, localize o arquivo MSI criado em seu projeto de instalação.

    Copie o arquivo MSI para um computador no qual você deseja instalar seu DSL.Clique duas vezes no arquivo MSI.O instalador é executado.

  11. No computador de destino, crie um novo arquivo com a extensão de arquivo de seu DSL.Verifique se:

    • Na exibição de lista do Windows Explorer, o arquivo aparecerá com o ícone e a descrição que você definiu.

    • Ao clicar duas vezes no arquivo, Visual Studio inicia e abre o arquivo DSL em seu editor de DSL.

Se você preferir, você pode criar o projeto de instalação manualmente, em vez de usar o modelo de texto.Para uma explicação passo a passo que inclui esse procedimento, consulte Capítulo 5 da visualização e o laboratório de modelagem do SDK.

Para desinstalar uma DSL instaladas a partir de um MSI

  1. No Windows, abra o programas e recursos painel de controle.

  2. Desinstale o DSL.

  3. Reinicie o Visual Studio.