Flux de travail de création de package

La création d’un package commence par le code compilé (généralement les assemblys .NET) que vous souhaitez empaqueter et partager avec d’autres personnes, via la galerie de nuget.org publique ou une galerie privée au sein de votre organisation. Le package peut également inclure des fichiers supplémentaires tels qu’un fichier lisez-moi affiché lors de l’installation du package et peut inclure des transformations sur certains fichiers de projet.

Un package peut également servir à extraire uniquement un nombre quelconque d’autres dépendances, sans contenir de code propre. Un tel package est un moyen pratique de fournir un SDK composé de plusieurs packages indépendants. Dans d’autres cas, un package peut contenir uniquement des fichiers de symboles (.pdb) pour faciliter le débogage.

Note

Lorsque vous créez un package à utiliser par d’autres développeurs, il est important de comprendre qu’ils prennent une dépendance sur votre travail. Par conséquent, la création et la publication d’un package impliquent également un engagement à résoudre les bogues et à effectuer d’autres mises à jour, ou au moins à rendre le package disponible en tant que open source afin que d’autres puissent aider à le maintenir.

Quel que soit le cas, la création d’un package commence par choisir son identificateur, son numéro de version, sa licence, ses informations de copyright et tout autre contenu nécessaire. Une fois l’opération terminée, vous pouvez utiliser la commande « pack » pour rassembler tous les éléments dans un .nupkg fichier. Ce fichier peut être publié dans un flux NuGet, comme nuget.org.

Conseil / Astuce

Un package NuGet avec l’extension .nupkg est simplement un fichier ZIP. Pour examiner facilement le contenu d’un package, modifiez l’extension en .zip et développez son contenu normalement. Veillez simplement à changer l'extension de retour à .nupkg avant de tenter de le téléverser sur un hôte.

Pour apprendre et comprendre le processus de création, commencez par créer un package qui vous guide tout au long des processus principaux communs à tous les packages.

À partir de là, vous pouvez prendre en compte un certain nombre d’autres options pour votre package :

• La prise en charge de plusieurs frameworks cibles décrit comment créer un package avec plusieurs variantes pour différents frameworks .NET.
• La création de packages localisés décrit comment structurer un package avec plusieurs ressources linguistiques et comment utiliser des packages satellites localisés distincts.
• Les packages de préversion montrent comment publier des packages alpha, bêta et rc pour les clients qui sont intéressés.
• Transformations de fichiers source et de configuration décrit comment effectuer des remplacements de jetons unidirectionnels dans les fichiers ajoutés à un projet, et comment modifier web.config et app.config avec des paramètres qui sont également réinitialisés lors de la désinstallation du package.
• Les packages de symboles fournissent des conseils pour fournir des symboles pour votre bibliothèque qui permettent aux consommateurs d’effectuer un pas à pas dans votre code lors du débogage.
• Le contrôle de version de package explique comment identifier les versions exactes que vous autorisez pour vos dépendances (d’autres packages que vous consommez à partir de votre package).
• Les packages natifs décrivent le processus de création d’un package pour les consommateurs C++.
• Les packages de signature décrivent le processus d’ajout d’une signature numérique à un package.

Lorsque vous êtes alors prêt à publier un package sur nuget.org, suivez le processus simple dans Publier un package.

Si vous souhaitez utiliser un flux privé au lieu de nuget.org, consultez la vue d’ensemble des packages d’hébergement