Notes de publication de NuGet 1.4

Notes de publication de NuGet 1.3 | Notes de publication de NuGet 1.5

NuGet 1.4 a été publié le 17 juin 2011.

Fonctionnalités

améliorations apportées aux Update-Package

NuGet 1.4 introduit de nombreuses améliorations apportées à la commande Update-Package, ce qui facilite la conservation des packages à la même version sur plusieurs projets d’une solution. Par exemple, lors de la mise à niveau d’un package vers la dernière version, il est très courant de vouloir que tous les projets avec ce package soient mis à jour vers la même véritable.

La Update-Package commande facilite désormais les opérations suivantes :

Mettre à jour tous les packages dans un seul projet

Update-Package -Project MvcApplication1

Mettre à jour un package dans tous les projets

Update-Package PackageId

Mettre à jour tous les packages dans tous les projets

Update-Package

Effectuer une mise à jour « sécurisée » sur tous les packages

L’indicateur -Safe limite les mises à niveau aux versions uniquement avec le même composant version principale et mineure. Par exemple, si la version 1.0.0 d’un package est installée et que les versions 1.0.1, 1.0.2 et 1.1 sont disponibles dans le flux, l’indicateur -Safe met à jour le package sur 1.0.2. La mise à niveau sans l’indicateur -Safe met à niveau le package vers la dernière version 1.1.

Update-Package -Safe

Gestion des packages au niveau de la solution

Avant NuGet 1.4, l’installation d’un package dans plusieurs projets était fastidieuse à l’aide de la boîte de dialogue. Il a fallu lancer la boîte de dialogue une fois par projet.

NuGet 1.4 ajoute la prise en charge de l’installation/de la désinstallation/mise à jour des packages dans plusieurs projets en même temps. Il vous suffit de cliquer avec le bouton droit sur la solution, puis de sélectionner le menu Gérer les packages NuGet.

Notez que dans la barre de titre de la boîte de dialogue, le nom de la solution s’affiche, et non le nom d’un projet. Les opérations de package fournissent une liste de cases à cocher avec la liste des projets auxquels l’opération doit s'appliquer désormais.

Pour plus d’informations, consultez la rubrique sur la gestion des packages pour la solution.

Limitation des mises à niveau vers les versions autorisées

Par défaut, lors de l’exécution de la Update-Package commande sur un package (ou la mise à jour du package à l’aide de la boîte de dialogue), elle est mise à jour vers la dernière version du flux. Avec la nouvelle prise en charge de la mise à jour de tous les packages, il peut arriver que vous souhaitiez verrouiller un package sur une plage de versions spécifique. Par exemple, vous savez peut-être à l’avance que votre application fonctionne uniquement avec la version 2.* d’un package, mais pas 3.0 et versions ultérieures. Pour empêcher la mise à jour accidentelle du package vers 3, NuGet 1.4 ajoute la prise en charge de la limitation de la plage de versions vers laquelle les packages peuvent être mis à niveau en modifiant manuellement le packages.config fichier à l’aide du nouvel allowedVersions attribut.

Par exemple, l’exemple suivant montre comment verrouiller le SomePackage package de la plage de versions 2.0 - 3.0 (exclusive). L'attribut allowedVersions accepte des valeurs selon le format de plage de versions.

<?xml version="1.0" encoding="utf-8"?>
<packages>
    <package id="SomePackage" version="2.1.0" allowedVersions="[2.0, 3.0)" />
</packages>

Notez que dans la version 1.4, le verrouillage d’un package sur une plage de versions spécifique doit être modifié manuellement. Dans NuGet 1.5, nous prévoyons d’ajouter la prise en charge du placement de cette plage via la Install-Package commande.

Visualiseur de package

Le nouveau visualiseur de package, lancé via l’option de menu Tools ->Library Package Manager ->Package Visualizer , vous permet de visualiser facilement tous les projets et leurs dépendances de package au sein d’une solution.

Remarque importante : Cette fonctionnalité tire parti de la prise en charge DGML dans Visual Studio. La création de la visualisation n’est prise en charge que dans Visual Studio Ultimate. L’affichage d’un diagramme DGML n’est pris en charge que dans Visual Studio Premium ou version ultérieure.

Vérification automatique de la mise à jour pour la boîte de dialogue NuGet

Certaines versions de NuGet introduisent de nouvelles fonctionnalités exprimées via le .nuspec fichier qui ne sont pas comprises par les versions antérieures de la boîte de dialogue NuGet. Voici un exemple d’introduction dans NuGet 1.4 pour spécifier des assemblys de framework. En raison de cela, il est important d’utiliser la dernière version de NuGet pour vous assurer que vous pouvez utiliser des packages tirant parti des dernières fonctionnalités. Pour rendre les mises à jour de NuGet plus visibles, la boîte de dialogue NuGet contient la logique à mettre en surbrillance lorsqu’une version plus récente est disponible.

Remarque : la vérification est effectuée uniquement si l’onglet En ligne a été sélectionné dans la session active.

Pour désactiver la vérification automatique des mises à jour, accédez à la boîte de dialogue Paramètres NuGet et décochez Vérification automatique des mises à jour.

Cette fonctionnalité a été ajoutée dans NuGet 1.3, mais elle n’est pas visible, bien sûr, tant qu’une mise à jour vers la version 1.3, telle que NuGet 1.4, n’a pas été mise à disposition.

Améliorations de la boîte de dialogue du gestionnaire de paquet

• Noms de menus améliorés : les options de menu permettant de lancer la boîte de dialogue ont été renommées pour plus de clarté. L’option de menu est désormais Gérer les packages NuGet.
• Le volet Détails affiche la date de mise à jour la plus récente : la boîte de dialogue NuGet affiche la date de la dernière mise à jour dans le volet détails d’un package lorsque l’onglet Mise à jour ou en ligne est sélectionné.
• Liste des balises affichées : la boîte de dialogue Nuget affiche les balises.

Améliorations de PowerShell

• Scripts PowerShell signés : NuGet inclut des scripts PowerShell signés permettant l’utilisation dans des environnements plus restrictifs.
• Prise en charge de l’invite : la console du Gestionnaire de package prend désormais en charge l'invite via les commandes $host.ui.Prompt et $host.ui.PromptForChoice.
• Noms des sources de package : la fourniture du nom d’une source de package est prise en charge lors de la spécification d’une source de package à l’aide de l’indicateur -Source .

améliorations apportées à la ligne de commande nuget.exe

• Commandes personnalisées NuGet : nuget.exe est extensible via des commandes personnalisées à l’aide de MEF.
• Simplification du flux de travail pour la création de packages de symboles : l’indicateur -Symbols peut être appliqué à une structure de dossiers basée sur une convention normale créant un package de symboles en incluant uniquement la source et .pdb les fichiers dans le dossier.
• Spécification de plusieurs sources : la NuGet install commande prend en charge la spécification de plusieurs sources à l’aide de points-virgules comme délimiteur ou en spécifiant -Source plusieurs fois.
• Prise en charge de l’authentification proxy : NuGet 1.4 ajoute la prise en charge de la demande de données d’identification utilisateur lors de l’utilisation de NuGet derrière un proxy qui requiert une authentification.
• nuget.exe Modification importante de mise à jour : l’indicateur -Self est désormais requis pour mettre à jour nuget.exe. nuget.exe Update prend désormais un chemin d’accès au packages.config fichier et tente de mettre à jour les packages. Notez que cette mise à jour est limitée car elle n’est pas : ** Mettre à jour, ajouter, supprimer du contenu dans le fichier projet. ** Exécutez des scripts PowerShell dans le package.

Prise en charge du serveur NuGet pour l’envoi de paquets à l’aide de nuget.exe

NuGet inclut un moyen simple d’héberger un référentiel NuGet basé sur le web léger via le NuGet.Server package NuGet. Avec NuGet 1.4, le serveur léger prend en charge l’envoi (push) et la suppression de packages à l’aide de nuget.exe. La dernière version de NuGet.Server ajoute un nouveau appSetting, nommé apiKey. Lorsque la clé est omise ou vide, l’envoi de packages au flux est désactivé. La définition de l’apiKey sur une valeur (idéalement un mot de passe fort) permet d’envoyer (push) des packages à l’aide de nuget.exe.

<appSettings>
    <!-- Set the value here to allow people to push/delete packages from the server.
            NOTE: This is a shared key (password) for all users. -->
    <add key="apiKey" value="" />
</appSettings>

Prise en charge des outils Windows Phone édition Mango

NuGet est désormais pris en charge dans la version candidate de windows Phone Tools pour Mango. Actuellement, les outils Windows Phone ne prennent pas en charge le gestionnaire d’extensions Visual Studio, donc pour installer NuGet pour les outils Windows Phone, vous devrez peut-être télécharger et exécuter manuellement le fichier VSIX.

Pour désinstaller NuGet pour les outils Windows Phone, exécutez la commande suivante.

vsixinstaller.exe /uninstall:NuPackToolsVsix.Microsoft.67e54e40-0ae3-42c5-a949-fddf5739e7a5

Les correctifs de bogues

NuGet 1.4 avait un total de 88 éléments de travail corrigés. 71 de ceux-ci ont été marqués comme des bogues.

Pour obtenir la liste complète des éléments de travail corrigés dans NuGet 1.4, consultez le [NuGet Issue Tracker for this release](http://nuget.codeplex.com/workitem/list/advanced?keyword=&status=All&type=All&priority=All&release=NuGet%201.4&assignedTo=All&component=All&sortField=LastUpdatedDate&sortDirection=Descending&page=0)fichier .

Correctifs de bogues qui méritent d’être notés

• [Issue 603](http://nuget.codeplex.com/workitem/603): les dépendances de package entre différents référentiels sont résolues correctement lors de la spécification d’une source de package spécifique.
• [Issue 1036](http://nuget.codeplex.com/workitem/1036): l’ajout NuGet Pack SomeProject.csproj à un événement post-build n’entraîne plus une boucle infinie.
• [Issue 961](http://nuget.codeplex.com/workitem/961): -Source l’indicateur prend en charge les chemins relatifs.

Mise à jour de NuGet 1.4

Peu après la publication de NuGet 1.4, nous avons trouvé quelques problèmes importants à résoudre. Le numéro de version spécifique de cette mise à jour vers la version 1.4 est 1.4.20615.9020.

Les correctifs de bogues

• [Issue 1220](http://nuget.codeplex.com/workitem/1220): Update-Package ne s’exécute install.ps1/uninstall.ps1 pas dans tous les projets lorsqu’il existe plusieurs projets
• [Issue 1156](http://nuget.codeplex.com/workitem/1156): Package Manager Consol bloqué sur W2K3/XP (lorsque PowerShell 2 n’est pas installé)