Créer et publier son propre package Nuget avec Nuget Package Explorer

Dans mon précédent billet de blog, j’avais décrit comment utiliser l’utilitaire Nuget.exe pour générer le fichier de spécification et le fichier de package en ligne de commandes, comment éditer le fichier XML et afin comment publier son propre package Nuget (pour mémoire, Nuget est un gestionnaire de package .NET open source).

Cependant, l’utilisation de l’invite de commandes et l’édition du fichier XML de spécification à la main peuvent s’avérer assez inconfortables pour certaines personnes. C’est pourquoi je vais vous présenter dans ce billet de blog une alternative à Nuget.exe, permettant à l’utilisateur de bénéficier du confort d’une interface graphique.

Il s’agit de l’utilitaire Nuget Package Explorer, qui met à la disposition de l’utilisateur une interface lui permettant de créer, éditer son fichier de spécification et publier son Forfait Nuget avec le minimum d’effort.

L’outil est téléchargeable sur cette page.

Après son installation, vous aurez affiché sur votre écran l’interface utilisateur suivante :

Cliquez sur la ligne « Create a new package », pour créer votre package Nuget.

Le package est créé avec comme Meta donnée par défaut, des informations reprises directement depuis votre système.

Cliquez sur le menu « Edit », ensuite sur « Edit Package Metadata » pour accéder à la fenêtre d’édition du package.

L’interface suivante s’affiche avec un formulaire qui vous permettra de renseigner les informations sur votre package :

Je ne reviendrais pas sur la description de ces informations. Pour plus de détails, lisez mon précédent billet de blog sur Nuget.

Comme vous pouvez le constater, les informations importantes qu’il faut renseigner sont en gras.

Lorsque vous avez achevé avec cette étape, validez votre saisie en cliquant sur le bouton OK.

Maintenant, nous allons définir le contenu de notre package Nuget.
Pour cela, nous allons cliquer sur le menu « Content » ensuite sur « Add ».

Dans le sous-menu qui s’affiche, nous allons dans un premier temps définir les dossiers que nous allons utiliser.

Nuget reconnait par défaut les dossiers : Content (pour les fichiers qui seront copiés à la racine de l’application lors de l’installation du package), Lib (pour les DLL) et Tools (pour les scripts PowerShell associés au package).

Pour notre cas, nous allons créer le dossier Lib pour les librairies constituant notre package Nuget.

En faisant un clic droit sur ce dossier, nous avons la possibilité de définir plusieurs sous dossiers en fonction des versions des plateformes de développement que le package supporte (ASP.NET, Silverlight, Windows Phone, etc.).

Supposons que notre DLL cible la version 4.0 du Framework .NET. Nous allons donc créer un dossier net40. Nous allons ensuite faire un clic droit sur ce dossier et dans le menu contextuel qui s’affiche, nous allons cliquer sur « Add Existing File… ».

Nous allons ensuite rechercher notre fichier et l’ajouter comme contenu de notre package.

Nous pouvons également par un simple geste de glisser/déposer sur l’espace de travail « Package contents », ajouter un contenu à notre package.

Nous devons maintenant enregistrer nos informations en utilisant le raccourci clavier « Ctrl + S » ou le menu Fichier/Enregistrer.

Et c’est tout ;). Il ne nous reste plus qu’à publier notre package.

Dans mon article précédent, j’avais énoncé deux méthodes de publication d’un dépôt Nuget, et j’avais présenté uniquement l’une des deux méthodes.

Nous verrons donc la seconde méthode qui consiste en la publication de notre dépôt Nuget sur la galerie officielle Nuget.

Pour cela, nous allons cliquer sur la commande « Publish » du menu fichier.

La fenêtre qui s’affiche nous demande de renseigner notre clé de publication.

Vous pouvez obtenir cette information en vous inscrivant sur le site de la « NuGet Gallery » à partir de ce lien.

Et voilà! nous venons de créer et publier notre premier package Nuget sur la galerie officielle du projet.

Votre compte va vous permettre de gérer (édition, suppression, etc.) vos différents dépôts sur la galerie Nuget.

Si vous ne souhaitez pas publier votre dépôt sur la galerie officielle, exporter simplement celui-ci en utilisant la commande Export du menu Fichier, et copier le dossier qui sera généré à l’emplacement de votre choix.

Pour l’utilisation de votre dépôt dans le gestionnaire de packages Nuget au sein de Visual Studio, referez-vous à mon précédent billet de blog.

Laisser un commentaire