ASP.NET Core 3.0에서 3.1로 마이그레이션

  • 아티클

작성자: Scott Addie

이 문서에서는 기존의 ASP.NET Core 3.0 프로젝트를 ASP.NET Core 3.1로 업데이트하는 방법을 설명합니다.

필수 조건

에서 .NET Core SDK 버전 업데이트 global.json

파일을 사용하여 global.json 특정 .NET Core SDK 버전을 대상으로 하는 경우 설치된 3.1 SDK 버전으로 속성을 업데이트 version 합니다. 예시:

{
  "sdk": {
-    "version": "3.0.101"
+    "version": "3.1.101"
  }
}

대상 프레임워크 업데이트

프로젝트 파일에서 TFM(대상 프레임워크 모니커)을 netcoreapp3.1로 업데이트합니다.

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

  <PropertyGroup>
-    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

</Project>

패키지 참조 업데이트

프로젝트 파일에서 각 Microsoft.AspNetCore.* 패키지 참조의 Version 특성을 3.1.0 이상으로 업데이트합니다. 예시:

<ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.0.0" Condition="'$(Configuration)' == 'Debug'" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.1" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="3.1.1" Condition="'$(Configuration)' == 'Debug'" />
</ItemGroup>

Docker 이미지 업데이트

Docker를 사용하는 앱의 경우 ASP.NET Core 3.1을 포함하는 기본 이미지를 사용합니다. 예시:

docker pull mcr.microsoft.com/dotnet/aspnet:3.1

HTTP SameSite에 대한 cookie 특성 구현은 ASP.NET Core 3.0과 3.1 사이에서 변경되었습니다. 수행할 작업은 다음 리소스를 참조하세요.

Visual Studio를 사용하여 게시

.pubxml 파일에서 TargetFramework를 3.1으로 업데이트합니다.

- <TargetFramework>netcoreapp3.0</TargetFramework>
+ <TargetFramework>netcoreapp3.1</TargetFramework>

호환성이 손상되는 변경 검토

버전 3.0에서 3.1로 마이그레이션에 대한 호환성이 손상되는 변경의 .NET Core, ASP.NET Core 및 Entity Framework Core에서 3.0-3.1의 호환성이 손상되는 변경을 검토하세요.

선택적 변경 내용

다음은 변경은 선택 사항입니다.

구성 요소 태그 도우미 사용

ASP.NET Core 3.1은 Component 태그 도우미를 도입합니다. 태그 도우미는 Blazor 프로젝트의 RenderComponentAsync<TComponent> HTML 도우미 메서드를 바꿀 수 있습니다. 예시:

- @(await Html.RenderComponentAsync<Counter>(RenderMode.ServerPrerendered, new { IncrementAmount = 10 }))
+ <component type="typeof(Counter)" render-mode="ServerPrerendered" param-IncrementAmount="10" />

자세한 내용은 ASP.NET Core Razor 구성 요소 미리 렌더링 및 통합을 참조하세요.

ASP.NET Core 모듈(ANCM)

Visual Studio를 설치할 때 ANCM(ASP.NET Core 모듈)이 선택된 구성 요소가 아니거나 이전 버전의 ANCM이 시스템에 설치된 경우, 최신 .NET Core 호스팅 번들 설치 관리자(직접 다운로드)를 다운로드하고 설치 관리자를 실행합니다. 자세한 내용은 호스팅 번들을 참조하세요.