Introdução ao modelo de projeto VSIX

Você pode usar o modelo Projeto VSIX para criar uma extensão ou empacotar uma extensão existente para implantação. O modelo de projeto VSIX tem versões do Visual Basic e Visual C# e é instalado como parte do SDK do Visual Studio.

O modelo do Projeto VSIX consiste apenas em um source.extension.vsixmanifest arquivo, que contém informações sobre a extensão e os ativos que ele envia.

Para localizar o modelo de projeto VSIX, você deve instalar o SDK do Visual Studio. Para obter mais informações, confira SDK do Visual Studio.

Implantar um modelo de projeto personalizado usando o modelo de projeto VSIX

As etapas a seguir mostram como usar o projeto VSIX para empacotar um modelo de projeto que você pode compartilhar com outros desenvolvedores ou carregar na Galeria do Visual Studio.

1. Crie um modelo de projeto.

   1. Abra o projeto a partir do qual criar um modelo. Este projeto pode ser de qualquer tipo de projeto.

   2. No menu Projeto, clique em Exportar Modelo. Conclua as etapas do assistente.

      Um .zip arquivo é criado no %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\.

2. Crie um projeto VSIX vazio.

   Selecione Arquivo>Novo>Projeto. Na caixa de pesquisa, digite "vsix" e selecione a versão C# ou Visual Basic do projeto VSIX.

3. Adicione o arquivo .zip ao projeto. Defina sua propriedade Copiar para Diretório de Saída como Copy Always.

4. No Gerenciador de Soluções, clique duas vezes no arquivo source.extension.vsixmanifest para abri-lo no Designer de Manifesto VSIX e faça as seguintes alterações:

   • Defina o campo Nome do Produto como Meu Modelo de Projeto.

   • Defina o campo ID do Produto como MyProjectTemplate - 1.

   • Defina o campo Autor como Fabrikam.

   • Defina o campo Descrição como Meu modelo de projeto.

   • Na seção Ativos, adicione um tipo Microsoft.VisualStudio.ProjectTemplate e defina seu caminho para o nome do arquivo .zip.

5. Salve e feche o arquivo source.extension.vsixmanifest.

6. Compile o projeto.

7. No diretório de saída, clique duas vezes no .vsix arquivo.

8. Uma caixa de mensagem do VSIX Installer é exibida. Siga as instruções para instalar a extensão.

9. Feche o Visual Studio e, em seguida, o reabra.

10. Selecione Gerenciar extensões (no menu Extensões ) e selecione a categoria Modelos . Uma das extensões disponíveis deve ser Meu Modelo de Projeto.

11. O novo modelo de projeto aparece na caixa de diálogo Novo projeto no mesmo local que o modelo de projeto original. Por exemplo, se você criou um modelo chamado Console VB de um aplicativo de console do Visual Basic, o Console do VB aparecerá no mesmo painel que o modelo Aplicativo de Console do Visual Basic.

Para especificar o local do modelo na caixa de diálogo Novo Projeto

1. As pastas de modelo estão localizadas nos {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates diretórios e {Visual Studio Installation Path}\Common7\IDE\ItemTemplates . Os nomes das seções de nível superior na caixa de diálogo Novo Projeto não correspondem exatamente aos nomes das pastas de modelo. Onde eles diferem, use o nome da pasta de modelo.

   Altere a extensão de .vsix arquivo para .zipe, em seguida, abra o arquivo.

2. Crie uma nova pasta com o mesmo nome da seção da caixa de diálogo Novo Projeto na qual o modelo deve aparecer.

3. Se o modelo for exibido em uma subseção, crie uma subpasta com o mesmo nome.

4. Mova o arquivo de modelo .zip para a nova pasta.

5. Altere a .zip extensão para .vsix.

6. Abra o manifesto VSIX.

7. No manifesto VSIX, atualize o caminho Asset do modelo para que ele aponte para a raiz da árvore de diretórios que contém o arquivo de modelo. Por exemplo, se o modelo estiver em \CSharp\Windows, a referência deve apontar para \CSharp.