Redistribuindo arquivos do Visual C++

Observação

Você está aqui porque está procurando um download de um dos arquivos do Runtime do Visual C++? Acesse a página de downloads de Pacote Redistribuível do Visual C++ com suporte mais recente.

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 Visual Studio no IDE. Use o link termos de licença na caixa de diálogo Sobre Microsoft Visual Studio. Ou baixe os EULAs relevantes e as licenças do diretório de licenças do Visual Studio.

Para exibir a "lista REDIST" referenciada na seção "Código Distribuível" dos Termos de Licença de Software da Microsoft Visual Studio 2022, consulte arquivos de código distribuíveis para Microsoft Visual Studio 2022

Para exibir a "lista REDIST" referenciada na seção "Código Distribuível" dos Termos de Licença de Software da Microsoft Visual Studio 2019, consulte Arquivos de Código Distribuíveis para Microsoft Visual Studio 2019

Para exibir a "lista REDIST" referenciada na seção "Código Distribuível" dos Termos de Licença de Software da Microsoft Visual Studio 2017, consulte Arquivos de Código Distribuíveis para Microsoft Visual Studio 2017.

Para exibir a "lista REDIST" referenciada na seção "Código Distribuível" dos Termos de Licença de Software da Microsoft Visual Studio 2015, consulte Arquivos de Código Distribuíveis para Microsoft Visual Studio 2015.

Para obter mais informações sobre arquivos redistribuíveis, consulte Determinando quais DLLs redistribuir e exemplos de implantação.

Localizar os arquivos redistribuíveis

Para implantar arquivos redistribuíveis, você pode usar os pacotes redistribuíveis instalados pelo Visual Studio. Em versões de Visual Studio desde 2017, esses arquivos são nomeados vc_redist.arm64.exe, vc_redist.x64.exee vc_redist.x86.exe. Em Visual Studio 2015, 2017 e 2019, eles também estão disponíveis nos nomes vcredist_x86.exevcredist_x64.exee (somente 2015) vcredist_arm.exe.

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

Em Visual Studio 2022 e 2019, os arquivos de módulo de mesclagem fazem parte de um componente instalável opcional chamado MSMs redistribuíveis de versão> C++ < no Instalador do Visual Studio. Os módulos de mesclagem são instalados por padrão como parte de uma instalação do C++ no Visual Studio 2017 e Visual Studio 2015. Quando instalado no Visual Studio 2022, você encontrará os módulos de mesclagem redistribuíveis 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. Em ambos os Visual Studio 2019 e Visual Studio 2017, eles também são encontrados em %VCToolsRedistDir%MergeModules. Em Visual Studio 2015, eles 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++. Se você usar um, execute-o como um pré-requisito no sistema de destino antes de instalar seu 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 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 encontrada, 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 for executado usando o /quiet sinalizador, 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 posteriores, você pode evitar esse erro verificando o registro para descobrir se uma versão mais recente está instalada. O número de versão atual instalado é armazenado na HKEY_LOCAL_MACHINE\SOFTWARE[\Wow6432Node]\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|ARM} chave. O número da versão é 14.0 para Visual Studio 2015, 2017, 2019 e 2022 porque o redistribuível mais recente é compatível binário com versões anteriores até 2015. A chave é ARM, x86ou x64 dependendo das versões vcredist instaladas para a plataforma. (Você precisa verificar na Wow6432Node subchave somente se estiver usando o Regedit para exibir a versão do pacote x86 instalado em uma plataforma x64.) O número da versão é armazenado no valor Version da REG_SZ cadeia de caracteres e também no conjunto de Major, Minore RbldBldREG_DWORD valores. Para evitar um erro no momento da instalação, você deve ignorar a instalação do pacote redistribuível se a versão instalada atualmente for mais recente.

Instalar os módulos de mesclagem redistribuíveis

Importante

Módulos de mesclagem (.msmarquivos) para arquivos Pacote Redistribuível do Visual C++ são preteridos. Não recomendamos que você os use para implantação de aplicativo. Em vez disso, recomendamos a implantação central do pacote Pacote Redistribuível do Visual C++. A implantação central por um pacote redistribuível possibilita que a Microsoft execute arquivos de biblioteca de runtime de forma independente. Além disso, uma desinstalação do aplicativo não pode afetar outros aplicativos que também usam a implantação central. Quando você usa um pacote redistribuível para implantação central, não é responsável por acompanhar e manter as bibliotecas de runtime. Caso contrário, uma atualização para os arquivos de biblioteca de runtime exige que você atualize e reimplante o .msi instalador. Seu aplicativo pode estar vulnerável a bugs ou problemas de segurança até que você o faça.

Os módulos de mesclagem redistribuíveis devem ser incluídos no pacote Windows Installer (ou pacote de instalação semelhante) que você usa para implantar seu aplicativo. Para obter mais informações, consulte Redistribuição usando módulos de mesclagem. Para obter um exemplo, consulte Passo a passo: implantando um aplicativo 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 de aplicativo executável. Por motivos de manutenção, não recomendamos que você use esse local de instalação.

Possíveis erros de tempo de execução

Se Windows não conseguir encontrar uma das DLLs de biblioteca redistribuíveis exigidas pelo aplicativo, ela poderá exibir uma mensagem semelhante a: "Este aplicativo falhou ao iniciar porque o.dll de biblioteca não foi encontrado. Reinstalar o aplicativo pode corrigir esse problema."

Para resolver esse tipo de erro, verifique se o instalador do aplicativo é compilado corretamente. Verifique se as bibliotecas redistribuíveis são implantadas 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++.

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

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++.