Publicar paquetes en NuGet.org

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

NuGet.org es un administrador de paquetes que permite a los desarrolladores compartir código reutilizable. Un paquete NuGet es un archivo comprimido con .nupkg extensión que contiene código compilado que se puede consumir en otros proyectos. Los paquetes hospedados en NuGet.org están disponibles para todos los desarrolladores de todo el mundo.

Requisitos previos

  • Cualquier versión de Visual Studio 2019 y la carga de trabajo de .NET Core.
  • dotnet CLI. Si aún no lo tiene, instale el SDK de .NET Core.
  • Regístrese para obtener una cuenta gratuita en nuget.org si aún no tiene una.

Creación de un proyecto

Puede usar su propio proyecto de .NET para compilar y generar un paquete NuGet o crear una biblioteca de clases básica de .NET de la siguiente manera:

  1. En Visual Studio, seleccione Archivo, Nuevo y Proyecto.

  2. Seleccione la plantilla Biblioteca de clases (.NET Standard) y seleccione Siguiente.

  3. Asigne un nombre al proyecto y a la solución y seleccione una ubicación para guardar el proyecto localmente. Cuando haya terminado, seleccione Crear.

    Crear un proyecto de biblioteca de clases

La biblioteca de clases de plantilla es suficiente para crear un paquete NuGet, por lo que para este tutorial usaremos la plantilla existente y no escribiremos ningún código adicional.

Configuración y generación de un paquete

  1. Seleccione el proyecto en el Explorador de soluciones, haga clic con el botón derecho y seleccione propiedades y, después, Paquete.

  2. Rellene el formulario y asegúrese de que el identificador del paquete es único; de lo contrario, puede entrar en conflicto con los paquetes existentes en NuGet.org. Una convención de nomenclatura común es algo como: Company.Product.Feature. Si quiere generar el paquete cada vez que compile el proyecto, active la casilla Generar paquete NuGet en la compilación .

    Configurar propiedades del paquete

  3. Seleccione el proyecto en el Explorador de soluciones y haga clic con el botón derecho en Pack para generar el .nupkg paquete.

    Genere el paquete:

  4. Compruebe el estado del comando pack en la ventana de salida.

    Salida del paquete

Genere una clave de API

Ahora que creamos nuestro nupkg paquete, casi estamos listos para publicarlo, pero primero es necesario generar una clave de API para conectarse a la API de NuGet.org.

  1. Inicie sesión en su cuenta de NuGet.org o cree una si no lo ha hecho.

  2. Seleccione el icono de nombre de usuario y, a continuación, seleccione Claves de API.

  3. Seleccione Crear y escriba un nombre para la clave. Asigne a la clave un ámbito Insertar nuevos paquetes y versión de paquete y escriba * en el campo patrón global para seleccionar todos los paquetes. Cuando haya terminado, seleccione Crear.

    Crear una clave de API

  4. Seleccione Copiar y guarde la clave de API en una ubicación segura. Necesitaremos esta clave para publicar nuestro paquete NuGet.

    Copia de la clave de API

Publicación de un paquete en NuGet.org

Puede publicar el paquete mediante la interfaz de usuario web, la CLI de dotnet o la CLI de nuget.exe. Nos centraremos en la publicación de paquetes mediante la línea de comandos de esta sección. Necesitará el nombre del paquete, una clave de API y la dirección URL de origen para hacerlo.

  1. En un símbolo del sistema con privilegios elevados, vaya a la carpeta que contiene nupkg el paquete.

  2. Ejecute el siguiente comando para publicar el paquete en NuGet.org. Reemplace los marcadores de posición por el nombre del paquete y la clave de API.

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. La salida del comando anterior debe tener un aspecto similar al siguiente.

    Publicación de la salida del paquete