Compartir a través de


Crear paquetes de versión preliminar

Cada vez que libere un paquete actualizado con un nuevo número de versión, NuGet la considerará la "versión estable más reciente" tal y como se muestra, por ejemplo, en la interfaz de usuario del Administrador de paquetes en Visual Studio:

Package Manager UI showing the latest stable release

Una versión estable es aquella que se considera lo suficientemente confiable para su uso en producción. La versión estable más reciente también es la que se instalará como actualización del paquete o durante la restauración del paquete (sujeta a restricciones, tal y como se describe en Reinstalación y actualización de paquetes).

Para admitir el ciclo de vida de la versión de software, NuGet 1.6 y versiones posteriores permite la distribución de paquetes de versión preliminar, donde el número de versión incluye un sufijo de control de versiones semántico como -alpha, -beta o -rc. Para más información, vea Package versioning (Control de versiones de paquetes).

Puede especificar estas versiones mediante una de las maneras siguientes:

  • Si el proyecto usa PackageReference: incluya el sufijo de versión semántica en el archivo .csproj, en el elemento PackageVersion:

    <PropertyGroup>
        <PackageVersion>1.0.1-alpha</PackageVersion>
    </PropertyGroup>
    
  • Si el proyecto tiene un archivo packages.config: incluya el sufijo de versión semántica en el archivo .nuspec, en el elemento version:

    <version>1.0.1-alpha</version>
    

Cuando esté listo para liberar una versión estable, quite el sufijo y el paquete tendrá prioridad sobre las demás versiones preliminares. Una vez más, vea Package versioning (Control de versiones de paquetes).

Instalar y actualizar paquetes de versión preliminar

De forma predeterminada, NuGet no incluye las versiones preliminares al trabajar con paquetes, pero puede cambiar este comportamiento del siguiente modo:

  • Interfaz de usuario del Administrador de paquetes en Visual Studio: en la interfaz de usuario Administrar paquetes NuGet, marque la casilla Incluir versión preliminar:

    The Include prerelease checkbox in Visual Studio

    Si marca o desmarca esta casilla, se actualizarán la interfaz de usuario del Administrador de paquetes y la lista de versiones disponibles que puede instalar.

  • Consola del Administrador de paquetes: use el conmutador -IncludePrerelease con los comandos Find-Package, Get-Package, Install-Package, Sync-Package y Update-Package. Consulte la referencia de PowerShell.

  • CLI de NuGet: use el conmutador -prerelease con los comandos install, update, delete y mirror. Consulte la referencia de la CLI de NuGet

Versionamiento semántico

En Semantic Versioning or SemVer convention (Control de versiones semántico o convención SemVer) se describe cómo usar las cadenas en los números de versión para expresar el significado del código subyacente. Obtenga más información sobre los datos básicos del control de versiones de los paquetes.