Microsoft.AspNetCore.All metacsomag az ASP.NET Core 2.0-hoz

Megjegyzés:

A Microsoft.AspNetCore.All metacsomag nem használható ASP.NET Core 3.0-s vagy újabb verzióiban. További információkért tekintse meg ezt a GitHub-problémát.

Megjegyzés:

Javasoljuk, hogy a ASP.NET Core 2.1-et vagy újabb verziót célzó alkalmazások a csomag helyett a Microsoft.AspNetCore.App metacsomagot használják. Lásd: Migrálás a Microsoft.AspNetCore.All-ról a Microsoft.AspNetCore.App-ra ebben a cikkben.

Ehhez a funkcióhoz ASP.NET Core 2.x szükséges, amely a .NET Core 2.x-re irányul.

A Microsoft.AspNetCore.All egy megosztott keretrendszerre hivatkozó metapackage. A megosztott keretrendszer olyan szerelvények (.dll fájlok) készlete, amelyek nem szerepelnek az alkalmazás mappáiban. Az alkalmazás futtatásához telepíteni kell a megosztott keretrendszert a számítógépre. További információ: A megosztott keretrendszer.

A hivatkozott megosztott keretrendszer a Microsoft.AspNetCore.All következőket tartalmazza:

• Az ASP.NET Core csapata által támogatott összes csomag.
• Az Entity Framework Core által támogatott összes csomag.
• Az ASP.NET Core és az Entity Framework Core által használt belső és külső függőségek.

A csomag tartalmazza a ASP.NET Core 2.x és az Entity Framework Core 2.x összes funkcióját Microsoft.AspNetCore.All . A Core 2.0 ASP.NET alapértelmezett projektsablonjai ezt a csomagot használják.

A Microsoft.AspNetCore.All metacsomag verziószáma az ASP.NET Core és az Entity Framework Core minimális verzióját jelöli.

Az alábbi .csproj fájl a Microsoft.AspNetCore.All ASP.NET Core metapackage-ére hivatkozik:

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

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

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

</Project>

Implicit verziószámozás

A ASP.NET Core 2.1-es vagy újabb verziójában verzió nélkül is megadhatja a Microsoft.AspNetCore.All csomaghivatkozást. Ha a verzió nincs megadva, az SDK (Microsoft.NET.Sdk.Web) implicit verziót ad meg. Javasoljuk, hogy az SDK által megadott implicit verzióra támaszkodzon, és ne adja meg explicit módon a verziószámot a csomaghivatkozáson. Ha kérdése van ezzel a megközelítéssel kapcsolatban, hagyjon egy GitHub-megjegyzést a Microsoft.AspNetCore.App implicit verzió vitafórumában.

Az implicit verzió a hordozható alkalmazásokhoz van beállítva major.minor.0 . A megosztott keretrendszer roll-forward mechanizmusa az alkalmazást a legújabb kompatibilis verzión futtatja a telepített megosztott keretrendszerek között. Annak biztosítására, hogy a fejlesztés, tesztelés és éles üzem ugyanazt a verziót használja, győződjön meg arról, hogy a megosztott keretrendszer ugyanazon verziója minden környezetben telepítve van. Önálló alkalmazások esetén az implicit verziószám a major.minor.patch telepített SDK-ban csomagolt megosztott keretrendszerre van állítva.

A csomaghivatkozásban megadott Microsoft.AspNetCore.All verziószám nem garantálja, hogy a megosztott keretrendszer verziója van kiválasztva. Tegyük fel például, hogy a "2.1.1" verzió van megadva, de a "2.1.3" telepítve van. Ebben az esetben az alkalmazás a "2.1.3" értéket fogja használni. Bár nem ajánlott, kikapcsolhatja a frissítés előremozgatását (javítások és/vagy kisebb verziók). További információkért a dotnet gazda előreállás funkciójáról és annak viselkedésének konfigurálásáról lásd: dotnet gazda előreállás.

A projekt SDK-jának be kell állítania Microsoft.NET.Sdk.Web a projektfájlban az implicit verzió Microsoft.AspNetCore.Allhasználatához. Ha az Microsoft.NET.Sdk SDK meg van adva (<Project Sdk="Microsoft.NET.Sdk"> a projektfájl tetején), a következő figyelmeztetés jön létre:

Figyelmeztetés NU1604: A Microsoft.AspNetCore.All projektfüggőség nem tartalmaz befogadó alsó határt. A konzisztens visszaállítási eredmények érdekében a függőségi verzióban adjon meg egy alacsonyabb korlátot.

Ez egy ismert probléma a .NET Core 2.1 SDK-val kapcsolatban, és a .NET Core 2.2 SDK-ban lesz kijavítva.

Migrálás a Microsoft.AspNetCore.All-ból a Microsoft.AspNetCore.App

A következő csomagok a Microsoft.AspNetCore.All részét képezik, de nem a Microsoft.AspNetCore.App csomagét.

• 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

A Microsoft.AspNetCore.All-ról a Microsoft.AspNetCore.App-ra való áttéréshez, ha az alkalmazás a fenti csomagokban vagy a csomagok által bevitt csomagokban található API-kat használ, adjon hozzá hivatkozásokat ezekre a csomagokra a projektben.

Az előző csomagok olyan függőségei, amelyek egyébként nem függőségek Microsoft.AspNetCore.App, implicit módon nem lesznek belefoglalva. Például:

• StackExchange.Redis mint függőség Microsoft.Extensions.Caching.Redis
• Microsoft.ApplicationInsights mint függőség Microsoft.AspNetCore.ApplicationInsights.HostingStartup

ASP.NET Core 2.1 frissítése

Javasoljuk, hogy a 2.1-re vagy újabb verziókra migráljon a Microsoft.AspNetCore.App metacsomagra. A metacsomag használatának Microsoft.AspNetCore.All fenntartása és a legújabb javításverzió üzembe helyezése:

• Fejlesztői gépeken és buildkiszolgálókon: Telepítse a legújabb .NET Core SDK-t.
• Üzembehelyezési kiszolgálókon: Telepítse a legújabb .NET Core-futtatókörnyezetet. Az alkalmazás újraindulásakor az alkalmazás a legújabb telepített verzióra kerül.