ASP.NET Core Blazor용 트리머 구성
참고 항목
이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.
Important
이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.
현재 릴리스는 이 문서의 .NET 9 버전을 참조 하세요.
이 문서에서는 앱을 빌드할 때 IL(중간 언어) 트리머를 제어하는 Blazor 방법을 설명합니다.
Blazor WebAssembly에서 IL(중간 언어) 트리밍을 수행하여 게시된 출력값의 크기를 줄입니다. 트리밍은 앱을 게시할 때 발생합니다.
트리밍은 게시된 앱에 해로운 영향을 줄 수 있습니다. 리플렉션을 사용하는 앱에서는 IL 트리머가 런타임 리플렉션에 필요한 형식을 결정하고 트리밍할 수 없는 경우가 많습니다. 예를 들어 interop에 대한 JS 복잡한 프레임워크 형식(예: KeyValuePairinterop)은 트리밍될 수 있으며 런타임에 interop 호출에 JS 사용할 수 없습니다. 이러한 경우 사용자 고유의 사용자 지정 형식을 만드는 것이 좋습니다. 또한 IL 트리머는 런타임에 앱의 동적 동작에 반응할 수 없습니다. 트리밍된 앱이 배포된 후 올바르게 작동하도록 하려면 개발하는 동안 게시된 출력을 자주 테스트하세요.
구성
IL 트리머를 구성하려면 다음 주제에 대한 지침을 포함하는 .NET 기본 사항 설명서의 트리밍 옵션 문서를 참조하세요.
- 프로젝트 파일에서
<PublishTrimmed>속성을 사용하여 전체 앱에 대해 트리밍을 사용하지 않도록 설정합니다. - IL 트리머가 적극적으로 사용하지 않는 IL을 삭제하는 방법을 제어합니다.
- IL 트리머가 특정 어셈블리를 트리밍하지 않도록 합니다.
- 트리밍을 위한 “루트” 어셈블리.
- 프로젝트 파일에서
<SuppressTrimAnalysisWarnings>속성을false로 설정하여 반영된 형식에 대한 경고를 표시합니다. - 기호 트리밍 및 디버거 지원을 제어합니다.
- 프레임워크 라이브러리 기능을 트리밍하기 위한 IL 트리머 기능을 설정합니다.
기본 트리머 세분성
앱partial의 기본 트리머 세분성은 Blazor . 모든 어셈블리를 트리밍하려면 앱의 프로젝트 파일에서 세분성을 full 변경합니다.
<ItemGroup>
<TrimMode>full</TrimMode>
</ItemGroup>
자세한 내용은 트리밍 옵션(.NET 설명서)을 참조하세요.
추가 리소스
ASP.NET Core