Como: instalar um assembly no cache de assembly global

O cache de assembly global armazena os assemblies que vários aplicativos compartilham. Instale um assembly no cache de assembly global com um dos seguintes componentes:

Importante

Você pode instalar apenas assemblies de nome forte no cache de assembly global. Para obter informações sobre como criar um assembly de nome forte, consulte Como: assinar um assembly com um nome forte.

Windows Installer

Windows Installer, o mecanismo de instalação do Windows, é a maneira recomendada de adicionar assemblies ao cache de assembly global. O Windows Installer fornece uma contagem de referências de assemblies no cache de assembly global e outros benefícios. Para criar um pacote do instalador do Windows Installer, use a extensão de conjunto de ferramentas WiX do Visual Studio 2017.

Ferramenta Cache de Assembly Global

Você pode usar o utilitário de Cache de Assembly Global do .NET (gacutil.exe) para adicionar assemblies ao cache de assembly global e exibir o conteúdo do cache de assembly global.

Observação

O gacutil.exe é indicado apenas para fins de desenvolvimento. Não o use para instalar assemblies de produção no cache de assembly global.

A sintaxe para usar o gacutil.exe para instalar um assembly no cache de assembly global é a seguinte:

gacutil -i <assembly name>

Nesse comando, <assembly name> é o nome do assembly a ser instalado no cache de assembly global.

Se gacutil.exe não estiver no caminho do sistema, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Visual Studio Developer.

O exemplo a seguir instala um assembly com o nome do arquivo hello.dll no cache de assembly global.

gacutil -i hello.dll

Observação

Nas versões anteriores do .NET Framework, a extensão do shell do Windows Shfusion.dll permitia instalar assemblies arrastando-os no Explorador de Arquivos. Começando no .NET Framework 4, a Shfusion.dll ficou obsoleta.

Confira também