Compartilhar via


Importar ou exportar configurações de instalação

Você pode usar arquivos de configuração de instalação para configurar o que for instalado pelo Visual Studio. Para fazer isso, exporte as cargas de trabalho, os componentes e as informações de extensão do Marketplace para um arquivo .vsconfig usando o instalador do Visual Studio. Quando já tiver um arquivo *.vsconfig, você poderá refiná-lo manualmente e adicionar ou remover itens adicionais. A estrutura e sintaxe do arquivo *.vsconfig está descrito abaixo. Você também pode importar um arquivo de configuração para uma instalação nova ou existente do Visual Studio, usá-la para criar ou modificar um layout ou uma instalação offline, colocá-la em um diretório de solução ou repositório e acionar uma instalação de componentes ausentes e compartilhá-la com outras pessoas.

Exportar uma configuração usando o instalador do Visual Studio

É possível exportar um arquivo de configuração de instalação de uma instância instalada anteriormente do Visual Studio.

Observação

A partir do Visual Studio 2022 versão prévia 17.10, você pode exportar extensões do Visual Studio Marketplace que foram carregadas em um contexto de toda a instância em um arquivo *.vsconfig. Se você quiser que a funcionalidade export possa exportar outros tipos de extensões, como as carregadas de um compartilhamento de rede ou as carregadas no contexto do usuário, entre em contato conosco.

Usar a interface do usuário do Instalador do Visual Studio

  1. Abra o Instalador do Visual Studio.

  2. No cartão do produto, escolha o botão Mais e selecione Exportar configuração.

    Exportar configuração do cartão de produto no instalador do Visual Studio

  3. Procure ou digite o local no qual deseja salvar seu arquivo .vsconfig e, em seguida, escolha Examinar detalhes.

    Exportar a configuração do instalador do Visual Studio

  4. Verifique se as seleções estão corretas e selecione Exportar.

    Captura de tela da janela Exportar.

Exportar um arquivo de configuração programaticamente

Você pode exportar programaticamente um arquivo de configuração de uma instância específica do Visual Studio usando o verbo export conforme descrito na documentação Instalar o Visual Studio a partir da linha de comando.

Importar uma configuração usando o instalador do Visual Studio

Você pode importar um arquivo de configuração de instalação em uma instância instalada anteriormente do Visual Studio, ou pode usá-lo para inicializar uma nova instalação do Visual Studio. A importação de um arquivo de configuração para o Visual Studio instalará qualquer coisa listada no arquivo de configuração que ainda não esteja instalada.

Usar a interface do usuário do Instalador do Visual Studio

Quando estiver pronto para importar um arquivo de configuração de instalação, siga estas etapas.

  1. Abra o Instalador do Visual Studio e feche o Visual Studio. A maioria das operações do instalador requer que o próprio produto Visual Studio esteja fechado.

  2. Na guia Instalado ou na guia Disponível, selecione Mais>Configuração de Importação no cartão do produto do Visual Studio.

  3. Localize o arquivo .vsconfig que deseja importar e selecione Revisar detalhes.

  4. Verifique se as seleções estão corretas e selecione Modificar.

Usar um arquivo de configuração programaticamente para adicionar componentes a uma instalação existente

Você pode usar o parâmetro --config para inicializar ou modificar uma instalação existente e adicionar componentes. O exemplo abaixo usa o instalador no computador cliente para modify uma instalação existente.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

Observação

Para adicionar componentes a uma instalação existente usando um arquivo de configuração (*.vsconfig), você precisará de modify seu produto instalado e não update. Update apenas atualiza os componentes instalados existentes para a versão mais recente. Para saber mais sobre as diferentes operações do instalador, consulte a documentação Instalar o Visual Studio a partir da linha de comando.

Usar um arquivo de configuração para inicializar o conteúdo de um layout

Usando o bootstrapper correto que corresponde à versão e à edição do Visual Studio que você deseja, abra um prompt de comando de administrador e execute o seguinte comando para usar o parâmetro --config e configurar o conteúdo de um layout. Mais informações sobre como usar arquivos *.vsconfig para inicializar e instalar a partir de layouts podem ser encontradas aqui.

vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US

Usar um arquivo de configuração para instalar automaticamente componentes ausentes

Se você salvar um arquivo *.vsconfig no diretório raiz da sua solução e, em seguida, abrir uma solução, o Visual Studio detectará automaticamente quais componentes estão ausentes e solicitará que você os instale.

Observação

Se o arquivo *.vsconfig contiver extensões, somente as extensões hospedadas no Visual Studio Marketplace acionarão a detecção e a instalação automáticas de "está ausente". Se você quiser que essa lógica inclua extensões que foram instaladas de um local que não seja do Marketplace, forneça detalhes sobre seu cenário aqui.

O Gerenciador de Soluções sugere os componentes adicionais

Você também pode gerar um arquivo *.vsconfig diretamente no Gerenciador de Soluções.

  1. Clique com botão direito do mouse no seu arquivo de solução.

  2. Escolha Adicionar>Arquivo de configuração de instalação.

  3. Confirme o local no qual deseja salvar o arquivo .vsconfig e escolha Revisar detalhes.

  4. Verifique se você tem as cargas de trabalho e os componentes que deseja, e escolha Exportar.

Também criamos um utilitário de código aberto que localiza arquivos de configuração de instalação do Visual Studio *.vsconfig recursivamente e os mescla todos juntos. Você pode encontrar mais informações sobre a ferramenta VSConfigFinder aqui.

Formato de arquivo vsconfig

O arquivo *.vsconfig é um formato de arquivo json que contém uma seção de componentes e, opcionalmente, uma seção de extensões. A seção de componentes contém cargas de trabalho e componentes e tem a seguinte aparência:

{
  "version": "1.0", 
  "components": [ 
    "Microsoft.VisualStudio.Component.CoreEditor", 
    "Microsoft.VisualStudio.Workload.CoreEditor", 
    "Microsoft.VisualStudio.Component.NuGet" 
    ] 
}

Extensões

A partir do Visual Studio 2022 versão 17.9, você pode especificar extensões no arquivo e usar o instalador do Visual Studio para carregá-las em todo o *.vsconfig computador, tornando-as disponíveis para todos os usuários. A partir do Visual Studio 2022 versão prévia 17.10, você pode usar o Instalador do Visual Studio para extensões export do Visual Studio Marketplace no arquivo *.vsconfig que foi carregado em um contexto de toda a instância, conforme descrito anteriormente.

Há algumas advertências conhecidas com extensões de suporte no arquivo de configuração.

  1. Como essas extensões são instaladas em toda a máquina, para instalar você deve ter permissões de administrador ou ter recebido o controle do instalador por meio da política AllowStandardUserControl para instalá-los. Observe que todas as extensões instaladas anteriormente pelo Visual Studio Extension Manager tinham a capacidade de ser (e eram normalmente) instaladas por usuário, não em toda a instância, e o usuário não precisava ter permissões de administrador para instalar.
  2. O Instalador do Visual Studio atualmente oferece suporte apenas à importação de determinados tipos de extensões, como as contidas em um pacote *.vsix ou aquelas que não são excessivamente "complicadas". Se você tiver uma extensão que não está sendo carregada através de um arquivo de configuração corretamente, informe-nos sobre ela através de uma nova sugestão da Comunidade de Desenvolvedores.
  3. Somente as extensões hospedadas no Visual Studio Marketplace acionarão a detecção e a instalação automáticas de "ausentes" se o arquivo *.vsconfig estiver em um diretório de solução. Se você quiser que essa lógica inclua extensões que foram instaladas de um local que não seja do Marketplace, forneça detalhes sobre seu cenário aqui.
  4. Se você estiver usando programaticamente um arquivo *.vsconfig para adicionar extensões, você também precisará usar o novo parâmetro --allowUnsignedExtensions para permitir que extensões sem assinaturas sejam carregadas em contexto --passive ou --quiet. Se você estiver instalando de um layout, poderá adicionar a sintaxe "allowUnsignedExtensions" : true ao seu arquivo response.json para conseguir um efeito similar.

Todas as extensões de toda a instância são atualizadas automaticamente aproximadamente uma vez por dia por meio de uma tarefa agendada. Mais informações estão disponíveis aqui.

O formato de arquivo .vsconfig que inclui as extensões deve ter a seguinte aparência.

{
  "version": "1.0", 
  "components": [ 
    // Whatever components you want to install come here, in quotes, separated by commas.
    // You can use the installer to select the components you want to install and then export them,
    // Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
    // This array should not be null! If you don't want to install any component, just leave the array empty.
  ],
  "extensions": [
    // The extensions you want to install are specified in this section, in quotes, separated by commas.
    // Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
    // The extensions must be in a *.vsix package
    // Make sure that the extensions you specify are designed to work with that version of Visual Studio.
    // examples below
    "https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit",   //unsigned extension
    "https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer",  //signed extension
    "c:\\mylocaldrive\\someextension.vsix",
    "\\\\server\\share\\myextension.vsix",
    "https://myweb/anotherextension.vsix"
  ]
}

Suporte ou solução de problemas

Às vezes, as coisas podem dar errado. Se a instalação do Visual Studio falhar, confira Solução de problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.

Aqui estão algumas outras opções de suporte: