.NET Framework에서 .NET으로 코드를 포팅하기 위한 종속성 분석

  • 아티클

프로젝트에서 지원되지 않는 타사 종속성을 식별하려면 먼저 해당 종속성을 이해해야 합니다. 외부 종속성은 프로젝트에서 참조하지만 직접 빌드하지 않는 NuGet 패키지 또는 .dll 파일입니다.

코드를 .NET Standard 2.0 이하로 포팅하면 .NET Framework 및 .NET 모두에서 사용할 수 있습니다. 그러나 .NET Framework에서 라이브러리를 사용할 필요가 없는 경우 최신 버전의 .NET을 대상으로 지정하는 것이 좋습니다.

NuGet 패키지를 PackageReference로 마이그레이션

.NET에서는 NuGet 참조에 packages.config 파일을 사용할 수 없습니다. .NET 및 .NET Framework는 모두 PackageReference를 사용하여 패키지 종속성을 지정할 수 있습니다. packages.config를 사용하여 프로젝트의 패키지를 지정하는 경우 PackageReference 형식으로 변환합니다.

마이그레이션 방법에 대한 자세한 내용은 packages.config에서 PackageReference로 마이그레이션 문서를 참조하세요.

NuGet 패키지 업그레이드

프로젝트를 PackageReference 형식으로 마이그레이션한 후 패키지가 .NET과 호환되는지 확인해야 합니다.

먼저 패키지를 가능한 최신 버전으로 업그레이드합니다. Visual Studio의 NuGet 패키지 관리자 UI를 사용하면 됩니다. 최신 버전의 패키지 종속성은 .NET Core와 이미 호환될 가능성이 큽니다.

패키지 종속성 분석

변환 및 업그레이드된 패키지 종속성이 .NET Core에서 작동하는지 확인하지 않은 경우 다음과 같은 두 가지 방법으로 확인할 수 있습니다.

nuget.org 사용

패키지 페이지의 종속성 섹션 아래에 있는 nuget.org에서 각 패키지가 지원하는 TFM(대상 프레임워크 모니커)을 확인할 수 있습니다.

사이트를 사용하여 호환성을 쉽게 확인할 수 있지만, 일부 패키지의 종속성 정보는 사이트에 제공되지 않습니다.

NuGet 패키지 탐색기 사용

NuGet 패키지 자체는 플랫폼 관련 어셈블리를 포함하는 폴더 집합입니다. 따라서 패키지 내에 호환되는 어셈블리를 포함하는 폴더인지 확인합니다.

NuGet 패키지 폴더를 검사하는 가장 쉬운 방법은 NuGet 패키지 탐색기 도구를 사용하는 것입니다. 설치한 후 다음 단계를 사용하여 폴더 이름을 표시합니다.

  1. NuGet 패키지 탐색기를 엽니다.
  2. 온라인 피드에서 패키지 열기를 클릭합니다.
  3. 패키지의 이름을 검색합니다.
  4. 검색 결과에서 패키지 이름을 선택하고 열기를 클릭합니다.
  5. 오른쪽에서 lib 폴더를 확장하고 폴더 이름을 찾습니다.

netstandardX.Y, netX.Y 또는 netcoreappX.Y 패턴 중 하나를 사용하는 이름을 가진 폴더를 찾습니다.

이러한 값은 모두 .NET과 호환되는 .NET Standard, .NET, .NET Core의 버전에 매핑되는 TFM(대상 프레임워크 모니커)입니다.

Important

패키지에서 지원하는 TFM을 확인하는 경우 netstandard* 이외의 TFM은 .NET 5, .NET Core, .NET Framework와 같은 특정 .NET 구현을 대상으로 합니다. .NET 5부터 net* TFM(운영 체제 지정 없이)은 netstandard*를 이식 가능한 대상으로 효과적으로 대체합니다. 예를 들어 net5.0은 .NET 5 API 화면을 대상으로 하고 플랫폼 간 친숙하지만 net5.0-windows는 Windows 운영 체제에서 구현된 대로 .NET 5 API 화면을 대상으로 합니다.

.NET Framework 호환 모드

NuGet 패키지를 분석한 후 .NET Framework만 대상으로 하는 것이 확인되는 경우도 있습니다.

.NET Standard 2.0부터 .NET Framework 호환성 모드가 도입되었습니다. 이 호환 모드에서는 .NET Standard 및 .NET Core 프로젝트에서 .NET Framework 라이브러리를 참조할 수 있습니다. .NET Framework 라이브러리 참조는 라이브러리가 WPF(Windows Presentation Foundation) API를 사용하는 것처럼 모든 프로젝트에 대해 작동하지 않지만 많은 이식 시나리오를 차단 해제합니다.

프로젝트에서 .NET Framework를 대상으로 하는 NuGet 패키지(예:Huitian.PowerCollections)를 참조하는 경우 다음 예제와 유사한 패키지 대체 경고(NU1701)를 받습니다.

NU1701: Package ‘Huitian.PowerCollections 1.0.0’ was restored using ‘.NETFramework,Version=v4.6.1’ instead of the project target framework ‘.NETStandard,Version=v2.0’. This package may not be fully compatible with your project.

해당 경고는 패키지를 추가하고 해당 패키지를 프로젝트와 테스트하도록 빌드할 때마다 표시됩니다. 프로젝트가 예상대로 작동하는 경우 Visual Studio에서 패키지 속성을 편집하거나 즐겨 찾는 코드 편집기에서 프로젝트 파일을 수동으로 편집하여 해당 경고를 제거할 수 있습니다.

프로젝트 파일을 편집하여 경고를 제거하려면 경고를 제거하려는 패키지에 대한 PackageReference 항목을 찾고 NoWarn 특성을 추가합니다. NoWarn 특성은 모든 경고 ID의 쉼표로 구분된 목록을 허용합니다. 다음 예제는 프로젝트 파일을 수동으로 편집하여 Huitian.PowerCollections 프로젝트에 대한 NU1701 경고를 제거하는 방법을 보여 줍니다.

<ItemGroup>
  <PackageReference Include="Huitian.PowerCollections" Version="1.0.0" NoWarn="NU1701" />
</ItemGroup>

Visual Studio에서 컴파일러 경고를 제거하는 방법에 대한 자세한 내용은 NuGet 패키지에 대한 경고 표시 안 함을 참조하세요.

NuGet 패키지가 .NET에서 실행되지 않는 경우

종속된 NuGet 패키지가 .NET Core에서 실행되지 않을 경우 수행할 수 있는 몇 가지가 있습니다.

  • 프로젝트가 오픈 소스이고 GitHub 같은 곳에 호스트된 경우 개발자가 직접 참여하도록 할 수 있습니다.
  • nuget.org에서 작성자에게 직접 문의할 수 있습니다. 패키지를 검색하고 패키지 페이지의 왼쪽에서 연락처 소유자를 클릭합니다.
  • 사용하던 패키지와 동일한 작업을 수행하는 .NET Core에서 실행되는 다른 패키지를 찾을 수도 있습니다.
  • 패키지가 수행하고 있는 코드를 직접 작성해볼 수 있습니다.
  • 적어도 패키지의 호환 버전을 사용할 수 있을 때까지는 앱의 기능을 변경하여 패키지에 대한 종속성을 없앨 수 있습니다.

오픈 소스 프로젝트 유지 관리자와 NuGet 패키지 게시자는 종종 지원자입니다. 지정된 도메인을 중요하게 여기기 때문에 참여하고, 자유롭게 수행하고, 종종 다른 주간 작업을 갖습니다. .NET Core 지원에 대해 문의하는 경우 주의해야 합니다.

이 방법으로 문제를 해결할 수 없는 경우 나중에 .NET Core로 이식해야 할 수 있습니다.

.NET 팀은 .NET Core를 지원하기 위해 어떤 라이브러리가 가장 중요한지 알고자 합니다. 사용하고 싶은 라이브러리에 대해 dotnet@microsoft.com으로 메일을 보낼 수 있습니다.

비 NuGet 종속성 분석

파일 시스템의 DLL처럼, NuGet 패키지가 아닌 종속성이 있을 수 있습니다. .NET 업그레이드 도우미의 이진 분석 기능을 사용하여 해당 종속성의 이식성을 확인할 수 있습니다.

다음 단계