Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os projetos VSIX são a maneira padrão de empacotar extensões de Visual Studio para distribuição. Não importa se você está criando uma extensão VisualStudio.Extensibility ou uma extensão baseada em VSSDK, a saída é um arquivo .vsix que os usuários instalam por meio do Gerenciador de Extensões ou do Visual Studio Marketplace.
Important
Este artigo aborda modelos de projeto VSIX mais antigos e a manutenção de projetos de empacotamento existentes. Para novos projetos no Visual Studio 18.11 ou posterior, use o Modelo de projeto VSIX moderno, que manipula o empacotamento VSIX. São fluxos de trabalho de projeto alternativos, não etapas consecutivas. Escolha com base no seu ambiente de desenvolvimento e no projeto existente, não apenas na versão Visual Studio que sua extensão tem como destino.
Criar um projeto VSIX
Os modelos de projeto VSIX estão disponíveis na caixa de diálogo Criar um novo projeto . Pesquise por "VSIX" para encontrá-los:
- Extensão VisualStudio.Extensibility — para extensões fora de processo usando o novo modelo de extensibilidade.
- VSIX Project – para extensões baseadas em VSSDK ou encapsulando várias saídas de extensão.
- Extensão VisualStudio.Extensibility com compatibilidade do VSSDK – para extensões híbridas usando ambos os modelos.
- Projeto VSIX vazio — Um contêiner VSIX em branco para empacotar componentes existentes.
Tip
Para novas extensões, recomendamos o Visual Studio 18.11 ou posterior e o modeloProjeto VSIX moderno. Selecione VisualStudio.Extensibility (Out-Of-Process) para obter recursos compatíveis com esse modelo; selecione um VSSDK ou uma opção híbrida somente quando precisar de APIs em processo. Em versões anteriores Visual Studio, use o modelo de Extensão VisualStudio.Extensibility ou o modelo compatível com VSSDK quando precisar de APIs do VSSDK.
Extensões de pacote em um projeto VSIX
Note
O source.extension.vsixmanifest arquivo e as etapas abaixo se aplicam somente ao VSSDK e às extensões híbridas. As extensões VisualStudio.Extensibility (fora do processo) geram os metadados a partir de ExtensionConfiguration.Metadata no código – nenhum arquivo de manifesto é necessário.
Você pode empacotar uma extensão ou componente existente encapsulando-a em um projeto VSIX:
- Crie um projeto VSIX usando qualquer um dos modelos acima.
- O
source.extension.vsixmanifestarquivo é aberto no Manifest Designer. - Na guia Ativos , selecione Novo para adicionar componentes.
- Na lista Tipo, escolha o tipo de ativo a ser adicionado (por exemplo,
Microsoft.VisualStudio.MefComponent,Microsoft.VisualStudio.VsPackage). - Defina a origem como um projeto na solução atual e selecione o projeto.
O formato VSIX dá suporte ao empacotamento de VSPackages, componentes MEF, assemblies, modelos de projeto, modelos de item, controles de caixa de ferramentas e tipos de extensão personalizados.
Adicionar dependências a um pacote VSIX
Você pode configurar o VSIX para exigir outras extensões como dependências. Quando um usuário instala sua extensão, o instalador verifica se todas as dependências necessárias estão presentes.
Para adicionar uma dependência:
- Abra
source.extension.vsixmanifestna exibição Projeto. - Vá para a guia Dependências e selecione Novo.
- Escolha a extensão Instalada para selecionar uma dependência de extensões já instaladas ou Arquivo no sistema de arquivos para fazer referência diretamente a outro VSIX.
Exigir uma versão de Visual Studio específica
Para direcionar um número mínimo de build do Visual Studio, defina o intervalo de versão InstallationTarget:
<Installation>
<InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,)" />
</Installation>
Note
A partir do Visual Studio 2026, somente o limite inferior do intervalo de versão é avaliado. O limite superior é ignorado para fins de compatibilidade. Consulte a compatibilidade da extensão.
Criar um pacote de extensões
Um pacote de extensão é um conjunto de extensões que podem ser instaladas juntas. Os pacotes de extensão permitem compartilhar suas extensões favoritas com colegas ou agrupar um conjunto de extensões para um cenário.
Para criar um pacote de extensões:
- Crie um novo VSIX Project.
- Clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Adicionar>Novo Item.
- Selecione o modelo do Pacote de Extensões . Isso adiciona um arquivo
.vsext. - Edite o
.vsextarquivo para listar as extensões a serem incluídas:
{
"id": "MyExtensionPack",
"name": "My Extension Pack",
"description": "A curated set of extensions for my team",
"version": "1.0.0.0",
"extensions": [
{
"vsixId": "41858b2d-ff0b-4a43-80b0-f1b2d6084935",
"name": "AlignAssignments"
},
{
"vsixId": "42374550-426a-400e-96f9-237682e8dea6",
"name": "CopyAsHtml"
}
]
}
- Localize o ID da extensão no
vsixIdVisual Studio Marketplace ↗ — abra a página da extensão e selecione Copiar ID. - Compile e publique o projeto. Consulte Publicar no Marketplace.
Note
Os pacotes de extensões só podem instalar extensões disponíveis no Visual Studio Marketplace ↗ ou em uma galeria privada.
Visão geral da arquitetura de extensão
Entender como o Visual Studio carrega sua extensão ajuda você a tomar melhores decisões de empacotamento e implantação.
VisualStudio.Extensibility (fora do processo)
As extensões fora de processo são executadas em um processo à parte do Visual Studio, comunicando-se por meio um canal JSON-RPC:
┌─────────────────────┐ JSON-RPC ┌──────────────────────┐
│ Visual Studio │◄─────────────────────►│ Extension Process │
│ (DevEnv.exe) │ │ (.NET 8+) │
│ │ │ │
│ ┌───────────────┐ │ │ ┌────────────────┐ │
│ │ Extension Host│ │ │ │ Your Extension │ │
│ │ (manages │ │ │ │ Code │ │
│ │ lifecycle) │ │ │ └────────────────┘ │
│ └───────────────┘ │ └──────────────────────┘
└─────────────────────┘
Principais características:
- A extensão é executada em .NET moderno (8+)
- Falhas no processo das extensões têm menos probabilidade de derrubar o Visual Studio
- Instalar/desinstalar VS sem reiniciar
- Instalação por usuário (nenhum administrador necessário)
VSSDK/Híbrido (no processo)
As extensões em processo são carregadas diretamente no processo de Visual Studio:
┌──────────────────────────────────────────┐
│ Visual Studio (DevEnv.exe) │
│ │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ VS Core │ │ Your Extension │ │
│ │ Services │◄─┤ (.NET Framework│ │
│ │ │ │ or hybrid) │ │
│ └────────────────┘ └────────────────┘ │
└──────────────────────────────────────────┘
Principais características:
- Acesso total a todas as APIs e serviços do VS
- Limitado a .NET Framework (a menos que seja híbrido)
- Bugs de extensão podem afetar a estabilidade do VS
- Requer a reinicialização do VS na instalação/atualização
O que está em um pacote .vsix
Um arquivo .vsix é um arquivo compactado ZIP com uma estrutura padrão. O conteúdo difere de acordo com o modelo de extensão:
| Componente | VisualStudio.Extensibility | VSSDK |
|---|---|---|
| Metadados de extensão |
ExtensionConfiguration no código |
source.extension.vsixmanifest |
| Binários de extensão | Suas DLLs do .NET 8+ | As DLLs do .NET Framework |
| Arquivos de localização | .vsextension/string-resources.json |
.vsixlangpack arquivos |
| Tipos de conteúdo | [Content_Types].xml |
[Content_Types].xml |
| Manifesto de pacote | Gerado automaticamente extension.vsixmanifest |
Criado à mão source.extension.vsixmanifest |