Redistribuindo arquivos do Visual C++

  • Artigo

Observação

Você está aqui porque procura um download de um dos arquivos do Runtime do Visual C++? Vá para a página Downloads do Pacote Redistribuível do Visual C++ com suporte mais recentes.

Arquivos redistribuíveis e licenciamento

Ao implantar um aplicativo, você também deve implantar os arquivos que são necessários para o suporte. Se algum desses arquivos for fornecido pela Microsoft, verifique se você tem permissão para redistribuí-los. Você encontrará um link para os termos de licença do Visual Studio no IDE. Use o link Termos de licença na caixa de diálogo Sobre o Microsoft Visual Studio. Ou baixe os EULAs e as licenças relevantes do Diretório de Licenças do Visual Studio.

Para exibir a "lista de Pacote Redistribuível" mencionada na seção "Código Distribuível" dos Termos de Licença para Software Microsoft do Visual Studio 2022, consulte Arquivos de código distribuível para Microsoft Visual Studio 2022.

Para exibir a "lista de Pacote Redistribuível" mencionada na seção "Código Distribuível" dos Termos de Licença para Software Microsoft do Visual Studio 2019, consulte Arquivos de código distribuível para Microsoft Visual Studio 2019.

Para exibir a "lista de Pacote Redistribuível" mencionada na seção "Código Distribuível" dos Termos de Licença para Software Microsoft do Visual Studio 2017, consulte Arquivos de código distribuível para Microsoft Visual Studio 2017.

Para exibir a "lista de Pacote Redistribuível" mencionada na seção "Código Distribuível" dos Termos de Licença para Software Microsoft do Visual Studio 2015, consulte Arquivos de código distribuível para Microsoft Visual Studio 2015.

Para obter mais informações sobre os arquivos redistribuíveis, consulte Determinar quais DLLs serão redistribuídas e Exemplos de implantação.

Localizar os arquivos redistribuíveis

Para implantar arquivos redistribuíveis, é possível usar os pacotes redistribuíveis instalados pelo Visual Studio. Nas versões do Visual Studio a partir de 2017, esses arquivos são nomeados vc_redist.arm64.exe, vc_redist.x64.exe e vc_redist.x86.exe. No Visual Studio 2015, 2017 e 2019, também estão disponíveis com os nomes vcredist_x86.exe, vcredist_x64.exe e (somente 2015) vcredist_arm.exe.

A maneira mais fácil de localizar os arquivos redistribuíveis é usando as variáveis de ambiente definidas em um prompt de comando do desenvolvedor. No Visual Studio 2022, os arquivos redistribuíveis estão na pasta %VCINSTALLDIR%Redist\MSVC\v143. Na versão mais recente do Visual Studio 2019, você encontrará os arquivos redistribuíveis na pasta %VCINSTALLDIR%Redist\MSVC\v142. No Visual Studio 2017 e no Visual Studio 2019, também são encontrados em %VCToolsRedistDir%. No Visual Studio 2015, esses arquivos podem ser encontrados em %VCINSTALLDIR%redist\<locale>, em que <locale> é o local dos pacotes redistribuíveis.

No Visual Studio 2022 e no 2019, os arquivos do módulo de mesclagem fazem parte de um componente instalável opcional nomeado C++ <versão> MSMs Redistribuíveis no Instalador do Visual Studio. Os módulos de mesclagem são instalados por padrão como parte de uma instalação C++ no Visual Studio 2017 e no Visual Studio 2015. Quando instalados no Visual Studio 2022, os módulos de mesclagem redistribuíveis estão localizados em %VCINSTALLDIR%Redist\MSVC\v143\MergeModules. Na versão mais recente do Visual Studio 2019, os módulos de mesclagem redistribuíveis estão em %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. No Visual Studio 2019 e no Visual Studio 2017, eles também estão em %VCToolsRedistDir%MergeModules. No Visual Studio 2015, são encontrados em Program Files [(x86)]\Common Files\Merge Modules.

Instalar os pacotes redistribuíveis

Os pacotes redistribuíveis do Visual C++ instalam e registram todas as bibliotecas do Visual C++. Caso você utilize, execute-os como pré-requisito no sistema de destino antes de instalar o aplicativo. Recomendamos que você use esses pacotes para suas implantações, pois permitem a atualização automática das bibliotecas do Visual C++. Para obter um exemplo de como usar esses pacotes, confira Passo a passo: Implantando um aplicativo do Visual C++ usando o Pacote Redistribuível do Visual C++.

Cada Pacote Redistribuível do Visual C++ verifica a existência de uma versão mais recente no computador. Se uma versão mais recente for localizada, o pacote não será instalado. No Visual Studio 2015 ou posterior, os Pacotes redistribuíveis exibem uma mensagem de erro informando que a configuração falhou. Se um pacote executar usando o sinalizador /quiet, nenhuma mensagem de erro será exibida. Em ambos os casos, um erro é registrado em log pelo Microsoft Installer e um resultado do erro é retornado ao chamador. No Visual Studio 2015 e posterior, é possível evitar esse erro verificando o registro para descobrir se há uma versão mais recente instalada. O número de versão instalada atual é armazenado na chave HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}. O número de versão é 14.0 para Visual Studio 2015, 2017, 2019 e 2022 porque o Pacote Redistribuível mais recente é compatível com binários com versões anteriores de 2015. A chave será arm64, x86 ou x64 dependendo das versões de vcredist instaladas para a plataforma. (Você precisa verificar a Wow6432Node subchave apenas se estiver usando o Regedit para visualizar a versão do pacote x86 instalado em uma plataforma x64.) O número da versão é armazenado no REG_SZ valor da cadeia de caracteres Version e também no conjunto de valores Major, Minor, Bld e Rbld REG_DWORD. Para evitar um erro no momento da instalação, ignore a instalação do pacote Redistribuível se a versão instalada no momento for mais recente.

Opções de linha de comando para pacotes redistribuíveis

O Pacote Redistribuível do Visual C++ dá suporte a várias opções de linha de comando. As opções /? /h, ou /help exibem uma caixa de diálogo pop-up que lista as opções disponíveis. Você pode especificar /install para instalar, /repair para reparar ou /uninstall para desinstalar o Redistribuível. A opção /layout copia o conteúdo completo do Redistribuível no diretório atual. Por padrão, o Redistribuível instala seu conteúdo e solicita informações ao usuário e se deve reiniciar após a instalação. Você pode especificar a opção /passive, que exibe o progresso, mas não requer interação do usuário. Você também pode especificar uma opção /quiet, que não exibe nenhuma IU nem requer nenhuma interação do usuário. A opção /norestart suprime qualquer tentativa de reinicialização. Por padrão, um arquivo de log é criado em %TEMP%. Você pode usar /log filename.txt para registrar em um arquivo específico.

Esse comando de exemplo instala o x64 Redistributable. Ele mostra o progresso da instalação, mas não requer interação do usuário ou reinicialização:

vc_redist.x64.exe /install /passive /norestart

Instalar os módulos de mesclagem redistribuíveis

Importante

Os módulos de mesclagem (arquivos .msm) para arquivos do Pacote Redistribuível do Visual C++ foram preteridos. Não é recomendável usá-los para a implantação de aplicativo. Em vez disso, recomendamos a implantação central do Pacote Redistribuível do Visual C++. A implantação central por um Pacote Redistribuível possibilita à Microsoft executar arquivos de biblioteca de runtime de forma independente. E uma desinstalação do aplicativo não poderá afetar os outros aplicativos que também utilizam a implantação central. Ao usar um Pacote Redistribuível para implantação central, você não será responsável por rastrear e manter as bibliotecas de runtime. Caso contrário, uma atualização dos arquivos da biblioteca de runtime exigirá a atualização e reimplantação do instalador .msi. O aplicativo poderá ficar vulnerável a bugs ou a problemas de segurança até você fazer isso.

Os módulos de mesclagem redistribuíveis deverão estar incluídos no pacote do Windows Installer (ou pacote de instalação semelhante) que você utilizar para implantar o aplicativo. Para obter mais informações, consulte Redistribuir usando módulos de mesclagem. Para obter um exemplo, consulte Passo a passo: Implantar um aplicativo do Visual C++ usando um projeto de instalação.

Instalar arquivos redistribuíveis individuais

Também é possível instalar diretamente as DLLs redistribuíveis na pasta local do aplicativo. A pasta local do aplicativo é a pasta que contém o arquivo executável do aplicativo. Por motivos de manutenção, não é recomendável usar esse local de instalação.

Potenciais erros em tempo de execução

Se o Windows não localizar uma das DLLs de biblioteca redistribuível exigidas pelo aplicativo, uma mensagem semelhante a esta poderá ser exibida: "Falha na inicialização do aplicativo porque library.dll não foi encontrada. A reinstalação do aplicativo pode corrigir esse problema."

Para resolver esse tipo de erro, verifique se o instalador do aplicativo compila corretamente. Verifique se as bibliotecas redistribuíveis foram implementadas corretamente no sistema de destino. Para obter mais informações, confira Noções básicas sobre as dependências de um aplicativo do Visual C++.

Redistribuir usando módulos de mesclagem
Descreve como usar os módulos de mesclagem do Pacote Redistribuível do Visual C++ para instalar as bibliotecas de runtime do Visual C++ como DLLs compartilhadas na pasta %windir%\system32\.

Redistribuindo controles ActiveX do Visual C++
Descreve como redistribuir um aplicativo que usa controles do ActiveX.

Redistribuindo a biblioteca do MFC
Descreve como redistribuir um aplicativo que usa MFC.

Redistribuindo um aplicativo ATL
Descreve como redistribuir um aplicativo que usa a ATL. No Visual Studio 2012 e posterior, nenhuma biblioteca ATL é necessária.

Exemplos de implantação
Links para exemplos que demonstram como implantar aplicativos do Visual C++.

Implantando aplicativos da área de trabalho
Apresenta conceitos e tecnologias de implantação do Visual C++.