Validação de pacotes

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

• Valida que não há alterações significativas nas 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 todas as falhas de aplicativos.

Você pode executar a validação de pacotes como uma tarefa do MSBuild ou usando a ferramenta global Microsoft.DotNet.ApiCompat.Tool. Se seu aplicativo não for empacotável, use a validação de assembly em vez disso.

Habilitar a tarefa MSBuild

Você habilita a validação de pacote em seu projeto .NET definindo a propriedade EnablePackageValidation 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 tarefa Pack. Algumas verificações adicionais podem ser executadas definindo outras propriedades do MSBuild. Para obter mais informações, confira Propriedades de validação do pacote.

Tipos de validador

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

• 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 entre si 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 todas as outras em um pacote de vários destinos.

Suprimir avisos de compatibilidade

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