Teste de unidades

Os aplicativos multiplataforma devem ser testados, pois seriam usados no mundo real para melhorar sua qualidade, confiabilidade e desempenho. Muitos tipos de teste devem ser executados em um aplicativo, incluindo teste de unidade, teste de integração e teste de interface do usuário. O teste de unidade é a forma mais comum e é essencial para criar aplicativos de alta qualidade.

Um teste de unidade pega uma pequena unidade de um aplicativo, normalmente um método, isola-a do restante do código e verifica se ela se comporta conforme o esperado. Seu objetivo é verificar se cada unidade de funcionalidade tem o desempenho esperado, para que os erros não se propaguem pelo aplicativo. Detetar um bug onde ele ocorre é mais eficiente do que observar o efeito de um bug indiretamente em um ponto secundário de falha.

Os testes de unidade normalmente devem usar o padrão arrange-act-assert:

Step Description
Arrange Inicialize objetos e defina o valor dos dados que são passados para o método em teste.
Act Invoque o método em teste com os argumentos necessários.
Assert Verifique se a ação do método em teste se comporta conforme o esperado.

Esse padrão garante que os testes de unidade sejam legíveis, autodescritos e consistentes.

O teste de unidade tem o efeito mais significativo na qualidade do código quando é parte integrante do seu fluxo de trabalho de desenvolvimento de software. Os testes de unidade podem atuar como documentação de projeto e especificações funcionais para seu aplicativo. Assim que um método tiver sido escrito, testes de unidade devem ser escritos para verificar o comportamento do método em resposta a casos de dados de entrada padrão, limite e incorretos e verificar quaisquer suposições explícitas ou implícitas feitas pelo código. Alternativamente, com o desenvolvimento orientado a testes, os testes de unidade são escritos antes do código.

Important

Os testes unitários são muito eficazes contra a regressão. Ou seja, funcionalidade que costumava funcionar, mas foi perturbada por uma atualização defeituosa.

xUnit é a estrutura de teste recomendada para aplicativos .NET MAUI.

Adicionar testes xUnit a uma solução .NET MAUI

Para adicionar testes xUnit à sua solução .NET MAUI, pode seguir uma destas opções:

  • Use o Visual Studio para adicionar um novo projeto de teste xUnit à sua solução.

    OR

  • Use a CLI do .NET para criar um novo projeto de teste xUnit e adicioná-lo à sua solução. Para obter mais informações, consulte Teste de unidade C# no .NET usando dotnet test e xUnit.

O arquivo de projeto (.csproj) para o projeto de teste xUnit será semelhante ao exemplo a seguir:

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

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>

    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="coverlet.collector" Version="6.0.2" />
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
    <PackageReference Include="xunit" Version="2.9.2" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2" />
  </ItemGroup>

  <ItemGroup>
    <Using Include="Xunit" />
  </ItemGroup>

</Project>

A $(TargetFramework) propriedade build especifica a estrutura de destino para o projeto de teste. Esta será a versão mais recente do .NET instalada na sua máquina.

O pacote xunit inclui pacotes filho que contêm o framework de testes em si e os analisadores Roslyn, que detetam problemas comuns nos testes de unidade. Os pacotes xunit.runner.visualstudio e Microsoft.NET.Test.Sdk são necessários para executar os testes de unidade no Visual Studio, assim como com o comando dotnet test. Os coverlet.collector pacotes permitem recolher cobertura de código. Se você não pretende coletar cobertura de código, você pode remover esta referência de pacote. Para obter mais informações sobre cobertura de código para teste de unidade, consulte Usar cobertura de código para teste de unidade.

Há duas abordagens principais para estruturar seu aplicativo para teste de unidade:

  1. O código que você testará está em um projeto de biblioteca de classes .NET MAUI.
  2. O código que você testará está em um projeto de aplicativo .NET MAUI.

Cada abordagem requer uma configuração específica.

Configurar um projeto de biblioteca de classes .NET MAUI para teste de unidade

Com essa abordagem, o código que pretende testar por unidades está em um projeto de biblioteca de classes .NET MAUI que é utilizado pelo projeto da sua aplicação .NET MAUI. Para escrever testes de unidade na biblioteca de classes .NET MAUI, será necessário atualizar as estruturas de destino usadas pelo projeto. Isso pode ser conseguido adicionando o valor da propriedade build do arquivo de projeto de teste xUnit ($(TargetFramework)) à propriedade build no arquivo de projeto da biblioteca de $(TargetFrameworks) classes .NET MAUI:

<TargetFrameworks>net9.0;net9.0-android;net9.0-ios;net9.0-maccatalyst</TargetFrameworks>

Neste exemplo, um valor de net9.0 foi adicionado à propriedade build no arquivo de projeto da biblioteca de classes .NET MAUI.

Em seguida, você deve adicionar uma referência ao seu projeto de biblioteca de classes .NET MAUI do seu projeto de teste xUnit.

Configurar um projeto de aplicativo .NET MAUI para teste de unidade

Com esta abordagem, o código que o utilizador deseja testar unitariamente está num projeto de aplicação .NET MAUI. Para escrever testes de unidade no projeto de aplicativo .NET MAUI, será necessário atualizar as estruturas de destino usadas pelo projeto. Isso pode ser alcançado ao adicionar o valor da propriedade de construção do arquivo de projeto de teste xUnit ($(TargetFramework).csproj) à propriedade de construção no arquivo de projeto do aplicativo .NET MAUI :

<TargetFrameworks>net9.0;net9.0-android;net9.0-ios;net9.0-maccatalyst</TargetFrameworks>

Neste exemplo, um valor de net9.0 foi adicionado à propriedade de build $(TargetFrameworks) no arquivo de projeto do aplicativo .NET MAUI.

Também é necessário modificar seu projeto de aplicativo .NET MAUI para que ele não produza um executável para a estrutura de destino usada pelo projeto de teste xUnit. Isso pode ser conseguido adicionando uma condição à $(OutputType) propriedade build no arquivo de projeto do aplicativo .NET MAUI:

<OutputType Condition="'$(TargetFramework)' != 'net9.0'">Exe</OutputType>

Neste exemplo, o projeto de aplicativo .NET MAUI só produz um executável quando a estrutura de destino não é net9.0.

Em seguida, você deve adicionar uma referência ao seu projeto de aplicativo .NET MAUI do seu projeto de teste xUnit.

Escrever testes de unidade

O xUnit suporta dois tipos diferentes de testes de unidade:

Tipo de ensaio Attribute Description
Facts Fact Testes que são sempre verdadeiros, que testam condições invariantes.
Teorias Theory Testes que só são verdadeiros para um determinado conjunto de dados.

Os testes de unidade devem ser colocados no vosso projeto de teste xUnit e decorados com o atributo [Fact] ou [Theory]. O exemplo a seguir mostra testes de unidade que usam o [Fact] atributo:

namespace MyUnitTests
{
    public class MyTests
    {
        [Fact]
        public void PassingTest()
        {
            Assert.AreEqual(4, 2+2);
        }

        [Fact]
        public void FailingTest()
        {
            Assert.AreEqual(5, 2+2);
        }
    }
}

Neste exemplo, os testes representam um teste deliberadamente aprovado e reprovado.

O exemplo a seguir mostra testes de unidade que usam o [Theory] atributo:

namespace MyUnitTests
{
    public class MyTests
    {
        [Theory]
        [InlineData(3)]
        [InlineData(4)]
        [InlineData(5)]
        public void MyTheoryTest(int value)
        {
            Assert.True(value % 2 == 1);
        }
    }
}

Neste exemplo, embora haja apenas um método de teste, na verdade existem três testes porque a teoria será executada uma vez para cada item de dados.

Tip

Teste uma operação com cada teste unitário. À medida que a complexidade de um teste se expande, torna-se a verificação desse teste mais difícil. Ao limitar um teste de unidade a uma única preocupação, você pode garantir que seus testes sejam repetíveis, isolados e tenham um tempo de execução mais curto. Para obter mais informações, consulte Práticas recomendadas de teste de unidade.

Executar testes de unidade

Os testes de unidade podem ser executados no Test Explorer no Visual Studio ou com o dotnet test comando. Para obter informações sobre o Gerenciador de Testes, consulte Executar testes de unidade com o Gerenciador de Testes. Para obter informações sobre o comando dotnet test, consulte Unit testing C# in .NET using dotnet test and xUnit e dotnet test.

Executar testes de unidade usando executores de dispositivo

Os testes unitários também podem ser executados num dispositivo com um dispositivo executante. Um executor de dispositivos é uma aplicação de execução de testes que fornece uma interface visual de execução e pontos de ligação para executar testes a partir da CLI com XHarness. Para mais informações, consulte a wiki dos gestores de dispositivos de teste.

Executar testes numa aplicação de plataforma

O .NET 11 inclui modelos de projetos de teste Microsoft.Testing.Platform (MTP) para Android e plataformas Apple:

Template Plataforma Processo de teste
androidtest Android Um processo de aplicação num dispositivo ou emulador ligado
iostest iOS Um processo de aplicação num dispositivo ou simulador ligado
tvostest tvOS Um processo de aplicação num dispositivo ou simulador ligado
macostest macOS Um processo de uma aplicação para computador
maccatalysttest Mac Catalyst Um processo de uma aplicação de desktop

Cada modelo cria um projeto MSTest que corre numa aplicação de plataforma. As ferramentas de teste da plataforma comunicam os resultados a dotnet test através do MTP. Para mais informações sobre o MTP, consulte Microsoft. Visão geral do Testing.Platform (MTP).

Por exemplo, use os seguintes comandos para criar e executar um projeto de teste Android:

dotnet new androidtest -n MyAndroidTests
dotnet test --project ./MyAndroidTests/MyAndroidTests.csproj

Inicia um emulador Android ou liga um dispositivo Android antes de executares o comando de teste. O comando constrói e instala a aplicação de teste, e depois executa os testes no processo da aplicação com instrumentação Android.

Os projetos de teste de plataforma são diferentes dos projetos xUnit descritos anteriormente neste artigo. Um projeto xUnit comum visa um runtime .NET host e testa código que não requer um processo de aplicação de plataforma. Use um projeto de teste de plataforma quando o teste tiver de usar APIs e comportamentos Android, iOS, tvOS, macOS ou Mac Catalyst. Para mais informações sobre a forma MTP do comando test, consulte dotnet test Microsoft. Testing.Platform.

Consulte também