Introducción a los paquetes NuGet

  • Artículo
  • 5 minutos para leer

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2017

Los desarrolladores pueden Azure Artifacts para publicar y consumir NuGet paquetes tanto hacia como desde fuentes y registros públicos. Una fuente es una construcción organizativa que hospeda paquetes. Puede crear fuentes públicas y privadas, y puede controlar quién puede acceder a los paquetes modificando los permisos de fuente.

Requisitos previos

En este inicio rápido se da por supuesto que ya ha configurado Azure Artifacts. Puede consultar cómo obtener licencias de la extensión en la guía de licencia Azure Artifacts licencia.

Nota

Azure Artifacts es una extensión que viene preinstalada en TFS 2017 o posterior. Si se quitó de su organización, puede instalarla desde Azure Artifacts Marketplace.

Creación de una fuente

Con Azure Artifacts, puede crear dos tipos de fuentes: fuentes con ámbito de proyecto y de ámbito de organización. Todas las fuentes públicas tienen ámbito de proyecto y heredan la configuración de visibilidad del proyecto de hospedaje. De forma predeterminada, cualquier fuente creada mediante la interfaz de usuario web es una fuente con ámbito de proyecto.

  1. Desde dentro del proyecto, vaya a Azure Artifacts.

    Vaya a Azure Artifacts

  2. Seleccione Crear fuente.

    Botón Nueva fuente

  3. Asigne un nombre a la fuente y elija su visibilidad, orígenes ascendentesy configuración de ámbito.

    Cuadro de diálogo Nueva fuente

  4. Seleccione Crear cuando haya terminado.

Azure Artifacts está instalado de forma predeterminada para los clientes de TFS 2017. Debe actualizar a TFS 2017 para poder usar Azure Artifacts. Si es la primera vez que usa la fuente, es posible que se le pida que asigne una licencia.

  1. Vaya a Build Release (Versión de compilación) y seleccione Packages (Paquetes).

    Vaya a Azure Artifacts TFS

  2. Seleccione + Nueva fuente.

    Nuevo botón de fuente TFS

  3. Asigne a la fuente un nombre, una descripcióny configure quién puede leer ,quién puede contribuir y si desea incluir paquetes externos.

    Cuadro de diálogo Nueva fuente TFS

  4. Seleccione Crear cuando haya terminado.

Conectar para alimentar y publicar paquetes

Con Azure Artifacts, puede publicar los paquetes de NuGet en fuentes públicas o privadas y, a continuación, compartirlos con otros usuarios, en función de la configuración de visibilidad de la fuente.

Aquí se muestra cómo conectarse a la fuente y publicar un paquete.

  1. En el proyecto, seleccione Artifactsy, a continuación, seleccione la fuente. Puede crear una nueva fuente si aún no tiene una.

  2. Seleccione Conectar a la fuente.

    Conectar a la fuente

  3. Seleccione NuGet.exe en el NuGet encabezado.

    NuGet.exe de fuente de distribución

  4. Si es la primera vez que usa Azure Artifacts con Nuget.exe, seleccione el botón Obtener las herramientas y siga las instrucciones para instalar los requisitos previos.

    1. Descargue la versión NuGet más reciente.
    2. Descargue e instale el Azure Artifacts Proveedor de credenciales.

  5. Siga las instrucciones del Project configuración para conectarse a la fuente.

    Configuración del proyecto

Publicación de NuGet paquete mediante la línea de comandos

Si no tiene un paquete NuGet pero desea intentar publicar el paquete en la fuente, puede instalar el paquete de ejemplo HelloWorld.

nuget install HelloWorld -ExcludeVersion

Ejecute el siguiente comando para publicar el paquete en la fuente:

nuget.exe push -Source "<YOUR_FEED_NAME>" -ApiKey <ANY_STRING> <PACKAGE_PATH>

  1. Seleccione Build and Release Packages (Compilar y liberarpaquetes).

  2. Seleccione la fuente en el menú desplegable o cree una si no lo ha hecho.

  3. Seleccione Conectar a la fuente.

    Conectar fuente: TFS

  4. Seleccione NuGet y siga las instrucciones para conectarse a la fuente.

    Conectar a NuGet fuente de distribución: TFS

Instalación y publicación de un paquete de NuGet ejemplo

Si no tiene un paquete NuGet pero desea practicar los pasos para publicar nuestros paquetes en la fuente, puede instalar el paquete de ejemplo HelloWorld.

  1. Instale el paquete de NuGet ejemplo:

    nuget install HelloWorld -ExcludeVersion

  2. Configuración del archivo nuget.config y publicación del paquete en la fuente

    nuget sources add -Name <SourceName> -Source <SourceURL> -username <UserName> -password <Pat>
nuget push -Source <SourceName> -ApiKey az <PackagePath exp:(.\Get-Hello.1.0.0.nupkg)>

Consumo de paquetes en Visual Studio

Para consumir NuGet paquetes de la fuente, debe agregar el punto de conexión de NuGet de la fuente como origen de paquete en Visual Studio, como se muestra a continuación.

1. Obtener la dirección URL de origen de la fuente

  1. En el proyecto, seleccione Artifactsy, a continuación, seleccione la fuente.

  2. Seleccione Conectar a la fuente.

    Conectar para la fuente

  3. Seleccione Visual Studio en la NuGet sección .

  4. Copie la dirección URL de origen de la fuente.

    Copia de la dirección URL de origen

  1. Seleccione Build and Release (Compilar y liberar)y, a continuación, seleccione Packages (Paquetes).

  2. Seleccione la fuente en el menú desplegable.

  3. Seleccione Conectar a la fuente.

    Conectar para la fuente

  4. Copie la dirección URL de origen de la fuente.

    Copia de la dirección URL de origen

2. Configuración Visual Studio

Configuración del origen del paquete

  1. En Visual Studio, seleccione Herramientasy, a continuación, Opciones.

  2. Expanda la NuGet Administrador de paquetes y, a continuación, seleccione Orígenes de paquetes.

  3. Escriba el nombre y la direcciónURL de origen de la fuente y, a continuación, seleccione el signo verde (+) para agregar un origen.

  4. Si ha habilitado orígenes ascendentes en la fuente, desactive nuget.org casilla.

  5. Seleccione Aceptar.

    Configuración de Visual Studio: Windows

3. Consumo de paquetes

Ahora puede buscar y consumir paquetes de la fuente mediante Visual Studio.

  1. En Visual Studio, haga clic con el botón derecho en el proyecto en la Explorador de soluciones y, a continuación, seleccione Administrar NuGet paquetes.
  2. Seleccione Examinar y,a continuación, seleccione la fuente en la lista desplegable Origen del paquete Seleccionar origen de fuente.
  3. Use la barra de búsqueda para buscar paquetes de la fuente.

Nota

Si usa orígenes ascendentes, los paquetes de orígenes ascendentes que aún no se hayan guardado en la fuente (mediante su uso al menos una vez) no aparecerán en el resultado de la búsqueda Administrador de paquetes ascendente. Para instalar esos paquetes:

Consumo de paquetes de NuGet.org

  1. Copie el comando Install-Package del registro público (NuGet.org).
  2. Seleccione Herramientas y NuGet Administrador de paquetes para abrir el administrador de NuGet paquetes.
  3. Pegue el comando en la consola Administrador de paquetes y seleccione ejecutar.