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:

Uživatelské rozhraní Správce balíčků zobrazující nejnovější stabilní verzi

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: zahrňte příponu sémantické verze v prvku PackageVersion souboru .csproj.

    <PropertyGroup>
        <PackageVersion>1.0.1-alpha</PackageVersion>
    </PropertyGroup>
    
  • Pokud váš projekt má packages.config soubor: v 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:

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

    Zaškrtávací políčko Zahrnout předběžné verze v sadě 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.

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

  • NuGet CLI: Použijte přepínač s příkazy install, update, delete a mirror. Referenční informace k NuGet CLI

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ů.