Compartilhar via

Redistribuir componentes usando módulos de mesclagem

Importante

No Visual Studio 2019 e posterior, os módulos de mesclagem para arquivos redistribuíveis do Visual C++ são preteridos. Não recomendamos que você os use para implantação de aplicativos. Windows Update não pode atualizar arquivos redistribuíveis instalados usando módulos de mesclagem porque o mecanismo de detecção depende de saber detalhes do pacote de instalação.

Os pacotes redistribuíveis do Visual C++ são conhecidos para cada versão, mas os pacotes que usam módulos de mesclagem são gerados pelo usuário. A Microsoft não tem como saber os detalhes dos pacotes gerados pelo usuário. Em vez disso, recomendamos que você use a implantação central do pacote redistribuível do Visual C++. A implantação central instala os arquivos redistribuíveis na pasta Windows %SYSTEMROOT%\system32\ para uso por todos os aplicativos e usuários. A implantação central por um pacote redistribuível possibilita que a Microsoft execute arquivos de biblioteca de runtime de forma independente. Uma desinstalação do aplicativo não pode interromper 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 atualizar as bibliotecas de runtime como parte da manutenção do aplicativo. O serviço Microsoft Update atualiza essas bibliotecas para você. Caso contrário, uma atualização dos arquivos da biblioteca de runtime exigirá a atualização e reimplantação do instalador . O aplicativo poderá ficar vulnerável a bugs ou a problemas de segurança até você fazer isso.

Visual Studio inclui módulos merge (arquivos .msm) para cada componente do Visual C++ licenciado para redistribuição com um aplicativo. Há versões separadas dos módulos de mesclagem para cada plataforma de destino. Quando um módulo de mesclagem é compilado em um arquivo de instalação do Windows Installer, ele habilita a implantação de arquivos redistribuíveis do Visual C++ para essa plataforma específica. Você não pode incluir módulos de mesclagem para versões diferentes da mesma DLL (biblioteca de vínculo dinâmico) em um instalador. No arquivo de configuração do instalador, especifique que os módulos de mesclagem são pré-requisitos para seu aplicativo.

Você pode usar módulos de mesclagem para implantação central ou implantação local. Os usuários não podem instalar arquivos implantados centralmente, a menos que tenham direitos de administrador. A implantação local pode permitir que um não administrador instale e execute seu aplicativo, mas ao custo da capacidade de serviço independente.

O serviço de instalação relatará um erro se você tentar a implantação central de módulos de mesclagem mais antigos em bibliotecas existentes mais recentes. Você deve escrever a configuração do instalador para lidar com essa falha normalmente e não exibir uma mensagem de erro. Seu código ainda pode ser implantado e executado com êxito, apesar dessa falha. Para obter mais informações, consulte C++ compatibilidade binária entre Visual Studio versões.

Se você implantar seu código apenas como instalador , recomendamos que você não inclua os módulos de mesclagem no instalador. Em vez disso, relate uma falha ao usuário quando as bibliotecas redistribuíveis necessárias não forem encontradas. Na caixa de diálogo de falha, inclua instruções sobre como localizar e instalar o pacote redistribuível mais recente. Para obter mais informações e links para pacotes redistribuíveis, consulte os downloads mais recentes do Visual C++.

Os pacotes redistribuíveis mais recentes e os módulos de mesclagem são compatíveis com o código criado usando Visual Studio 2015 e posteriores. O código criado por versões de Visual Studio antes de 2015 exige um pacote redistribuível separado.

Quando usar módulos de mesclagem

Os módulos de mesclagem são apropriados apenas em circunstâncias limitadas:

  • Você não pode instalar ou exigir um pacote redistribuível separado por motivos de política.
  • Seu código requer uma versão específica das bibliotecas que mantém compatibilidade com os bugs.
  • Seu código tem como destino apenas uma plataforma e você não tem dependências em mais de uma versão das DLLs.
  • Você pretende atender seu código implantado regularmente para que as bibliotecas permaneçam atualizadas.

Ao usar módulos de mesclagem, você deve acompanhar e fazer manutenção regular do seu aplicativo com atualizações de biblioteca. Caso contrário, você acabará forçando seus clientes a escolher entre executar seu código ou permanecer seguros.

Onde localizar arquivos de módulo de mesclagem

No Visual Studio 2022 e 2019, os arquivos de módulo de mesclagem fazem parte de um componente instalável opcional chamado C++ <version> Redistribuível MSM 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 os módulos de mesclagem são instalados no Visual Studio 2022, você pode encontrar os módulos de mesclagem redistribuíveis do Visual C++ em %VCINSTALLDIR%Redist\MSVC\v143\MergeModules.

Na versão mais recente do Visual Studio 2019, os módulos de mesclagem estão em %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. Em 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. Para obter mais informações e um link para uma lista de módulos de mesclagem redistribuíveis, consulte Redistribuir arquivos do Visual C++.

Conteúdo relacionado

  • Redistribuir arquivos do Visual C++
  • Last updated on