Microsoft. AspNetCore. All Metapackage for ASP.NET Core 2,0

  • Článek
  • 2 min ke čtení

Microsoft.AspNetCore.AllMetapackage není součástí ASP.NET Core 3,0 a novějších. Další informace najdete v tomto problému GitHubu.

Poznámka

Doporučujeme, abyste aplikace cílí na ASP.NET Core 2,1 a později místo tohoto balíčku používali Microsoft.AspNetCore.app Metapackage . Viz migrace z Microsoft. AspNetCore. All na Microsoft.AspNetCore.app v tomto článku.

Tato funkce vyžaduje ASP.NET Core 2. x cílící na rozhraní .NET Core 2. x.

Microsoft. AspNetCore. All je Metapackage, který odkazuje na sdílené rozhraní. Sdílené rozhraní je sada sestavení (soubory . dll ), která nejsou ve složkách aplikace. Aby bylo možné aplikaci spustit, musí být na počítači nainstalována sdílená rozhraní. Další informace najdete v tématu sdílené rozhraní.

Sdílené rozhraní, které Microsoft.AspNetCore.All odkazuje na:

  • Všechny podporované balíčky ASP.NET Core týmu.
  • Všechny podporované balíčky Entity Framework Core.
  • Interní a nezávislé závislosti třetích stran používané ASP.NET Core a Entity Framework Core.

Do balíčku jsou zahrnuté všechny funkce ASP.NET Core 2. x a Entity Framework Core 2. x. Microsoft.AspNetCore.All Výchozí šablony projektu, které cílí na ASP.NET Core 2,0, používají tento balíček.

Číslo verze Microsoft.AspNetCore.All Metapackage představuje minimální verzi ASP.NET Core a Entity Framework Core verzi.

Následující soubor . csproj odkazuje na Microsoft.AspNetCore.All Metapackage pro ASP.NET Core:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp2.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.9" />
  </ItemGroup>

</Project>

Implicitní Správa verzí

V ASP.NET Core 2,1 nebo novější můžete zadat Microsoft.AspNetCore.All odkaz na balíček bez verze. Není-li zadána verze, je implicitní verze určena sadou SDK ( Microsoft.NET.Sdk.Web ). Doporučujeme, abyste se spoléhali na implicitní verzi určenou sadou SDK a neexplicitně nastavoval číslo verze na odkaz na balíček. Pokud máte dotazy týkající se tohoto přístupu, ponechte komentář GitHubu v diskuzi o implicitní verzi Microsoft.AspNetCore.app.

Implicitní verze je nastavená na major.minor.0 pro přenosné aplikace. Mechanismus pro přetečení sdíleného rozhraní spustí aplikaci na nejnovější kompatibilní verzi z nainstalovaných sdílených rozhraní. Aby bylo zaručeno, že stejná verze se používá ve vývoji, testování a produkčním prostředí, zajistěte, aby byla stejná verze sdíleného rozhraní nainstalovaná ve všech prostředích. U samostatných aplikací je implicitní číslo verze nastaveno na sdílené rozhraní, které je major.minor.patch v nainstalované sadě SDK součástí sady.

Zadání čísla verze na odkaz na Microsoft.AspNetCore.All balíček nezaručuje , že je zvolena verze sdíleného rozhraní. Například Předpokládejme, že je zadána verze "2.1.1", ale je nainstalována aplikace "2.1.3". V takovém případě bude aplikace používat "2.1.3". I když se to nedoporučuje, můžete zablokovat přeposlání (oprava nebo podverze). Další informace o tom, jak integrovat hostitele dotnet a jak nakonfigurovat jeho chování, najdete v tématu dotnet Host – přesměrování.

Sada SDK projektu musí být nastavena na hodnotu Microsoft.NET.Sdk.Web v souboru projektu, aby používala implicitní verzi Microsoft.AspNetCore.All . Při Microsoft.NET.Sdk zadání sady SDK ( <Project Sdk="Microsoft.NET.Sdk"> v horní části souboru projektu) se vygeneruje následující upozornění:

Upozornění NU1604: závislost projektu Microsoft. AspNetCore. All neobsahuje žádné zahrnutí dolní meze. Zahrňte do verze závislosti dolní mez, aby se zajistilo konzistentní výsledky obnovení.

Jedná se o známý problém se sadou .NET Core 2,1 SDK a bude opraven v sadě .NET Core 2,2 SDK.

Migrace z Microsoft. AspNetCore. All na Microsoft.AspNetCore.App

K dispozici jsou tyto balíčky, Microsoft.AspNetCore.All ale ne Microsoft.AspNetCore.App balíček.

  • Microsoft.AspNetCore.ApplicationInsights.HostingStartup
  • Microsoft.AspNetCore.AzureAppServices.HostingStartup
  • Microsoft.AspNetCore.AzureAppServicesIntegration
  • Microsoft.AspNetCore.DataProtection.AzureKeyVault
  • Microsoft.AspNetCore.DataProtection.AzureStorage
  • Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv
  • Microsoft.AspNetCore.SignalR.Redis
  • Microsoft.Data.Sqlite
  • Microsoft.Data.Sqlite.Core
  • Microsoft.EntityFrameworkCore.Sqlite
  • Microsoft.EntityFrameworkCore.Sqlite.Core
  • Microsoft.Extensions.Caching.Redis
  • Microsoft.Extensions.Configuration.AzureKeyVault
  • Microsoft.Extensions.Logging.AzureAppServices
  • Microsoft.VisualStudio.Web.BrowserLink

Pokud chcete přejít z Microsoft.AspNetCore.All na Microsoft.AspNetCore.App , pokud vaše aplikace používá rozhraní API z výše uvedených balíčků nebo balíčky, které tyto balíčky přidávají, přidejte odkazy na tyto balíčky v projektu.

Všechny závislosti předchozích balíčků, které jinak nejsou závislé na, nejsou Microsoft.AspNetCore.App implicitně zahrnuté. Například:

  • StackExchange.Redis jako závislost Microsoft.Extensions.Caching.Redis
  • Microsoft.ApplicationInsights jako závislost Microsoft.AspNetCore.ApplicationInsights.HostingStartup

Aktualizace ASP.NET Core 2,1

Doporučujeme migrovat na Microsoft.AspNetCore.App Metapackage pro 2,1 a novější. Chcete-li nadále používat Microsoft.AspNetCore.All Metapackage a zajistit, aby byla nasazena nejnovější verze opravy:

  • Ve vývojových počítačích a serverech sestavení: Nainstalujte nejnovější .NET Core SDK.
  • Na serverech nasazení: Nainstalujte nejnovější modul runtime .NET Core. Vaše aplikace bude předána na nejnovější nainstalovanou verzi při restartu aplikace.