Gérer les dossiers de packages globaux, les dossiers de cache et les dossiers temporaires

Chaque fois que vous installez, mettez à jour ou restaurez un package, NuGet gère les packages et les informations associées dans plusieurs dossiers extérieurs à la structure de votre projet :

Les dossiers global-packages et cache dispensent en général NuGet de télécharger des packages déjà présents sur l’ordinateur, ce qui améliore les performances d’installation, de mise à jour et de restauration. Avec PackageReference, le dossier global-packages évite également de conserver les packages téléchargés à l’intérieur des dossiers du projet, où ils pourraient être ajoutés par inadvertance au contrôle de code source, et réduit l’impact global de NuGet sur le stockage de l’ordinateur.

Pour récupérer un package, NuGet commence par regarder dans le dossier global-packages. Si la version exacte du package n’y figure pas, il vérifie toutes les sources de packages non HTTP. S’il ne trouve toujours pas le package, il le recherche dans http-cache, sauf si vous spécifiez --no-http-cache avec des commandes dotnet.exe ou -NoHttpCache avec des commandes nuget.exe. Si le package ne se trouve pas dans le cache ou que le cache n’est pas utilisé, NuGet le récupère sur HTTP.

Pour plus d’informations, consultez Processus d’installation d’un package.

Afficher l’emplacement des dossiers

Vous pouvez voir les emplacements avec la commande nuget locals :

# Display locals for all folders: global-packages, http cache, temp and plugins cache
nuget locals all -list

Sortie classique (Windows ; « user1 » est le nom d’utilisateur actuel) :

http-cache: C:\Users\user1\AppData\Local\NuGet\v3-cache
global-packages: C:\Users\user1\.nuget\packages\
temp: C:\Users\user1\AppData\Local\Temp\NuGetScratch
plugins-cache: C:\Users\user1\AppData\Local\NuGet\plugins-cache

(package-cache est utilisé dans NuGet 2.x et apparaît avec NuGet 3.5 et les versions antérieures.)

Vous pouvez aussi voir l’emplacement des dossiers avec la commande dotnet nuget locals :

dotnet nuget locals all --list

Sortie classique (Mac ; « user1 » est le nom d’utilisateur actuel) :

info : http-cache: /home/user1/.local/share/NuGet/v3-cache
info : global-packages: /home/user1/.nuget/packages/
info : temp: /tmp/NuGetScratch
info : plugins-cache: /home/user1/.local/share/NuGet/plugins-cache

Sortie classique (Linux ; « user1 » est le nom d’utilisateur actuel) :

info : http-cache: /home/user1/.local/share/NuGet/v3-cache
info : global-packages: /home/user1/.nuget/packages/
info : temp: /tmp/NuGetScratchuser1
info : plugins-cache: /home/user1/.local/share/NuGet/plugins-cache

Pour afficher l’emplacement d’un seul dossier, utilisez http-cache, global-packages, temp ou plugins-cache au lieu de all.

Effacer les dossiers locaux

Si vous rencontrez des problèmes d’installation de package ou que vous voulez vous assurer de l’installer à partir d’une galerie à distance, utilisez l’option locals --clear (dotnet.exe) ou locals -clear (nuget.exe), en spécifiant le dossier à effacer, ou all pour tous les effacer :

# Clear the 3.x+ cache (use either command)
dotnet nuget locals http-cache --clear
nuget locals http-cache -clear

# Clear the 2.x cache (NuGet CLI 3.5 and earlier only)
nuget locals packages-cache -clear

# Clear the global packages folder (use either command)
dotnet nuget locals global-packages --clear
nuget locals global-packages -clear

# Clear the temporary cache (use either command)
dotnet nuget locals temp --clear
nuget locals temp -clear

# Clear the plugins cache (use either command)
dotnet nuget locals plugins-cache --clear
nuget locals plugins-cache -clear

# Clear all caches (use either command)
dotnet nuget locals all --clear
nuget locals all -clear

Les packages utilisés par des projets actuellement ouverts dans Visual Studio ne sont pas effacés du dossier global-packages.

À compter de Visual Studio 2017, utilisez la commande de menu Outils > Gestionnaire de package NuGet > Paramètres du Gestionnaire de package, puis sélectionnez Effacer tous les caches NuGet. À l’heure actuelle, la gestion du cache n’est pas disponible avec la console du Gestionnaire de package. Dans Visual Studio 2015, utilisez plutôt les commandes CLI.

Résolution des erreurs

Les erreurs suivantes risquent de se produire avec nuget locals ou dotnet nuget locals :

• Erreur : Le processus ne peut pas accéder au <package> de fichiers, car il est utilisé par un autre processus ou Échec de l’effacement des ressources locales : Suppression d’un ou plusieurs fichiers impossible

  Un ou plusieurs fichiers du dossier sont en cours d’utilisation par un autre processus ; par exemple, un projet Visual Studio faisant référence à des packages du dossier global-packages est ouvert. Fermez ces processus, puis réessayez.

• Erreur : Accès au <chemin> refusé ou L’annuaire n’est pas vide

  Vous n’avez pas l’autorisation de supprimer des fichiers du cache. Modifiez les autorisations du dossier, si possible, puis réessayez. Sinon, contactez votre administrateur système.

• Erreur : Le chemin d’accès ou le nom de fichier spécifié est trop long. Le nom du fichier complet doit être inférieur à 260 caractères et le nom du répertoire à 248 caractères.

  Raccourcissez le nom des dossiers, puis réessayez.