Anatomia de uma extensão do Visual Studio

Um pacote VSIX é um arquivo .vsix que contém uma ou mais extensões do Visual Studio e os metadados que o Visual Studio usa para classificar e instalar as extensões. O formato do pacote VSIX segue o padrão OPC (Open Packaging Conventions), o que significa que ele pode ser aberto por qualquer ferramenta que possa abrir arquivos ZIP.

Um projeto de extensão é um projeto em C# com alguns extras que o tornam exclusivo. O vídeo a seguir explora um projeto de extensão para entender melhor como os projetos de extensão funcionam:

Estrutura de arquivos

Ao criar novas extensões usando o modelo de Projeto VSIX com Comando (Comunidade), a estrutura de arquivos tem a seguinte aparência:

O arquivo .vsixmanifest é o arquivo principal. É um arquivo XML que contém informações sobre a extensão usada pelo Visual Studio. Todos os componentes da extensão são registrados no arquivo .vsixmanifest. É o único arquivo obrigatório em um projeto VSIX.

O arquivo VSCommandTable.vsct é onde os comandos são declarados. É um arquivo XML e contém as definições de comandos de botão, menus, associações de atalho de teclado e muito mais. O arquivo compila seu conteúdo em um blob na saída .dll que o Visual Studio usa para construir toda a estrutura de menu da tabela de comandos. Esse arquivo declara apenas os componentes na tabela de comandos; ele não lida com invocações de comando.

O arquivo *Package.cs é a classe Package, que é o ponto de entrada para a maioria das extensões. Aqui, você geralmente encontra manipuladores de comando, janelas de ferramentas, páginas de opções, serviços e outros componentes registrados.

Compilação

O projeto é compilado em um arquivo .vsix localizado no /bin/debug ou /bin/release pasta, que depende da configuração de build da solução atual. O desenvolvimento de extensão do Visual Studiocarga de trabalho fornece destinos e tarefas dedicados do MSBuild para lidar com a variante do projeto VSIX.

Quando o projeto VSIX é compilado, ele se implanta automaticamente na Instância Experimental. Isso pode ser controlado nas configurações do projeto VSIX:

Instância experimental

Para proteger seu ambiente de desenvolvimento do Visual Studio contra aplicativos não testados que podem alterá-lo, o VSSDK fornece um espaço experimental que você pode usar para experimentar. Você desenvolve novos aplicativos usando o Visual Studio como de costume, mas os executa usando essa Instância Experimental.

Cada aplicativo que tem um pacote VSIX inicia a instância experimental do Visual Studio no modo de depuração.

Se você quiser iniciar a instância experimental do Visual Studio fora de uma solução específica, execute o seguinte comando na janela de comando:

devenv.exe /RootSuffix Exp

Para obter mais conceitos de extensibilidade, confira os recursos úteis, que virão a calhar para entender este kit de ferramentas.