Validação de pacote

As ferramentas de validação de pacote permitem que você, como desenvolvedor de biblioteca, valide se os pacotes são consistentes e bem formados. Ele fornece as seguintes verificações:

• Valida que não há alterações significativas entre as versões.
• Valida que o pacote tem o mesmo conjunto de APIs públicas para todas as diferentes implementações específicas do runtime.
• Captura quaisquer buracos de aplicabilidade.

Você pode executar a validação de pacote como uma tarefa MSBuild ou usando a ferramenta global Microsoft.DotNet.ApiCompat.Tool. Se o aplicativo não for empacotado, use a validação do assembly .

Habilitar tarefa do MSBuild

Habilite a validação do pacote em seu projeto .NET definindo a EnablePackageValidation propriedade como true.

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

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

</Project>

EnablePackageValidation executa uma série de verificações após a Pack tarefa. Há algumas verificações adicionais que podem ser executadas definindo outras propriedades do MSBuild. Para obter mais informações, consulte as propriedades de validação do pacote.

Tipos de validador

Há três validadores diferentes que verificam seu pacote como parte da Pack tarefa:

• O validador de versão de linha de base valida seu projeto de biblioteca em relação a uma versão estável e lançada anteriormente do pacote.
• O validador de runtime compatível valida que os assemblies de implementação específicos do runtime são compatíveis uns com os outros e com os assemblies de tempo de compilação.
• O validador de estrutura compatível valida que o código compilado em uma estrutura pode ser executado em relação a todas as outras em um pacote de vários destinos.

Suprimir avisos de compatibilidade

Para obter informações sobre como suprimir avisos de compatibilidade, consulte Como suprimir.

Consulte também

• Propriedades de validação de pacote