Compartilhar via


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:

Suprimir avisos de compatibilidade

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