패키지 유효성 검사

아티클
03/13/2024

패키지 유효성 검사 도구를 사용하면 라이브러리 개발자가 패키지가 일관되고 잘 구성되었는지 확인할 수 있습니다. 패키지 유효성 검사 도구는 다음과 같은 검사를 제공합니다.

버전 간에 호환성이 손상되는 변경이 없는지 확인합니다.
패키지에 모든 다른 런타임별 구현에 대해 동일한 공용 API 집합이 포함되어 있는지 확인합니다.
적용 가능성 빈 영역을 포착합니다.

MSBuild 작업으로 또는 Microsoft.DotNet.ApiCompat.Tool 전역 도구를 사용하여 패키지 유효성 검사를 실행할 수 있습니다. 앱을 압축할 수 없는 경우 어셈블리 유효성 검사를 대신 사용합니다.

MSBuild 사용

.NET 프로젝트의 패키지 유효성 검사는 EnablePackageValidation 속성을 true로 설정하여 사용하도록 설정합니다.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;net6.0</TargetFrameworks>
    <EnablePackageValidation>true</EnablePackageValidation>
  </PropertyGroup>

</Project>

EnablePackageValidation은 Pack 작업 후에 일련의 검사를 실행합니다. 다른 MSBuild 속성을 설정하여 실행할 수 있는 추가 검사도 있습니다. 자세한 내용은 패키지 유효성 검사 속성을 참조하세요.

유효성 검사기의 유형

Pack 작업의 일환으로 패키지를 확인하는 세 가지 유효성 검사기가 있습니다.

기준 버전 유효성 검사기는 이전에 출시된 안정적인 버전의 패키지를 기준으로 라이브러리 프로젝트의 유효성을 검사합니다.
호환되는 런타임 유효성 검사기는 런타임별 구현 어셈블리가 서로 간에 호환되고 컴파일 시간 어셈블리와 호환되는지 확인합니다.
호환되는 프레임워크 유효성 검사기는 하나의 프레임워크에 대해 컴파일된 코드가 다중 대상 패키지의 다른 모든 프레임워크에 대해서도 실행되는지 확인합니다.

호환성 경고 표시 안 함

호환성 경고를 표시하지 않는 방법에 대한 자세한 내용은 표시하지 않는 방법을 참조하세요.