영어로 읽기

다음을 통해 공유


C++/CLI 프로젝트를 .NET으로 포팅하는 방법

Visual Studio 2019부터 C++/CLI 프로젝트는 .NET을 대상으로 지정할 수 있습니다. 이 지원을 통해 .NET Framework에서 .NET으로 C++/CLI interop 계층을 사용하여 Windows 데스크톱 애플리케이션을 포팅할 수 있습니다. 이 문서에서는 C++/CLI 프로젝트를 .NET Framework에서 .NET으로 포팅하는 방법을 설명합니다.

C++/CLI .NET Core 제한 사항

.NET Framework에 비해 C++/CLI 프로젝트 및 .NET에는 몇 가지 중요한 제한 사항이 있습니다.

  • C++/CLI 프로젝트를 실행 파일로 컴파일하는 것은 지원되지 않습니다. DLL로 컴파일해야 합니다.
  • .NET에 대한 C++/CLI 지원은 Windows 전용입니다.
  • C++/CLI 프로젝트는 .NET Standard를 대상으로 할 수 없습니다.
  • C++/CLI 프로젝트는 최신 SDK 스타일 프로젝트 파일 형식을 지원하지 않습니다. 대신 C++/CLI 프로젝트는 다른 Visual Studio C++ 프로젝트에서 사용하는 것과 동일한 .vcxproj 파일 형식을 사용합니다.
  • C++/CLI 프로젝트는 여러 .NET 플랫폼을 대상으로 할 수 없습니다. .NET과 .NET Framework 모두에 대해 C++/CLI 프로젝트를 빌드해야 하는 경우 별도의 프로젝트 파일을 사용합니다.
  • .NET은 -clr:pure 또는 -clr:safe 컴파일을 지원하지 않습니다. 최신 -clr:netcore 옵션(.NET Framework의 -clr과 동일)만 지원합니다.

C++/CLI 프로젝트 이식

C++/CLI 프로젝트를 .NET으로 포팅하려면 .vcxproj 파일을 다음과 같이 변경합니다. C++/CLI 프로젝트가 SDK 스타일의 프로젝트 파일을 사용하지 않기 때문에 이 마이그레이션 단계는 다른 프로젝트 형식에 필요한 단계와 다릅니다.

  1. <CLRSupport>true</CLRSupport> 속성을 <CLRSupport>NetCore</CLRSupport>로 바꿉니다. 이 속성은 주로 구성별 속성 그룹에 있으므로 여러 위치에서 바꿔야 할 수 있습니다.
  2. <TargetFrameworkVersion> 속성을 <TargetFramework>net8.0</TargetFramework>로 바꿉니다. 태그와 값을 변경해야 합니다.
  3. <Reference Include="System" /> 같은 System, System.Data, System.Windows.FormsSystem.Xml에 대한 .NET Framework 참조를 제거합니다. .NET SDK 어셈블리는 <CLRSupport>NetCore</CLRSupport>를 사용할 때 자동으로 참조됩니다.
  4. .NET에서 사용할 수 없는 API를 제거하려면 필요에 따라 .cpp 파일에서 API 사용을 업데이트합니다. C++/CLI 프로젝트는 상당히 얇은 interop 계층이기 때문에 필요한 변경 내용이 많지 않을 수도 있습니다. .NET 이식성 분석기를 사용하여 C++/CLI 이진 파일에서 사용하는 지원되지 않는 .NET API를 식별할 수 있습니다.
  5. 프로젝트가 실행 파일인 경우 다음 단계를 수행합니다.
    1. 프로젝트 형식을 라이브러리로 변경합니다.
    2. 새 .NET 실행 파일 프로젝트를 만듭니다.
    3. .NET 실행 파일 프로젝트에서 C++/CLI .NET 라이브러리 참조를 추가합니다.

WPF 및 Windows Forms 사용법

.NET C++/CLI 프로젝트는 Windows Forms 및 WPF API를 사용할 수 있습니다. 해당 Windows 데스크톱 API를 사용하려면 UI 라이브러리에 명시적 프레임워크 참조를 추가해야 합니다. Windows 데스크톱 API를 사용하는 SDK 스타일 프로젝트는 Microsoft.NET.Sdk.WindowsDesktop SDK를 사용하여 필요한 프레임워크 라이브러리를 자동으로 참조합니다. C++/CLI 프로젝트는 SDK 스타일 프로젝트 형식을 사용하지 않으므로 .NET Core를 대상으로 할 때 명시적 프레임워크 참조를 추가해야 합니다.

Windows Forms API를 사용하려면 다음 참조를 .vcxproj 파일에 추가합니다.

<!-- Reference all of Windows Forms -->
<FrameworkReference Include="Microsoft.WindowsDesktop.App.WindowsForms" />

WPF API를 사용하려면 다음 참조를 .vcxproj 파일에 추가합니다.

<!-- Reference all of WPF -->
<FrameworkReference Include="Microsoft.WindowsDesktop.App.WPF" />

Windows Forms 및 WPF API를 모두 사용하려면 다음 참조를 .vcxproj 파일에 추가합니다.

<!-- Reference the entirety of the Windows desktop framework:
     Windows Forms, WPF, and the types that provide integration between them -->
<FrameworkReference Include="Microsoft.WindowsDesktop.App" />

현재는 Visual Studio의 참조 관리자를 사용하여 해당 참조를 추가할 수 없습니다. 대신 프로젝트 파일을 수동으로 편집하여 업데이트합니다. Visual Studio에서 먼저 프로젝트를 언로드해야 합니다. Visual Studio Code 같은 다른 편집기를 사용할 수도 있습니다.

MSBuild를 사용하지 않고 빌드

MSBuild를 사용하지 않고 C++/CLI 프로젝트를 빌드할 수도 있습니다. cl.exelink.exe를 사용하여 .NET Core용 C++CLI 프로젝트를 직접 빌드하려면 다음 단계를 수행하세요.

  1. 컴파일하는 경우 -clr:netcorecl.exe에 전달하세요.

  2. 필요한 .NET Core 참조 어셈블리를 참조하세요.

  3. 연결할 때 ijwhost.lib을 찾을 수 있도록 .NET 앱 호스트 디렉터리를 LibPath로 제공합니다.

  4. .NET 앱 호스트 디렉터리에서 ijwhost.dll을 프로젝트의 출력 디렉터리로 복사하세요.

  5. 관리 코드를 실행하는 애플리케이션의 첫 번째 구성 요소에 대한 runtimeconfig.json 파일이 있는지 확인합니다. 최신 버전의 Visual Studio의 경우 runtime.config 파일이 자동으로 만들어지고 복사됩니다.

    이전 버전의 Visual Studio의 경우 애플리케이션에 네이티브 진입점이 있는 경우 .NET 런타임을 사용하도록 첫 번째 C++/CLI 라이브러리에 대해 다음 runtimeconfig.json 파일을 수동으로 만들어야 합니다. 관리 진입점에서 C++/CLI 라이브러리를 호출하는 경우 진입점 어셈블리에 런타임을 시작할 때 사용되는 파일이 있으므로 라이브러리에 runtimeconfig.json 파일이 필요하지 않습니다.

    {
       "runtimeOptions": {
          "tfm": "net8.0",
          "framework": {
          "name": "Microsoft.NETCore.App",
          "version": "8.0.0"
          }
       }
    }
    

참고

.NET 7 이상 버전을 대상으로 하는 C++/CLI 어셈블리는 항상 기본값 AssemblyLoadContext로 로드됩니다. 그러나 .NET 6 및 이전 버전에서는 C++/CLI 어셈블리가 매번 새 AssemblyLoadContext로 여러 번 로드될 수 있습니다. C++/CLI 어셈블리의 관리 코드가 처음으로 실행되는 경우:

  • 네이티브 호출자에서 온 경우 어셈블리가 별도의 AssemblyLoadContext에 로드됩니다.
  • 관리되는 호출자에서 온 경우 어셈블리는 일반적으로 기본값인 호출자와 동일하게 AssemblyLoadContext로 로드됩니다.

항상 C++/CLI 어셈블리를 기본값 AssemblyLoadContext로 로드하려면 진입점 어셈블리의 "initialize" 스타일 호출을 C++/CLI 어셈블리에 추가할 수 있습니다. 자세한 내용은 이 dotnet/런타임 문제를 참조하세요.