패키지 유효성 검사

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

• 버전 간에 호환성이 손상되는 변경이 없는지 확인합니다.
• 패키지에 모든 다른 런타임별 구현에 대해 동일한 공용 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 작업의 일환으로 패키지를 확인하는 세 가지 유효성 검사기가 있습니다.

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

호환성 경고 표시 안 함

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