Redistribuindo arquivos do Visual C++

Observação

Você está aqui porque está procurando um download de um dos arquivos de tempo de execução do Visual C++? Vá para a página de downloads mais recentes suportados do Visual C++ Redistributable .

Arquivos redistribuíveis e licenciamento

A distribuição do pacote Visual C++ Runtime Redistributable, módulos de mesclagem e binários individuais é limitada a usuários licenciados do Visual Studio e está sujeita a tais Termos de Licença.

Ao implantar um aplicativo, você também deve implantar os arquivos necessários para dar suporte a ele. 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 licenças relevantes do Visual Studio License Directory.

Para exibir a "lista REDIST" 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íveis para o Microsoft Visual Studio 2022

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

Localize os arquivos redistribuíveis

Para implantar arquivos redistribuíveis, você pode usar os pacotes redistribuíveis instalados pelo Visual Studio. Em versões do Visual Studio desde 2017, esses arquivos são nomeados vc_redist.arm64.exe, vc_redist.x64.exee vc_redist.x86.exe. No Visual Studio 2015, 2017 e 2019, eles também estão disponíveis sob os nomes vcredist_x86.exe, vcredist_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 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, eles também são encontrados em %VCToolsRedistDir%. No Visual Studio 2015, esses arquivos podem ser encontrados em %VCINSTALLDIR%redist\<locale>, onde <locale> é a localidade dos pacotes redistribuíveis.

No Visual Studio 2022 e 2019, os arquivos de módulo de mesclagem fazem parte de um componente opcional instalável denominado C++ <versão> MSMs Redistribuíveis no Visual Studio Installer. Os módulos de mesclagem são instalados por padrão como parte de uma instalação C++ no Visual Studio 2017 e Visual Studio 2015. Quando instalado no Visual Studio 2022, você encontrará os módulos de mesclagem redistribuíveis no %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 são encontrados em %VCToolsRedistDir%MergeModules. No 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 porque eles permitem a atualização automática das bibliotecas do Visual C++. Para obter um exemplo sobre como usar esses pacotes, consulte Passo a passo: Implantando um aplicativo Visual C++ usando o pacote redistribuível do Visual C++.

Cada pacote do Visual C++ Redistributable 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 instalação falhou. Se um pacote for executado usando o sinalizador /quiet, nenhuma mensagem de erro será exibida. Em ambos os casos, um erro é registrado pelo instalador da Microsoft e um resultado de erro é retornado para o chamador. No Visual Studio 2015 e posterior, você pode evitar esse erro verificando o registro para descobrir se uma versão mais recente está instalada. O número da versão instalada atual é armazenado na chave HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}. O número da versão é 14.0 para Visual Studio 2015, 2017, 2019 e 2022 porque o Redistributable mais recente é binário compatível com versões anteriores de 2015. A chave é arm64, x86ou x64 dependendo das versões vcredist instaladas para a plataforma. (Você precisa verificar na subchave Wow6432Node somente 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 valor da cadeia de caracteres REG_SZVersion e também no conjunto de valores Major, Minor, Blde RbldREG_DWORD. Para evitar um erro no momento da instalação, você deve ignorar a instalação do pacote Redistributable se a versão atualmente instalada for mais recente.

Opções de linha de comando para os pacotes Redistribuíveis

O Visual C++ Redistributable oferece suporte a várias opções de linha de comando. As opções /?, /hou /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 Redistributable no diretório atual. Por padrão, o Redistributable instala seu conteúdo e solicita ao usuário informações 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 interface do usuário ou requer qualquer interação do usuário. A opção /norestart suprime todas as tentativas de reinicialização. Por padrão, um arquivo de log é criado no %TEMP%. Você pode usar /log filename.txt para fazer logon em um arquivo específico.

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

vc_redist.x64.exe /install /passive /norestart

Instalar os módulos de mesclagem redistribuíveis

Importante

Módulos de mesclagem (arquivos.msm) para arquivos Visual C++ Redistributable foram preteridos. Não recomendamos que você os use para implantação de aplicativos. Em vez disso, recomendamos a implantação central do pacote Visual C++ Redistributable. A implantação central por um pacote Redistributable possibilita que a Microsoft atenda arquivos de biblioteca de tempo de execução de forma independente. Além disso, uma desinstalação do seu aplicativo não pode afetar outros aplicativos que também usam a implantação central. Ao usar um pacote Redistributable para implantação central, você não é responsável pelo controle e manutenção das bibliotecas de tempo de execução. Caso contrário, uma atualização das bibliotecas de execução exige que deva atualizar e reinstalar o seu instalador .msi. 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 do Windows Installer (ou pacote de instalação semelhante) que você usa para implantar seu aplicativo. Para obter mais informações, consulte Redistribuindo usando módulos de integração. 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 do aplicativo executável. Por motivos de manutenção, não recomendamos que você use este local de instalação.

Possíveis erros em tempo de execução

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

Para resolver esse tipo de erro, certifique-se de que o instalador do aplicativo compila corretamente. Verifique se as bibliotecas Redistribuíveis são implantadas corretamente no sistema de destino. Para obter mais informações, consulte Noções básicas sobre as dependências de um aplicativo Visual C++.

Artigos relacionados

Redistribuindo usando componentes de fusão
Descreve como usar módulos de mesclagem do Visual C++ Redistributable para instalar as bibliotecas de tempo de execução do Visual C++ como DLLs compartilhadas na pasta %windir%\system32\.

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

Redistribuindo a Biblioteca MFC
Descreve como redistribuir um aplicativo que usa MFC.

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

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

Implementando aplicações de ambiente de trabalho
Apresenta conceitos e tecnologias de implantação do Visual C++.