Localizar, instalar e gerenciar extensões para o Visual Studio

Extensões são pacotes de código executados dentro do Visual Studio e fornecem recursos novos ou aprimorados. As extensões podem ser controles, exemplos, modelos, ferramentas ou outros componentes que adicionam funcionalidade ao Visual Studio, por exemplo, do Live Share ou do GitHub Copilot.

Para obter informações sobre como criar extensões do Visual Studio, confira SDK do Visual Studio. Para obter informações sobre como usar extensões, confira a página de extensão individual no Visual Studio Marketplace. E para obter informações sobre como encontrar extensões, confira a postagem no blog Onde estão minhas extensões favoritas no Visual Studio 2022?

Observação

Para saber mais sobre um novo modelo de extensibilidade atualmente em versão prévia, confira a postagem no blogCriar Extensões Melhores com VisualStudio.Extensibility (Versão Prévia 3).

Usar a caixa de diálogo Gerenciar Extensões

No IDE do Visual Studio, a caixa de diálogo Gerenciar Extensões é a ferramenta usada para localizar, instalar e gerenciar extensões do Visual Studio. Para abrir a caixa de diálogo Gerenciar Extensões, escolha Extensões>Gerenciar Extensões. Ou digite Extensões na caixa de pesquisa e selecione Gerenciar Extensões.

O painel à esquerda categoriza as extensões entre aquelas que estão instaladas, as que estão disponíveis no Visual Studio Marketplace (Online) e aquelas que têm atualizações disponíveis. O Gerenciador de Extensões de Roaming mantém uma lista de todas as extensões do Visual Studio você instalou em qualquer computador ou instância do Visual Studio. Ele foi projetado para permitir que você encontre suas extensões favoritas com mais facilidade.

Encontrar e instalar extensões

Você pode instalar extensões do Visual Studio Marketplace ou da caixa de diálogo Gerenciar Extensões no Visual Studio.

Para instalar extensões de dentro do Visual Studio:

1. Em Extensões>Gerenciar Extensões, localize a extensão que você deseja instalar. Se você souber o nome ou parte do nome da extensão, será possível pesquisar na janela Pesquisar.

2. Selecione Baixar.

Após a conclusão do download, você verá uma notificação na parte inferior da caixa de diálogo Gerenciar Extensões : "A extensão está agendada para instalação. Sua extensão será instalada após todas as instâncias do Visual Studio terem sido fechadas."

Se você tentar instalar uma extensão que tenha dependências, o instalador verificará se elas já foram instaladas. Se elas não tiverem sido instaladas, a caixa de diálogo Gerenciar Extensões listará as dependências que devem ser instaladas para que seja possível instalar a extensão.

Instalar sem usar a caixa de diálogo Gerenciar Extensões

Extensões que foram empacotadas em arquivos .vsix podem estar disponíveis em locais diferentes do Visual Studio Marketplace. A caixa de diálogo Extensões>Gerenciar Extensões não pode detectar esses arquivos, mas é possível instalar um arquivo .vsix clicando duas vezes no arquivo ou selecionando-o e pressionando Enter. Depois disso, basta seguir as instruções. Depois que a extensão for instalada, será possível usar a caixa de diálogo Gerenciar Extensões para habilitá-la, desabilitá-la ou desinstalá-la.

Observação

• O Visual Studio Marketplace contém extensões VSIX e MSI. A caixa de diálogo Gerenciar Extensões não pode habilitar ou desabilitar extensões baseadas em MSI.
• Se uma extensão baseada em MSI incluir um arquivo extension.vsixmanifest, a extensão será exibida na caixa de diálogo Gerenciar Extensões.

Desinstalar ou desabilitar uma extensão

Se desejar parar de usar uma extensão, você poderá desabilitá-la ou desinstalá-la. A desabilitação de uma extensão a mantém instalada, mas descarregada. Localize a extensão e selecione Desinstalar ou Desabilitar. Reinicie o Visual Studio para descarregar uma extensão desabilitada.

Observação

Você pode desabilitar extensões VSIX, mas não extensões que foram instaladas usando um MSI. As extensões instaladas por MSI só podem ser desinstaladas.

Gerenciar extensões

Se você gerencia extensões para uma organização ou quer saber mais sobre atualizações automáticas de extensão, notificações sobre falta de resposta e muito mais, você está no lugar certo.

Extensões administrativas e por usuário

A maioria das extensões são por usuário e são instaladas na pasta %LocalAppData%\Microsoft\VisualStudio\<versão do Visual Studio>\Extensions\. Algumas extensões são administrativas e são instaladas na pasta <pasta de instalação do Visual Studio>\Common7\IDE\Extensions\.

Para proteger seu sistema contra extensões que podem conter erros ou código mal-intencionado, você pode restringir extensões por usuário para carregar somente quando o Visual Studio é executado com permissões normais de usuário. Isso significa que as extensões por usuário são desabilitadas quando o Visual Studio é executado com permissões elevadas.

Para restringir quando as extensões por usuário são carregadas:

1. Abra a página de opções de extensões (Ferramentas>Opções>Ambiente>Extensões).

2. Desmarque a caixa de seleção Carregar extensões por usuário ao executar como administrador.

3. Reinicie o Visual Studio.

Atualizações automáticas de extensão

As extensões são atualizadas automaticamente quando uma nova versão está disponível no Visual Studio Marketplace. A nova versão da extensão é detectada e instalada em segundo plano. Na próxima vez que você abrir o Visual Studio, a nova versão da extensão será executada.

Se você desejar desabilitar as atualizações automáticas, poderá desabilitar o recurso para todas as extensões ou somente para extensões específicas.

• Para desabilitar as atualizações automáticas para todas as extensões, escolha o link Alterar as configurações de Extensões na caixa de diálogo Ferramentas>Gerenciar Extensões. Na caixa de diálogo Opções, desmarque a opção Atualizar extensões automaticamente.

• Para desabilitar as atualizações automáticas de uma extensão específica, desmarque a opção Atualizar automaticamente essa extensão no painel de detalhes da extensão do lado direito da caixa de diálogo Gerenciar Extensões.

Notificações de falha e falta de resposta

O Visual Studio notifica você se ele suspeita de que uma extensão estava envolvida em uma falha durante uma sessão anterior. Quando o Visual Studio falhar, ele armazenará a pilha de exceção. Na próxima vez em que o Visual Studio for iniciado, ele examinará a pilha, começando com a folha e funcionando em direção à base. Se o Visual Studio determinar que um quadro pertence a um módulo que faz parte de uma extensão instalada e habilitada, ele mostra uma notificação.

O Visual Studio também notifica você se ele suspeita de que uma extensão é responsável por uma interface do usuário sem resposta.

Quando essas notificações forem exibidas, você poderá ignorar a notificação ou executar uma das seguintes ações:

• Escolha Desabilitar esta extensão. O Visual Studio desabilita a extensão e permite que você saiba se precisa reiniciar o sistema para a desabilitação entrar em vigor. Você poderá habilitar a extensão novamente na caixa de diálogo Extensões>Gerenciar Extensões se desejar.

• Escolha Nunca mostrar essa mensagem novamente.

  • Se a notificação for sobre uma falha em uma sessão anterior, o Visual Studio não mostrará mais uma notificação quando uma falha associada a essa extensão ocorrer. O Visual Studio ainda mostrará notificações quando a falta de resposta puder ser associada a essa extensão, ou para falhas ou falta de resposta que possam ser associadas a outras extensões.
  • Se a notificação for sobre a falta de resposta, o IDE (ambiente de desenvolvimento integrado) não mostrará mais uma notificação quando essa extensão for associada à falta de resposta. O Visual Studio ainda mostrará notificações relacionadas à falha para essa extensão, e notificações relacionadas a falhas e falta de resposta para outras extensões.

• Escolha Saiba mais para navegar para esta página.

• Escolha o botão X no final da notificação para ignorar a notificação. Uma nova notificação será exibida para instâncias futuras da extensão que está sendo associada a uma falha ou falta de resposta da interface do usuário.

Observação

Uma notificação de falha ou de falta de resposta da interface do usuário significa apenas que um dos módulos de extensão estava na pilha quando a interface do usuário ficou sem resposta ou quando a falha ocorreu. Isso não significa necessariamente que a extensão em si seja a culpada. É possível que a extensão tenha chamado um código que faz parte do Visual Studio, que por sua vez resultou em uma falha ou interface do usuário sem resposta. No entanto, a notificação ainda poderá ser útil se a extensão que causou a falta de resposta ou a falha da interface do usuário não for importante para você. Nesse caso, desabilitar a extensão evita que a falta de resposta da IU ou a falha ocorra no futuro, sem afetar sua produtividade.

Exemplos

Quando você instala um exemplo online, a solução é armazenada em dois locais:

• Uma cópia funcional é armazenada no local que você especificou quando criou o projeto.

• Uma cópia mestra separada é armazenada em seu computador.

É possível usar a caixa de diálogo Extensões>Gerenciar Extensões para executar estas tarefas relacionadas a amostras:

• Listar as cópias mestras dos exemplos que você instalou.

• Desabilitar ou desinstalar a cópia mestra de um exemplo.

• Instale os Pacotes de Exemplos, que são coleções de exemplos que se relacionam a uma tecnologia ou um recurso.

• Instalar exemplos online individuais.

• Exibir notificações de atualização quando as alterações do código-fonte são publicadas para exemplos instalados.

• Atualize a cópia mestra de um exemplo instalado quando houver uma notificação de atualização.

Conteúdo relacionado

• SDK do Visual Studio
• Página Visual Studio Extensibility.
• Visual Studio Marketplace
• Suporte para o SDK do Visual Studio