Partilhar via

Validação do pacote

  • Artigo

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

  • Valida que não há alterações significativas entre as versões.
  • Valida se o pacote tem o mesmo conjunto de APIs públicas para todas as diferentes implementações específicas de tempo de execução.
  • Deteta quaisquer furos de aplicabilidade.

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

Habilitar tarefa do MSBuild

Você habilita a validação de 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 Propriedades de validação de pacote.

Tipos de validadores

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 lançada anteriormente do seu pacote.
  • O validador de tempo de execução compatível valida se os assemblies de implementação específicos do tempo de execução são compatíveis entre si e com os assemblies em tempo de compilação.
  • O validador de estrutura compatível valida que o código compilado em relação a uma estrutura pode ser executado em relação a todas as outras em um pacote de multisegmentação.

Suprimir avisos de compatibilidade

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