Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Gorjeta
Este conteúdo é um excerto do eBook, Enterprise Application Patterns Using .NET MAUI, disponível no .NET Docs ou como um PDF para download gratuito que pode ser lido offline.
As aplicações multiplataforma enfrentam problemas semelhantes às aplicações de ambiente de trabalho e baseadas na Web. Os usuários móveis serão diferentes por seus dispositivos, conectividade de rede, disponibilidade de serviços e vários outros fatores. Portanto, 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 a construção de aplicações de alta qualidade.
Um teste de unidade usa uma pequena unidade do 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.
O teste de unidade tem o efeito mais significativo na qualidade do código quando é parte integrante do fluxo de trabalho de desenvolvimento de software. Os testes de unidade podem atuar como documentação de projeto e especificações funcionais para uma aplicação. 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. Para obter mais informações sobre o desenvolvimento controlado por teste e como implementá-lo, consulte Passo a passo: desenvolvimento controlado por teste usando o Test Explorer..
Nota
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.
Os testes de unidade normalmente usam o padrão arrange-act-assert:
| Passo | Descrição |
|---|---|
| Dispor | Inicializa objetos e define o valor dos dados que são passados para o método em teste. |
| Ato | Invoca o método em teste com os argumentos necessários. |
| Asserção | Verifica 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.
Escolha um framework de teste e uma plataforma
Um framework de testes define os atributos, asserções e o ciclo de vida do teste que utilizas para escrever testes. Uma plataforma de testes descobre e executa esses testes e integra-se com o seu IDE, a linha de comandos e o pipeline de integração contínua (CI). VSTest e Microsoft.Testing.Platform (MTP) são plataformas de teste, não substitutas de frameworks como o MSTest.
Os seguintes frameworks suportam testes para lógica de aplicação .NET MAUI independente da plataforma:
| Framework | Documentação do framework | Configuração de MTP |
|---|---|---|
| MSTest | Visão geral do MSTest e Introdução ao MSTest. | Executa testes com MSTest e MSTest SDK. |
| NUnit | Comece com C# e NUnit. | Corredor NUnit. |
| xUnit.net | Comece com C# e xUnit.net. | xUnit.net v3 tem suporte integrado para MTP. xUnit.net v2 requer uma integração de terceiros que não é suportada pela xUnit.net ou pela Microsoft. |
| TUnit | Documentação do TUnit. | O TUnit é construído sobre MTP e não suporta VSTest. |
O MTP executa testes como aplicações executáveis. Para configuração de CLI, IDE e CI, veja Executar e depurar testes MTP. Com o SDK .NET 10 ou posterior, pode selecionar o modo MTP de dotnet test em global.json. Este modo requer MTP 1.7 ou posterior, e todos os projetos de teste selecionados devem suportar MTP. Não misture projetos baseados em VSTest e MTP na mesma execução de testes. As plataformas também utilizam diferentes opções de linha de comandos. Para mais detalhes, veja Testes com dotnet test.
Compreender os limites dos testes .NET MAUI
Para executar testes unitários na sua máquina de desenvolvimento, isole lógica de negócio, validação e visualize modelos a partir de dependências específicas da plataforma. Uma abordagem é colocar esse código numa biblioteca de classes .NET que tanto a aplicação como o projeto de teste referenciam. Alternativamente, configure a sua aplicação .NET MAUI ou biblioteca de classes para expor um alvo correspondente não específico da plataforma, como net10.0. Para um projeto de aplicação, esse destino deve produzir uma biblioteca em vez de um executável. Mantenha o código nativo de arranque e as implementações específicas da plataforma fora desse destino. Para configuração de projetos, veja .NET MAUI testes unitários.
Um projeto de teste não específico de uma plataforma não cria um contexto de aplicação .NET nativa MAUI. Substitua as dependências de navegação, despacho da interface e serviços de dispositivo por duplos de teste quando testar a lógica da aplicação. Estes testes não verificam a renderização nativa, as permissões dos dispositivos ou as implementações reais dos serviços que substitui.
Para testar código que requer APIs de plataforma ou handlers de controlo nativos, utilize um host de teste de plataforma compatível ou um executor no dispositivo. O MTP pode ser hospedado numa aplicação de plataforma, mas selecionar o MTP para um projeto de teste para computador não o transforma numa aplicação de testes de dispositivo. Para runners de dispositivo e opções de teste da plataforma, incluindo os requisitos de versão, veja testes unitários .NETMAUI. Para automatizar as interações com a aplicação implementada, veja Testes de UI com Appium. Faz esses testes nas plataformas que suportas.
Injeção de dependência e testes unitários
Para isolar o código sob teste, use injeção por construtor para fornecer duplos de teste para as suas dependências. Os doubles de teste, como fakes e mocks, implementam as mesmas interfaces dos serviços reais, mas fornecem um comportamento controlado para um teste. Para orientação arquitetónica, veja Injeção de dependências.
Por exemplo, o OrderDetailViewModel da aplicação eShop recebe IAppEnvironmentService, INavigationService, e ISettingsService dependências através do seu construtor. Forneça implementações de teste para as dependências que o teste exerce, em vez de chamar serviços web reais ou APIs de dispositivos.
Os testes do modelo de visualização do catálogo da eShop mostram uma configuração completa: constroem um AppEnvironmentService com serviços simulados, obtêm esses serviços e passam-no para o modelo de visualização juntamente com um serviço de navegação simulado. Utilize os testes de exemplo mantidos para o código completo de construtor e inicialização. Substituir dependências de serviço isola a lógica da aplicação; não remove requisitos nativos de outras partes do código que o teste chama.
Testando aplicativos MVVM
Quando os modelos e modelos de vista não requerem um contexto de aplicação nativo, teste-os com os mesmos frameworks e técnicas que usa para outras classes .NET. Alguns padrões típicos das classes de modelo e modelo de vista beneficiam de técnicas específicas de testes unitários.
Gorjeta
Teste um comportamento em cada teste unitário. Para manter os testes repetíveis, isolados e fáceis de diagnosticar, limite cada teste a uma única preocupação. Para mais orientações, consulte as melhores práticas de testes unitários com .NET.
Não se sinta tentado a fazer um teste de unidade exercitar mais do que um aspeto do comportamento da unidade. Isso leva a testes difíceis de ler e atualizar. Também pode gerar confusão ao interpretar uma falha.
A aplicação multiplataforma eShop usa MSTest. No MSTest, candidate-se TestClass à classe de teste e TestMethod a cada método de teste. Para atributos, assinaturas e orientações do ciclo de vida, veja Escrever testes com o MSTest.
Para executar o mesmo teste com diferentes entradas, combine TestMethod com DataRow para dados em linha ou DynamicData para dados fornecidos por um membro. Estes atributos disponibilizam casos de teste; não são estruturas de teste separadas nem alternativas a TestMethod. O atributo legado DataSource está disponível apenas para o .NET Framework, não para projetos .NET modernos ou .NET MAUI. Para opções suportadas, consulte Testes orientados por dados no MSTest.
Testando a funcionalidade assíncrona
Os view models frequentemente invocam operações de serviço assíncronas. Para testar o resultado em vez de um estado intermédio, aguarde a operação antes de fazer a asserção. Escreva métodos MSTest assíncronos com MSTest 3.3 ou posterior que devolvam Task ou ValueTask. Não uses métodos async void de teste. Para assinaturas suportadas, consulte Escrever testes com o MSTest.
Por exemplo, ProductsPropertyIsNotNullAfterViewModelInitializationTest nos testes do modelo de vista do catálogo da eShop criam um modelo de vista com serviços simulados, aguardam InitializeAsync, e afirmam que Products não é nulo. O teste verifica a inicialização com dados controlados, não o comportamento do serviço web real do catálogo. Para a inicialização e o fluxo de navegação da aplicação, consulte Navegação.
Para comandos assíncronos, aguarde que a execução assíncrona do comando, através da API, termine antes de verificar o resultado. Só chamar ICommand.Execute não garante que o trabalho assíncrono tenha sido concluído. Para as APIs de comandos do MVVM Toolkit, veja AsyncRelayCommand.
Testando as implementações de INotifyPropertyChanged
A INotifyPropertyChanged interface permite que as visualizações reajam a alterações nos modelos e aos modelos de visualização. Para testar uma notificação, anexe um manipulador de eventos a PropertyChanged, altere a propriedade e verifique que o manipulador de eventos recebe o esperado PropertyName. Não trate uma notificação de propriedade não relacionada como sucesso.
O teste SettingForenamePropertyShouldRaisePropertyChanged nos testes do modelo de vista de validação da eShop demonstra este padrão. Subscreve o evento PropertyChanged do objeto Forename, define Forename.Value, e verifica uma notificação para Value.
Este teste verifica a interface de notificação. Não verifica se um binding XAML ou um controlo nativo é atualizado corretamente; cubra esses comportamentos com testes de interface.
Testando a comunicação baseada em mensagens
Para comunicação baseada em mensagens, use o Toolkit IMessengerdo MVVM , como WeakReferenceMessenger. Para o contrato de mensagens e exemplos da API, consulte Comunicar entre componentes pouco acoplados e MVVM Toolkit Messenger.
Para testar um publisher, regista um destinatário para o tipo de mensagem esperado, executa a operação e verifica que o destinatário recebe a carga útil esperada. Para testar um destinatário, envie uma mensagem conhecida e verifique o estado resultante do modelo de visualização. Aguarde comandos assíncronos antes de afirmar.
Para isolar os testes de mensagens, crie uma instância do messenger por teste e injete a mesma instância no código em teste. Se o código usar WeakReferenceMessenger.Default, desregistar os destinatários dos testes durante a limpeza e evitar que testes simultâneos interfiram com o estado do mensageiro partilhado. Referências fracas não garantem que um recetor seja recolhido pelo garbage collector antes do próximo teste. Para opções de limpeza e isolamento, consulte o ciclo de vida dos testes MSTest e Controlar a execução dos testes.
Nota
MessagingCenter foi preterido no .NET 10. Para novo código, use o MVVM Toolkit Messenger em vez disso.
Testando o tratamento de exceções
Para verificar se ações ou entradas inválidas lançam uma exceção, use as asserções de exceção do framework. No MSTest 3.8 ou posterior, Assert.Throws<T> aceita o tipo de exceção especificado ou um tipo derivado, enquanto Assert.ThrowsExactly<T> requer o tipo exato. Para código assíncrono, aguarde Assert.ThrowsAsync<T> ou Assert.ThrowsExactlyAsync<T> em vez de passar trabalho assíncrono para uma asserção síncrona. Para exemplos e APIs específicas de versão, consulte as asserções MSTest.
Uma asserção de exceção é bem-sucedida quando observa a exceção esperada; a exceção não é uma falha de teste não tratada. Se a operação em teste constrói vistas nativas ou utiliza handlers de plataforma, ainda necessita do contexto de aplicação apropriado. Uma asserção de exceção não fornece esse contexto.
Gorjeta
Evite escrever testes de unidade que examinem cadeias de caracteres de mensagem de exceção. As cadeias de caracteres de mensagens de exceção podem mudar ao longo do tempo e, portanto, os testes de unidade que dependem de sua presença são considerados frágeis.
Validação de testes
Teste tanto as regras de validação como o estado exposto por ValidatableObject<T>. Para cada regra, abranja entradas válidas, inválidas e de fronteira. Para o modelo de validação utilizado pela aplicação, veja Validação.
Os testes do modelo de visualização de validação da eShop fornecem um serviço simulado de navegação a MockViewModel e exercem o seu Validate método.
CheckValidationPassesWhenBothPropertiesHaveDataTest verifica se a validação tem sucesso quando ambos os nomes têm dados.
CheckValidationFailsWhenOnlyForenameHasDataTest verifica se um apelido em falta faz com que a validação falhe.
Verifique os Value, IsValid, e Errors as propriedades, bem como o resultado geral. Por exemplo, quando apenas o nome próprio tem dados, o nome próprio deve permanecer válido sem erros, enquanto o apelido deve ser considerado inválido e apresentar erros. Estas afirmações verificam o modelo de validação, não se a interface apresenta corretamente os erros.
Resumo
Um teste de unidade usa uma pequena unidade do 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.
Para isolar a lógica da aplicação, substitua as dependências de serviço por duplicações de teste. Escolha um framework de teste e uma plataforma de teste compatível, e utilize os atributos e asserções suportados por eles.
Testar modelos independentes da plataforma e modelos de vista com testes unitários .NET comuns. Utilize testes de dispositivo, de plataforma, de integração e da interface do utilizador para comportamentos que dependem de um serviço real ou do contexto nativo da aplicação.