Le Global Assembly Cache (GAC) est un ensemble de fichiers EXE (exécutables) et DLL (bibliothèques) utilisés par les applications .Net Framework comme ShareGate Migrate.
Le GAC fait partie de votre système d'exploitation Windows.
Symptômes
Vous obtenez l'avertissement suivant dans 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.
Vous pouvez également obtenir une exception TypeLoadException lorsque vous exécutez Import-Module Sharegate dans Windows PowerShell 5.1, par exemple :
Method 'Handle' in type 'Workleap.Extensions.MediatR.StreamRequestTracingBehavior`2' from assembly 'Workleap.Extensions.MediatR, Version=1.5.7.0' does not have an implementation.
Détails
ShareGate Migrate est livré avec plusieurs DLL. Elles ne sont pas installées dans votre GAC.
Vous obtenez généralement cet avertissement lorsqu'une autre application a installé l'une de ces DLL directement dans votre GAC.
Lorsque la DLL est présente dans le GAC, votre système d'exploitation Windows accorde la priorité à cette version de la DLL plutôt qu'à celle fournie avec l'application.
Si la version de la DLL dans le GAC est désuète ou diffère de celle fournie avec l'application, certaines fonctionnalités peuvent ne plus être disponibles, voire l'application peut cesser de fonctionner.
Parmi les DLL les plus souvent touchées, on trouve Microsoft.Sharepoint.Client.dll et Newtonsoft.Json.dll. Elles sont généralement installées dans votre GAC par un outil de développement.
Remarque : Même si ces DLL sont les plus souvent touchées, certaines applications pourraient installer dans votre GAC d'autres DLL qui affectent ShareGate Migrate.
Solution
Si vous pouvez désinstaller l'application qui a installé la DLL dans votre GAC, cela devrait résoudre le problème.
Cependant, il n'est pas facile de déterminer quelle DLL est touchée et quelle application l'a installée dans le GAC.
Faire un test dans la fenêtre PowerShell ouverte depuis ShareGate
Si vous obtenez l'exception TypeLoadException avec Import-Module Sharegate, ouvrez PowerShell depuis ShareGate Migrate à l'aide du bouton situé dans le coin inférieur gauche. Cette fenêtre charge uniquement le module ShareGate, ce qui vous permet de vérifier si un autre module PowerShell cause l'erreur. Si l'erreur se produit encore, un conflit de DLL sur votre ordinateur en est probablement la cause.
Installer ShareGate Migrate sur un autre ordinateur
Essayez d'installer ShareGate Migrate sur un autre ordinateur où les mêmes applications ou outils de développement ne sont pas installés. C'est la meilleure solution pour une résolution plus rapide.
Si vous ne pouvez pas installer l'application sur un autre ordinateur
Si vous êtes limité à votre ordinateur actuel et que vous ne pouvez pas déterminer quelle application a installé la DLL dans le GAC, notre équipe de soutien peut vous aider à déterminer quelle DLL est touchée.
Cette information peut aider à trouver l'application responsable du problème, ou il peut être possible de mettre à jour cette DLL pour le résoudre.
Remarque : Il est très important de comprendre que, même si le soutien peut vous aider à déterminer quelle DLL est touchée, dans bien des cas, il ne pourra pas découvrir quelle application l'a installée dans votre GAC. Nous ne recommandons pas de supprimer des DLL de votre GAC, surtout si vous travaillez sur un serveur. Si vous supprimez une DLL, d'autres applications pourraient devenir inutilisables.
Cet article a été traduit à l'aide de l'intelligence artificielle. En cas de doute, référez-vous à la version originale en anglais.
