La Global Assembly Cache (GAC) es un grupo de archivos EXE (ejecutables) y DLL (bibliotecas) que usan las aplicaciones de .Net Framework, como ShareGate Migrate.
La GAC forma parte de tu sistema operativo Windows.
Síntomas
Recibes la siguiente advertencia en ShareGate Migrate:
Another version of a DLL in your Global Assembly Cache (GAC) is prioritized over a DLL packaged and used by ShareGate Migrate. This might prevent some features from working as expected.
También puedes recibir una excepción TypeLoadException al ejecutar Import-Module Sharegate en Windows PowerShell 5.1, como esta:
Method 'Handle' in type 'Workleap.Extensions.MediatR.StreamRequestTracingBehavior`2' from assembly 'Workleap.Extensions.MediatR, Version=1.5.7.0' does not have an implementation.
Detalles
ShareGate Migrate incluye varias DLL en su paquete. No se instalan en tu GAC.
Normalmente recibes esta advertencia cuando otra aplicación instaló una de estas DLL directamente en tu GAC.
Cuando la DLL está en la GAC, tu sistema operativo Windows da prioridad a esa versión de la DLL en lugar de a la que se incluye con la aplicación.
Si la versión de la DLL en la GAC está desactualizada o es distinta de la que se incluye con la aplicación, es posible que se pierdan algunas funciones o incluso que la aplicación deje de funcionar.
Algunas de las DLL afectadas con más frecuencia son Microsoft.Sharepoint.Client.dll y Newtonsoft.Json.dll. Normalmente las instala en tu GAC una herramienta de desarrollo.
Nota: Aunque estas son las DLL afectadas con más frecuencia, algunas aplicaciones podrían instalar en tu GAC otras DLL que afecten a ShareGate Migrate.
Solución
Si puedes desinstalar la aplicación que instaló la DLL en tu GAC, eso debería resolver el problema.
Sin embargo, no es fácil determinar qué DLL está afectada ni qué aplicación la instaló en la GAC.
Prueba en la ventana de PowerShell que se abre desde ShareGate
Si recibes la excepción TypeLoadException con Import-Module Sharegate, abre PowerShell desde ShareGate Migrate con el botón de la esquina inferior izquierda. Esa ventana carga solo el módulo de ShareGate, así que te permite ver si otro módulo de PowerShell causa el error. Si el error sigue apareciendo ahí, lo más probable es que la causa sea un conflicto de DLL en tu máquina.
Instala ShareGate Migrate en otra máquina
Intenta instalar ShareGate Migrate en una máquina distinta que no tenga instaladas las mismas aplicaciones ni herramientas de desarrollo. Esta es la mejor solución para resolverlo más rápido.
Si no puedes instalar la aplicación en otra máquina
Si estás limitado a tu máquina actual y no puedes determinar qué aplicación instaló la DLL en la GAC, nuestro equipo de soporte puede ayudarte a determinar qué DLL está afectada.
Esta información puede ayudar a encontrar la aplicación responsable del problema, o tal vez sea posible actualizar esa DLL para resolverlo.
Nota: Es muy importante entender que, aunque el equipo de soporte puede ayudarte a determinar qué DLL está afectada, en muchos casos no podrá descubrir qué aplicación es responsable de instalarla en tu GAC. No recomendamos eliminar DLL de tu GAC, sobre todo si trabajas en un servidor. Si eliminas una DLL, otras aplicaciones pueden dejar de funcionar.
Este artículo fue traducido con inteligencia artificial. En caso de duda, consulta la versión original en inglés.
