Redistribuir ficheiros Visual C++

Arquivos redistribuíveis e licenciamento

A distribuição do pacote Visual C++ Runtime Redistributable, módulos de fusão e binários individuais está limitada a utilizadores licenciados do Visual Studio e está sujeita aos Termos de Licença de Software Microsoft.

Ao implantar um aplicativo, você também deve implantar os arquivos necessários para dar suporte a ele. Se a Microsoft fornecer algum destes ficheiros, verifique se tem permissão para os redistribuir. Podes encontrar um link para os termos da licença do Visual Studio no IDE. No diálogo Sobre a Microsoft Visual Studio, selecione o link Termos de Licença. Também pode descarregar os Termos e Licenças de Software Microsoft relevantes do Visual Studio License Directory.

Para mais informações sobre ficheiros redistribuíveis, veja Determinar quais as bibliotecas de ligação dinâmica (DLLs) a redistribuir e Exemplos de implementação.

Localize os arquivos redistribuíveis

Para implementar ficheiros redistribuíveis, pode usar os pacotes redistribuíveis instalados pelo Visual Studio. Nas versões de Visual Studio desde 2017, estes ficheiros são nomeados vc_redist.arm64.exe, vc_redist.x64.exe e vc_redist.x86.exe. Em Visual Studio 2015, 2017 e 2019, também estão disponíveis sob os nomes vcredist_x86.exe, vcredist_x64.exe e (apenas 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. Em Visual Studio de 2022, os ficheiros redistribuíveis encontram-se na pasta %VCINSTALLDIR%Redist\MSVC\v143. Na versão mais recente de Visual Studio 2019, pode encontrar os ficheiros redistribuíveis na pasta %VCINSTALLDIR%Redist\MSVC\v142. Tanto Visual Studio 2017 como Visual Studio 2019, os ficheiros também se encontram em %VCToolsRedistDir%. Em Visual Studio de 2015, pode encontrar estes ficheiros em %VCINSTALLDIR%redist\<locale>, onde <locale> é a localização dos pacotes redistribuíveis.

Em Visual Studio 2022 e 2019, os ficheiros de módulos de fusão fazem parte de um componente opcional instalável chamado Visual C++ <version> módulos de fusão redistribuíveis no Visual Studio Instalador. Os módulos de fusão são instalados por defeito como parte de uma instalação em C++ no Visual Studio 2017 e no Visual Studio 2015. Quando estiverem instalados em Visual Studio 2022, podes encontrar os módulos de fusão redistribuíveis em %VCINSTALLDIR%Redist\MSVC\v143\MergeModules.

Na versão mais recente de Visual Studio 2019, os módulos de fusão redistribuíveis encontram-se em %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. Tanto Visual Studio 2019 como Visual Studio 2017, também se encontram em %VCToolsRedistDir%MergeModules. Em Visual Studio 2015, são encontradas em Program Files [(x86)]\Common Files\Merge Modules.

Instalar os pacotes redistribuíveis

Os pacotes Visual C++ Redistributable instalam e registam todas as bibliotecas 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 um exemplo que mostra como usar estes pacotes, veja Guia: Deploye uma aplicação Visual C++ usando o pacote Visual C++ Redistributable.

Cada pacote do Visual C++ Redistributable verifica a existência de uma versão mais recente no computador. Se for encontrada uma versão mais recente, o pacote não está instalado. No Visual Studio 2015 ou posterior, os pacotes redistribuíveis exibem uma mensagem de erro a indicar que a configuração falhou. Se um pacote usar a flag para executar, não aparece nenhuma mensagem de erro. Em qualquer dos casos, o instalador da Microsoft regista o erro e um resultado de erro é devolvido ao chamador.

No Visual Studio 2015 e posteriores, pode evitar este erro verificando o registo para verificar se existe uma versão mais recente instalada. O número da versão instalada atual é armazenado na chave .

O número de versão é 14.0 para Visual Studio 2015, 2017, 2019 e 2022 porque o mais recente Redistributable é compatível binariamente com versões anteriores desde 2015. A chave é , , ou dependendo das versões instaladas para a plataforma. (Só precisa de verificar na subchave se usar o Regedit para ver a versão do pacote x86 instalado numa plataforma x64.)

O número de versão é armazenado no valor da string e também no conjunto dos valores , , , e . Para evitar um erro no momento da instalação, deve saltar a instalação do pacote redistributable se a versão atualmente instalada for mais recente.

Opções de linha de comandos para os pacotes redistribuíveis

O Visual C++ Redistributable oferece suporte a várias opções de linha de comando. As opções , , ou exibem um diálogo que lista as opções disponíveis. Podes especificar para instalar, reparar ou desinstalar o Redistributable. A opção 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. Podes especificar a opção, que mostra o progresso mas não requer interação do utilizador. Também pode especificar uma opção, que não exibe uma interface de utilizador nem exija qualquer interação do utilizador. A opção suprime todas as tentativas de reinicialização. Por padrão, um arquivo de log é criado no . Você pode usar para fazer logon em um arquivo específico.

Este comando de exemplo instala o x64 Redistributable. Mostra o progresso da instalação, mas não requer interação do utilizador nem reinício:

vc_redist.x64.exe /install /passive /norestart

Instalar os módulos de mesclagem redistribuíveis

Os módulos de fusão redistribuíveis devem estar incluídos no pacote Windows Installer (ou pacote de instalação semelhante) que utiliza para implementar a sua aplicação. Para mais informações, consulte Redistribuir usando módulos de fusão. Para um exemplo, veja Walkthrough: Deploye uma aplicação Visual C++ usando um projeto de configuraçã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 razões de manutenção, não recomendamos que utilize este local de instalação.

Potenciais erros em tempo de execução

Se Windows não conseguir encontrar uma das DLLs Redistribuíveis exigidas pela sua aplicação, pode mostrar uma mensagem semelhante a esta: "Esta aplicação falhou ao iniciar porque library.dll não foi encontrada. Reinstalar o aplicativo pode corrigir esse problema."

Para resolver este tipo de erro, certifique-se de que o instalador da sua aplicação compila corretamente. Verifique se as bibliotecas redistribuíveis são implementadas corretamente no sistema de destino. Para mais informações, veja Compreender as dependências de uma aplicação Visual C++.

Conteúdo relacionado

• Redistribuir usando módulos de fusão descreve como usar os módulos de fusão do Visual C++ Redistributable para instalar as bibliotecas de tempo de execução do Visual C++ como DLLs partilhadas na pasta de destino.
• "Redistribuir os controlos ActiveX do Visual C++ descreve como redistribuir uma aplicação que utilize controlos ActiveX."
• Redistribuir a Biblioteca Microsoft Foundation Class (MFC) descreve como redistribuir uma aplicação que utiliza MFC.
• Redistribuir uma Biblioteca Ativa de Modelos (ATL) descreve como redistribuir uma aplicação que utiliza um ATL. No Visual Studio 2012 e posteriores, não é necessária nenhuma biblioteca ATL.
• Exemplos de implementação ligam a exemplos que demonstram como implementar aplicações Visual C++.
• Deploy desktop applications introduz conceitos e tecnologias de implementação em Visual C++.
• Os downloads mais recentes suportados do Visual C++ Redistributable ligam para os downloads mais recentes suportados do Visual C++ Redistributable.