Vytváření předběžných balíčků

Pokaždé, když vydáte aktualizovaný balíček s novým číslem verze, NuGet se domnívá, že jde o nejnovější stabilní verzi, jak je znázorněno například v uživatelském rozhraní Správce balíčků v sadě Visual Studio:

Package Manager UI showing the latest stable release

Stabilní verze je ta, která je považována za spolehlivou, aby ji bylo možné použít v produkčním prostředí. Nejnovější stabilní vydaná verze je také ta, která se nainstaluje jako aktualizace balíčku nebo během obnovení balíčku (podle omezení popsaných v části Přeinstalace a aktualizace balíčků).

Aby bylo možno podporovat životní cyklus vydání softwaru, NuGet 1.6 a novější umožňuje distribuci předběžných balíčků, kde číslo verze obsahuje sémantickou příponu správy verzí, jako -alphaje , -betanebo -rc. Další informace najdete v tématu Správa verzí balíčků.

Tyto verze můžete zadat jedním z následujících způsobů:

  • Pokud váš projekt používá PackageReference: include the sémantic version suffix in the .csproj file's PackageVersion element:

    <PropertyGroup>
        <PackageVersion>1.0.1-alpha</PackageVersion>
    </PropertyGroup>
    
  • Pokud má packages.config váš projekt soubor: do elementu .nuspec souboru version zahrňte příponu sémantické verze:

    <version>1.0.1-alpha</version>
    

Až budete připraveni vydat stabilní verzi, stačí odebrat příponu a balíček bude mít přednost před všemi předběžnými verzemi. Znovu si přečtěte informace o správě verzí balíčků.

Instalace a aktualizace předběžných balíčků

Ve výchozím nastavení NuGet neobsahuje předběžné verze při práci s balíčky, ale toto chování můžete změnit následujícím způsobem:

  • Správce balíčků uživatelské rozhraní v sadě Visual Studio: V uživatelském rozhraní Spravovat balíčky NuGet zaškrtněte políčko Zahrnout předběžné verze:

    The Include prerelease checkbox in Visual Studio

    Nastavení nebo zrušení zaškrtnutí tohoto políčka aktualizuje uživatelské rozhraní Správce balíčků a seznam dostupných verzí, které můžete nainstalovat.

  • Správce balíčků Konzola: Použijte -IncludePrerelease přepínač s příkazy Find-Package, Get-Package, Sync-PackageInstall-Package, a Update-Package příkazy. Projděte si referenční informace k PowerShellu.

  • Rozhraní příkazového řádku NuGet: Použijte přepínač s příkazy install, updatedelete, a mirror příkazy.-prerelease Referenční informace k rozhraní příkazového řádku NuGet

Sémantická správa verzí

Sémantická správa verzí nebo semVer konvence popisuje, jak používat řetězce v číslech verzí ke sdělení významu základního kódu. Přečtěte si další informace o základech správy verzí balíčků.