Přehled toho, jak se .NET používá ve verzích

  • Článek

Modul runtime .NET a sada .NET SDK přidávají nové funkce s různou frekvencí. Obecně platí, že sada SDK se aktualizuje častěji než Modul runtime. Tento článek vysvětluje modul runtime a čísla verzí sady SDK.

.NET vydává novou hlavní verzi každý listopad. Verze s rovnoměrně číslováním, jako je .NET 6 nebo .NET 8, jsou dlouhodobě podporované (LTS). Liché číslování verzí se podporuje až do příští hlavní verze. Nejnovější verze .NET je .NET 6.

Podrobnosti o verzích

Modul runtime .NET má přístup k verzím major.minor.patch, který se řídí sémantickou sémantickou sekcí verzí.

Sada .NET SDK ale nesleduje sémantickou verzi. Sada .NET SDK se vydává rychleji a její čísla verzí musí komunikovat se zarovnaný modul runtime i vlastními dílčími verzemi a verzemi oprav sady SDK.

První dvě pozice čísla verze sady .NET SDK odpovídají verzi modulu runtime .NET, se které vydala. Každá verze sady SDK může vytvářet aplikace pro tento modul runtime nebo jakoukoli nižší verzi.

Třetí pozice čísla verze sady SDK sděluje dílčí číslo i číslo opravy. Podver starší verze se vynásobí hodnotou 100. Poslední dvě číslice představují číslo opravy. Podverda 1, verze opravy 2, by byla reprezentována jako 102. Tady je například možná posloupnost čísel verzí modulu runtime a sady SDK:

Změnit Modul runtime .NET .NET SDK (*)
Původní vydaná verze 5.0.0 5.0.100
Oprava sady SDK 5.0.0 5.0.101
Modul runtime a oprava sady SDK 5.0.1 5.0.102
Změna funkce sady SDK 5.0.1 5.0.200

POZNÁMKY:

  • Pokud má sada SDK 10 aktualizací funkcí před aktualizací funkcí modulu runtime, čísla verzí se začtou do řady 1000. Verze 5.0.1000 by byla ve verzi 5.0.900. Neočekává se, že k této situaci dojde.
  • 99 vydání oprav bez vydání funkcí se nevyskytne. Pokud se k tomuto číslu přiblíží verze, vynutí vydání funkce.

Další podrobnosti najdete v počátečním návrhu v úložišti dotnet/designs .

Sémantická správa verzí

Modul runtime .NET zhruba dodržuje sémantickou verzi (SemVer) a používá používání verzí a k popisu stupně a typu změny používá různé části čísla verze.

MAJOR.MINOR.PATCH[-PRERELEASE-BUILDNUMBER]

Volitelné části PRERELEASE a nejsou BUILDNUMBER nikdy součástí podporovaných verzí a existují pouze v nočních buildech, místních sestaveních ze zdrojových cílů a nepodporovaných verzích Preview.

Principy změn čísel verzí modulu runtime

  • MAJOR se zvýší jednou za rok a může obsahovat:

    • Významné změny v produktu nebo nový směr produktu.
    • Rozhraní API zavedlo rozbíjení změn. K dispozici je vysoký pruh pro přijetí změn, které jsou narušující.
    • MAJOR Je přijata novější verze existující závislosti.

    K hlavním vydáním dochází jednou za rok, verze s rovnoměrně číslováním jsou dlouhodobě podporované verze (LTS). První verze LTS, která používá toto schéma verzí, je .NET 6. Nejnovější verze bez LTS je .NET 5.

  • MINOR se zvýší, když:

    • Přidá se oblast s veřejným rozhraním API.
    • Přidá se nové chování.
    • MINOR Je přijata novější verze existující závislosti.
    • Zavádí se nová závislost.

  • PATCH se zvýší, když:

    • Opravy chyb jsou provedeny.
    • Přidává se podpora novější platformy.
    • PATCH Je přijata novější verze existující závislosti.
    • Žádné jiné změny se nevejde na jeden z předchozích případů.

Pokud dojde k více změnám, zvýší se nejvyšší prvek ovlivněný jednotlivými změnami a následující změny se resetují na nulu. Když se například zvýší MAJOR hodnota, resetují MINOR.PATCH se na nulu. Při MINOR zvýšení se funkce PATCH resetuje na nulu, zatímco hodnota MAJOR zůstane stejná.

Čísla verzí v názvech souborů

Soubory stažené pro .NET mají verzi, například dotnet-sdk-5.0.301-win10-x64.exe.

Verze Preview

Verze Preview mají -preview.[number].[build] k číslu verze připojený . Například, 6.0.0-preview.5.21302.13.

Servisní verze

Po vydání verze větve vydání obecně přestanou vytvářet každodenní sestavení a místo toho začnou vytvářet servisní sestavení. Servisní verze mají -servicing-[number] k verzi připojený . Například, 5.0.1-servicing-006924.

Viz také