Microsoft.AspNetCore.App för ASP.NET Core

Det delade ASP.NET Core-ramverket (Microsoft.AspNetCore.App) innehåller sammansättningar som utvecklas och stöds av Microsoft. Microsoft.AspNetCore.App installeras när .NET Core 3.0 eller senare SDK installeras. Det delade ramverket är uppsättningen sammansättningar (.dll filer) som är installerade på datorn och innehåller en körningskomponent och ett målpaket. Mer information finns i Det delade ramverket.

• Projekt som är inriktade på Microsoft.NET.Sdk.Web SDK refererar implicit till det Microsoft.AspNetCore.App ramverket.

Inga ytterligare referenser krävs för dessa projekt:

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>netcoreapp3.0</TargetFramework>
  </PropertyGroup>
    ...
</Project>

ASP.NET Cores delade ramverk:

• Innehåller inte beroenden från tredje part.
• Innehåller alla paket som stöds av ASP.NET Core-teamet.

Den här funktionen kräver ASP.NET Core 2.x som är riktad mot .NET Core 2.x.

Metapaketet Microsoft.AspNetCore.App för ASP.NET Core:

• Omfattar inte beroenden från tredje part förutom Json.NET, Remotion.Linq och IX-Async. Dessa beroenden från tredje part anses nödvändiga för att säkerställa att de viktigaste ramverksfunktionerna fungerar.
• Innehåller alla paket som stöds av ASP.NET Core-teamet förutom de som innehåller beroenden från tredje part (förutom de som tidigare nämnts).
• Innehåller alla paket som stöds av Entity Framework Core-teamet förutom de som innehåller beroenden från tredje part (förutom de som tidigare nämnts).

Alla funktioner i ASP.NET Core 2.x och Entity Framework Core 2.x ingår i Microsoft.AspNetCore.App paketet. Standardprojektmallarna för ASP.NET Core 2.x använder det här paketet. Vi rekommenderar att program som riktar sig till ASP.NET Core 2.x och Entity Framework Core 2.x använder Microsoft.AspNetCore.App paketet.

Versionsnumret för Microsoft.AspNetCore.App metapaketet representerar den lägsta ASP.NET Core-versionen och Entity Framework Core-versionen.

Microsoft.AspNetCore.App Med metapaketet finns versionsbegränsningar som skyddar din app:

• Om ett paket ingår som har ett transitivt (inte direkt) beroende av ett paket i Microsoft.AspNetCore.App, och dessa versionsnummer skiljer sig åt, genererar NuGet ett fel.
• Andra paket som läggs till i din app kan inte ändra versionen av paketen som ingår i Microsoft.AspNetCore.App.
• Versionskonsekvens säkerställer en tillförlitlig upplevelse. Microsoft.AspNetCore.App har utformats för att förhindra att otestade versionskombinationer av relaterade bitar används tillsammans i samma app.

Program som använder Microsoft.AspNetCore.App metapaketet drar automatiskt nytta av det delade ASP.NET Core-ramverket. När du använder Microsoft.AspNetCore.App metapaketet distribueras inga tillgångar från de refererade ASP.NET Core NuGet-paket med programmet – det ASP.NET delade ramverket core innehåller dessa tillgångar. Tillgångarna i det delade ramverket är förkompilerade för att förbättra programmets starttid. Mer information finns i Det delade ramverket.

Följande projektfil refererar till Microsoft.AspNetCore.App metapaketet för ASP.NET Core och representerar en typisk ASP.NET Core 2.2-mall:

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

  <PropertyGroup>
    <TargetFramework>netcoreapp2.2</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.App" />
  </ItemGroup>

</Project>

Föregående markering representerar en typisk ASP.NET Core 2.x-mall. Det anger inte något versionsnummer för paketreferensen Microsoft.AspNetCore.App . När versionen inte har angetts anges en implicit version av SDK: et, Microsoft.NET.Sdk.Webdvs. . Vi rekommenderar att du förlitar dig på den implicita version som anges av SDK och inte uttryckligen anger versionsnumret för paketreferensen. Om du har frågor om den här metoden lämnar du en GitHub-kommentar i Avsnittet om den Microsoft.AspNetCore.App implicita versionen.

Den implicita versionen är inställd på major.minor.0 för bärbara appar. Mekanismen för delad ramverksdistribution kör appen på den senaste kompatibla versionen bland de installerade delade ramverken. För att garantera att samma version används i utveckling, testning och produktion kontrollerar du att samma version av det delade ramverket är installerad i alla miljöer. För fristående appar är det implicita versionsnumret inställt på det major.minor.patch delade ramverket som paketeras i det installerade SDK:t.

Att ange ett versionsnummer för referensen Microsoft.AspNetCore.App garanterar inte att den version av det delade ramverket kommer att väljas. Anta till exempel att version 2.2.1 har angetts, men att "2.2.3" är installerat. I så fall använder appen "2.2.3". Även om det inte rekommenderas kan du inaktivera uppgradering (patch och/eller mindre version). Mer information om roll-forward för dotnet-värd och hur du konfigurerar dess beteende finns i roll forward för dotnet-värd.

<Project Sdk måste anges till Microsoft.NET.Sdk.Web för att använda den implicita versionen Microsoft.AspNetCore.App. När <Project Sdk="Microsoft.NET.Sdk"> (utan avslutande .Web) används:

• Följande varning genereras:

  Varning NU1604: Projektberoendet Microsoft.AspNetCore.App innehåller inte en inkluderande lägre gräns. Inkludera en lägre bindning i beroendeversionen för att säkerställa konsekventa återställningsresultat.

• Det här är ett känt problem med .NET Core 2.1 SDK.

Uppdatera ASP.NET Core

Microsoft.AspNetCore.App är inte ett traditionellt paket som uppdateras från NuGet. Liknande Microsoft.NETCore.App representerar Microsoft.AspNetCore.App en delad körtid, som har särskild versionssemantik som hanteras utanför NuGet. Mer information finns i Paket, metapaket och ramverk.

Så här uppdaterar du ASP.NET Core:

• På utvecklingsdatorer och byggservrar: Ladda ned och installera .NET Core SDK.
• På distributionsservrar: Ladda ned och installera .NET Core-körningen.

Program kommer att vidarebefordras till den senaste installerade versionen vid omstart av programmet. Det är inte nödvändigt att uppdatera Microsoft.AspNetCore.App versionsnumret i projektfilen. Mer information finns i Ramverksberoende appar rullar framåt.

Om ditt program tidigare använde Microsoft.AspNetCore.Allläser du Migrera från Microsoft.AspNetCore.All till Microsoft.AspNetCore.App.