Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Os projetos VSIX são a forma padrão de empacotar extensões do Visual Studio para distribuição. Quer esteja a construir uma extensão VisualStudio.Extensibility ou uma extensão baseada em VSSDK, o resultado é um ficheiro .vsix que os utilizadores instalam através do Extension Manager ou do Visual Studio Marketplace.
Important
Este artigo aborda modelos antigos de projetos VSIX e a manutenção de projetos de embalagem existentes. Para novos projetos no Visual Studio 18.11 ou posterior, utilize o Modern VSIX Project Template, que trata da embalagem VSIX. Estes são fluxos de trabalho alternativos de projeto, não passos consecutivos. Escolha com base no seu ambiente de desenvolvimento e projeto existente, não apenas na versão do Visual Studio a que a sua extensão se destina.
Criar um projeto VSIX
Modelos de projeto VSIX estão disponíveis no diálogo Criar um novo projeto . Procure por "VSIX" para os encontrar:
- VisualStudio.Extensibility Extension — Para extensões extra-processo que utilizam o novo modelo de extensibilidade.
- VSIX Project — Para extensões baseadas em VSSDK ou para envolver múltiplas saídas de extensão.
- VisualStudio.Extensibility Extension com Compatibilidade VSSDK — Para extensões híbridas que utilizam ambos os modelos.
- Empty VSIX Project — Um contentor VSIX vazio para embalar componentes existentes.
Tip
Para novas extensões, recomendamos o Visual Studio 18.11 ou posterior e o Modern VSIX Project modelo. Selecione VisualStudio.Extensibility (Out-Of-Process) para funcionalidades suportadas por esse modelo; selecione uma opção VSSDK ou híbrida apenas quando precisar de APIs em processo. Em versões anteriores do Visual Studio, use o modelo VisualStudio.Extensibility Extension, ou o modelo compatível com VSSDK quando precisar de APIs VSSDK.
Extensões de pacote num projeto VSIX
Note
O ficheiro source.extension.vsixmanifest e os passos abaixo aplicam-se apenas a extensões VSSDK e híbridas. As extensões VisualStudio.Extensibility (fora de processo) geram os seus metadados a partir ExtensionConfiguration.Metadata do código — não é necessário nenhum ficheiro manifesto.
Pode empacotar uma extensão ou componente existente ao envolvê-la num projeto VSIX:
- Crie um projeto VSIX usando qualquer um dos modelos acima.
- O
source.extension.vsixmanifestficheiro abre-se no Manifest Designer. - No separador Ativos , selecione Novo para adicionar componentes.
- Na lista Tipo, escolha o tipo de ativo a adicionar (por exemplo,
Microsoft.VisualStudio.MefComponent,Microsoft.VisualStudio.VsPackage). - Defina a Origem para Um projeto na solução atual e selecione o projeto.
O formato VSIX suporta o empacotamento de VSPackages, componentes MEF, assemblies, templates de projeto, templates de itens, controlos de toolbox e tipos de extensões personalizadas.
Adicionar dependências a um pacote VSIX
Podes configurar o teu VSIX para exigir outras extensões como dependências. Quando um utilizador instala a sua extensão, o instalador verifica se todas as dependências necessárias estão presentes.
Para adicionar uma dependência:
- Abrir
source.extension.vsixmanifestna vista de Design . - Vai ao separador Dependências e seleciona Novo.
- Escolha Extensão Instalada para selecionar uma dependência entre extensões já instaladas, ou Ficheiro no sistema de ficheiros para referenciar diretamente outro VSIX.
Exigir uma versão específica do Visual Studio
Para definir como destino um número mínimo de compilação do Visual Studio, defina o intervalo de versões InstallationTarget:
<Installation>
<InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,)" />
</Installation>
Note
A partir do Visual Studio 2026, apenas o limite inferior da gama de versões é avaliado. O limite superior é ignorado por razões de compatibilidade. Veja a Compatibilidade de extensões.
Criar um pacote de extensões
Um pacote de extensões é um conjunto de extensões que podem ser instaladas em conjunto. Os pacotes de extensões permitem-lhe partilhar as suas extensões favoritas com colegas ou agrupar um conjunto de extensões para um cenário.
Para criar um pacote de extensões:
- Criar 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 template Extension Pack. Isto adiciona um ficheiro
.vsext. - Edite o
.vsextficheiro para listar as extensões, incluindo:
{
"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"
}
]
}
- Encontre o
vsixIdno Visual Studio Marketplace ↗ — abra a página da extensão e selecione Copiar ID. - Constrói e publica o projeto. Consulte Publicar no Mercado.
Note
Os pacotes de extensões só podem instalar extensões disponíveis no Visual Studio Marketplace ↗ ou numa galeria privada.
Visão geral da arquitetura de extensões
Compreender como o Visual Studio carrega a sua extensão ajuda-o a tomar melhores decisões de empacotamento e implementação.
VisualStudio.Extensibility (fora de processo)
Extensões fora do processo executam num processo separado do Visual Studio, comunicando através de 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 corre no .NET moderno (8+)
- Os crashes dos processos de extensão são menos propensos a derrubar o Visual Studio
- Instalar/desinstalar sem reiniciar VS
- Instalação por utilizador (sem necessidade de administrador)
VSSDK / Híbrido (em processo)
As extensões em processo são carregadas diretamente no processo do 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 VS
- Limitado ao Framework .NET (a menos que seja híbrido)
- Bugs de extensão podem afetar a estabilidade do VS
- Requer reinício do VS na instalação/atualização
O que está num pacote .vsix
Um .vsix ficheiro é um arquivo ZIP com uma estrutura padrão. Os conteúdos diferem consoante o modelo de extensão:
| Component | VisualStudio.Extensibility | VSSDK |
|---|---|---|
| Metadados de extensão |
ExtensionConfiguration em código |
source.extension.vsixmanifest |
| Binários de extensão | As suas DLLs .NET 8+ | As suas DLLs do Framework .NET |
| Ficheiros de localização | .vsextension/string-resources.json |
.vsixlangpack arquivos |
| Tipos de conteúdo | [Content_Types].xml |
[Content_Types].xml |
| Ficheiro de manifesto do pacote | Gerado automaticamente extension.vsixmanifest |
Criado manualmente source.extension.vsixmanifest |