ASP.NET Core 2.1 Preview 버전 적용 방법
오늘(2018-01-09) 기준으로 ASP.NET Core 정식 버전은 2.0.1입니다. 로드맵 상으로는,
ASP.NET Core Schedule and Roadmap
; https://github.com/aspnet/Home/wiki/Roadmap
2.1 정식 버전이 올해 1 또는 2분기에 나올 예정이지만 2.1 Preview 버전의 경우에는 이미 daily-build를 통해 공개하고 있습니다. 만약 2.1 Preview 버전을 적용하고 싶다면 아래의 문서에 설명한 방법에 따라,
ASP.NET Core
; https://github.com/aspnet/Home
설정을 하면 됩니다.
위의 글을 정리해 보면, 우선 .NET Core 2.1 관련 개발 환경을 인식하기 위해 .NET Core SDK 2.1 Preview 버전을 설치해야 합니다.
dotnet/cli
; https://github.com/dotnet/cli#installers-and-binaries
Latest Daily Build - Windows x64
; https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x64.exe
Latest Daily Build - Windows x86
; https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x86.exe
이후의 설명을 위해 간단하게 .NET Core (또는 .NET Framework) 기반으로 ASP.NET Core 웹 응용 프로그램을 만들어 보겠습니다.
(2018-01-09 기준) 기본적으로 ASP.NET Core 프로젝트는 다음과 같이 2.0.1 버전으로 의존성을 가집니다.
이에 2.1 Preview 적용을 하려면 NuGet.Config의 내용을 수정해야 하는데 시스템 전역적으로 설정하고 싶다면 다음의 경로에 있는 NuGet.Config을 수정하면 됩니다.
%APPDATA%\NuGet\NuGet.Config
또는, 지역적으로 설정하고 싶다면 대상 솔루션(.sln) 파일과 같은 폴더에 다음과 같은 NuGet.Config을 만들어 줍니다.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<clear />
<add key="AspNetVNext" value="https://dotnet.myget.org/F/aspnetcore-dev/api/v3/index.json" />
<add key="NuGet.org" value="https://api.nuget.org/v3/index.json" />
</packageSources>
</configuration>
이제, ASP.NET Core 웹 프로젝트의 참조를 수정해야 하는데, .csproj 파일을 열어 버전을 다음과 같은 식으로 직접 편집해 줍니다.
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netcoreapp2.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<Folder Include="wwwroot\" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="Microsoft.AspNetCore.All" Version="2.1.0-*" />
</ItemGroup>
<ItemGroup>
<DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="2.0.1" />
</ItemGroup>
</Project>
여기서 한가지 문제가 있는데, 아직(2018-01-09) Microsoft.AspNetCore.All의 패키지가 완벽하지 않아서 다음과 같이 2개의 개별 참조로 바꿔야 합니다.
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netcoreapp2.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<Folder Include="wwwroot\" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="Microsoft.AspNetCore" Version="2.1.0-*" />
<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.1.0-*" />
</ItemGroup>
<ItemGroup>
<DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="2.0.1" />
</ItemGroup>
</Project>
물론, .csproj 파일을 직접 수정하지 않고 NuGet 패키지 관리자 콘솔에서 다음과 같은 식의 명령을 내려도 됩니다.
Install-Package Microsoft.AspNetCore.Mvc -Version 2.1.0-preview1-28031 -Source https://dotnet.myget.org/F/aspnetcore-dev/api/v3/index.json
하지만 이런 경우에는 -Version 인자에 정확한 버전을 표기해야 하는데, daily-build에 저런 식으로 버전을 명시해서 유지 보수하는 것은 그다지 권장되지 않으므로 .csproj 파일을 수정해 "2.1.0-*"과 같은 식으로 지정하는 것이 더 권장됩니다.
참고로, 버전 문자열은 다음의 사이트에서 구할 수 있습니다.
dotnet-core - Microsoft.NETCore.App
; https://dotnet.myget.org/feed/dotnet-core/package/nuget/Microsoft.NETCore.App
aspnetcore-dev - Microsoft.AspNetCore
; https://dotnet.myget.org/feed/aspnetcore-dev/package/nuget/Microsoft.AspNetCore
나중에 만약 2.2 Preview 버전이 나와 그것을 적용하고 싶다면 이 글의 설명을 따르면 됩니다. 즉, 2.2 SDK Preview를 설치하고 NuGet.Config을 맞춰준 후 .csproj의 버전을 "2.2.0-*"과 같이 바꾸는 식입니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]