학습
학습 경로
C#을 사용하여 .NET 애플리케이션 빌드 - Training
.NET은 다양한 유형의 애플리케이션을 빌드하기 위한 무료, 크로스 플랫폼, 오픈 소스 개발자 플랫폼입니다. .NET을 사용하면 다국어, 편집기 및 라이브러리를 사용하여 웹, 모바일, 데스크톱, 게임 및 IoT를 빌드할 수 있습니다.
Visual Studio 2019부터 C++/CLI 프로젝트는 .NET을 대상으로 지정할 수 있습니다. 이 지원을 통해 .NET Framework에서 .NET으로 C++/CLI interop 계층을 사용하여 Windows 데스크톱 애플리케이션을 포팅할 수 있습니다. 이 문서에서는 C++/CLI 프로젝트를 .NET Framework에서 .NET으로 포팅하는 방법을 설명합니다.
.NET Framework에 비해 C++/CLI 프로젝트 및 .NET에는 몇 가지 중요한 제한 사항이 있습니다.
-clr:pure
또는 -clr:safe
컴파일을 지원하지 않습니다. 최신 -clr:netcore
옵션(.NET Framework의 -clr
과 동일)만 지원합니다.C++/CLI 프로젝트를 .NET으로 포팅하려면 .vcxproj 파일을 다음과 같이 변경합니다. C++/CLI 프로젝트가 SDK 스타일의 프로젝트 파일을 사용하지 않기 때문에 이 마이그레이션 단계는 다른 프로젝트 형식에 필요한 단계와 다릅니다.
<CLRSupport>true</CLRSupport>
속성을 <CLRSupport>NetCore</CLRSupport>
로 바꿉니다. 이 속성은 주로 구성별 속성 그룹에 있으므로 여러 위치에서 바꿔야 할 수 있습니다.<TargetFrameworkVersion>
속성을 <TargetFramework>net8.0</TargetFramework>
로 바꿉니다. 태그와 값을 변경해야 합니다.<Reference Include="System" />
같은 System
, System.Data
, System.Windows.Forms
및 System.Xml
에 대한 .NET Framework 참조를 제거합니다. .NET SDK 어셈블리는 <CLRSupport>NetCore</CLRSupport>
를 사용할 때 자동으로 참조됩니다..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를 사용하지 않고 C++/CLI 프로젝트를 빌드할 수도 있습니다. cl.exe 및 link.exe를 사용하여 .NET Core용 C++CLI 프로젝트를 직접 빌드하려면 다음 단계를 수행하세요.
컴파일하는 경우 -clr:netcore
를 cl.exe에 전달하세요.
필요한 .NET Core 참조 어셈블리를 참조하세요.
연결할 때 ijwhost.lib을 찾을 수 있도록 .NET 앱 호스트 디렉터리를 LibPath
로 제공합니다.
.NET 앱 호스트 디렉터리에서 ijwhost.dll을 프로젝트의 출력 디렉터리로 복사하세요.
관리 코드를 실행하는 애플리케이션의 첫 번째 구성 요소에 대한 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/런타임 문제를 참조하세요.
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.
학습
학습 경로
C#을 사용하여 .NET 애플리케이션 빌드 - Training
.NET은 다양한 유형의 애플리케이션을 빌드하기 위한 무료, 크로스 플랫폼, 오픈 소스 개발자 플랫폼입니다. .NET을 사용하면 다국어, 편집기 및 라이브러리를 사용하여 웹, 모바일, 데스크톱, 게임 및 IoT를 빌드할 수 있습니다.