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.
O teste de interface verifica se a interface da sua aplicação se comporta corretamente, automatizando interações como pressionar botões, introduzir texto e navegar entre páginas. Enquanto os testes unitários validam métodos e classes individuais isoladamente, os testes de interface utilizam toda a aplicação num dispositivo real ou emulador para detetar regressões que só surgem através da interação real do utilizador.
Appium é um framework de testes de UI open-source que funciona com aplicações nativas, híbridas e web em várias plataformas. Como o Appium opera ao nível da plataforma, testa a sua aplicação da mesma forma, independentemente de ter sido construída com .NET MAUI ou ferramentas nativas da plataforma. A Appium utiliza drivers específicos da plataforma para enviar interações para a sua aplicação:
| Plataforma | Driver do Appium | SO Anfitrião |
|---|---|---|
| Android | UIAutomator2 | Windows, macOS, Linux |
| iOS | XCUITest | Apenas macOS |
| Mac Catalyst | Mac2 | Apenas macOS |
| Windows | Windows | Apenas Windows |
Observação
O que podes testar depende da tua máquina de desenvolvimento. No Windows, podes testar aplicações Android e Windows. No macOS, podes testar aplicações Catalyst para Android, iOS e Mac.
Sugestão
Para uma amostra completa de trabalho, consulte a Amostra Basic Appium NUnit em GitHub.
Pré-requisitos
Antes de poderes escrever e executar testes de interface, instala os seguintes pré-requisitos:
Node.js e Appium
Appium é construído sobre Node.js. InstalaNode.js (versão LTS recomendada), depois instala o Appium e os drivers das plataformas que queres testar:
# Install Appium
npm install -g appium
# Install platform drivers (install only the ones you need)
appium driver install uiautomator2 # Android
appium driver install xcuitest # iOS (macOS only)
appium driver install mac2 # Mac Catalyst (macOS only)
appium driver install windows # Windows
Verifica a instalação correndo appium num terminal. O servidor deve iniciar e mostrar uma mensagem a indicar que está a ouvir na porta 4723.
Driver de Aplicações Windows (apenas para Windows)
O driver Appium Windows utiliza Windows Application Driver (WinAppDriver) para automatizar Windows aplicações. Descarregue e instale o WinAppDriver versão 1.2.1.
Importante
Use especificamente a versão 1.2.1 do WinAppDriver. Outras versões podem não funcionar corretamente com o driver do Appium para Windows.
SDK Android (apenas Android)
Certifique-se de que o SDK do Android está instalado e que a ANDROID_HOME variável de ambiente aponta para a sua localização. Se já configurou a sua máquina para desenvolvimento Android em .NET MAUI, isto deverá estar configurado.
Prepare a aplicação .NET MAUI para testes
Todos os elementos da interface com os quais queres interagir nos teus testes precisam de ter a AutomationId propriedade definida com um valor único. Esta propriedade corresponde a identificadores de acessibilidade específicos da plataforma que a Appium utiliza para localizar elementos.
<Button
x:Name="CounterBtn"
AutomationId="CounterBtn"
Text="Click me"
SemanticProperties.Hint="Counts the number of times you click"
Clicked="OnCounterClicked"
HorizontalOptions="Fill" />
Registo de atividades Android
Para Android, a Appium precisa de conhecer o nome totalmente qualificado da atividade para lançar a sua aplicação. Adicione um [Register] atributo à sua MainActivity turma com um valor que corresponda ao nome do pacote da sua aplicação:
[Register("com.companyname.myapp.MainActivity")]
public class MainActivity : MauiAppCompatActivity
{
}
Garante que o valor no atributo Register corresponde ao ApplicationId no ficheiro do teu projeto e à funcionalidade AppActivity na configuração do teste.
Criar os projetos de teste
Uma estrutura de projeto comprovada utiliza projetos de teste separados por plataforma, com código de teste partilhado num projeto NoTargets. Este é o mesmo padrão usado no official sample e na própria base de código .NET MAUI:
MySolution/
├── MauiApp/ # Your .NET MAUI app
├── UITests.Shared/ # Shared test code (NoTargets project)
├── UITests.Android/ # Android-specific setup
├── UITests.iOS/ # iOS-specific setup
├── UITests.Windows/ # Windows-specific setup
└── UITests.macOS/ # macOS-specific setup
Cada projeto de plataforma compila o código partilhado ligando-o aos ficheiros no projeto Partilhado. Isto significa que todos os testes no projeto Partilhado são executados em todas as plataformas que testar. O projeto Partilhado em si não pode ser executado diretamente. Executa sempre um dos projetos de teste específicos da plataforma.
Importante
Mantenha o namespace igual em todos os projetos de teste (por exemplo, UITests). O atributo do [SetUpFixture] NUnit executa métodos de configuração para todos os fixtures de teste no mesmo namespace. Se os namespaces não coincidirem, o driver Appium não será inicializado quando os teus testes forem executados.
Projetos de teste de plataforma com pacotes NuGet
Cada projeto de teste específico de plataforma necessita dos seguintes pacotes NuGet:
<ItemGroup>
<PackageReference Include="Appium.WebDriver" Version="8.0.0" />
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
<PackageReference Include="NUnit" Version="3.14.0" />
<PackageReference Include="NUnit3TestAdapter" Version="4.5.0" />
</ItemGroup>
Sugestão
Em vez de criar projetos de teste do zero, pode instalar modelos mantidos pela comunidade que estruturam toda a estrutura do projeto por si. Para mais informações, consulte o repositório Template.Maui.UITesting GitHub.
Escrever uma classe base de teste
Crie um BaseTest.cs ficheiro no projeto Partilhado. Esta classe base fornece acesso ao driver Appium e a um método auxiliar que lida com a diferença na localização dos elementos no Windows em comparação com outras plataformas:
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Windows;
namespace UITests;
public abstract class BaseTest
{
protected AppiumDriver App => AppiumSetup.App;
protected AppiumElement FindUIElement(string id)
{
if (App is WindowsDriver)
{
return App.FindElement(MobileBy.AccessibilityId(id));
}
return App.FindElement(MobileBy.Id(id));
}
}
No Windows, AutomationId é acedido através de MobileBy.AccessibilityId. No Android, iOS e macOS, use MobileBy.Id.
Inicie o servidor Appium
O servidor Appium tem de estar a correr antes de executares os testes. A abordagem mais simples é arrancá-lo manualmente a partir de um terminal:
appium
O servidor inicia-se em http://127.0.0.1:4723 por predefinição. Deixa-o a funcionar enquanto fazes os teus testes.
Iniciar o servidor programaticamente (opcional)
Para tornar a sua suite de testes autónoma, pode iniciar e parar o servidor Appium como parte da execução do teste. Crie um AppiumServerHelper.cs ficheiro no projeto Partilhado:
using OpenQA.Selenium.Appium.Service;
namespace UITests;
public static class AppiumServerHelper
{
private static AppiumLocalService? _appiumLocalService;
public const string DefaultHostAddress = "127.0.0.1";
public const int DefaultHostPort = 4723;
public static void StartAppiumLocalServer(
string host = DefaultHostAddress,
int port = DefaultHostPort)
{
if (_appiumLocalService is not null)
return;
var builder = new AppiumServiceBuilder()
.WithIPAddress(host)
.UsingPort(port);
_appiumLocalService = builder.Build();
_appiumLocalService.Start();
}
public static void DisposeAppiumLocalServer()
{
_appiumLocalService?.Dispose();
}
}
Configure Appium para cada plataforma
Cada projeto de plataforma contém um AppiumSetup.cs ficheiro que configura o driver Appium com opções específicas da plataforma. Esta classe usa o atributo do [SetUpFixture] NUnit para inicializar o driver uma vez antes de todos os testes serem executados.
Android
using NUnit.Framework;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Android;
using OpenQA.Selenium.Appium.Enums;
namespace UITests;
[SetUpFixture]
public class AppiumSetup
{
private static AppiumDriver? driver;
public static AppiumDriver App => driver
?? throw new NullReferenceException("AppiumDriver is null");
[OneTimeSetUp]
public void RunBeforeAnyTests()
{
AppiumServerHelper.StartAppiumLocalServer();
var androidOptions = new AppiumOptions
{
AutomationName = "UIAutomator2",
PlatformName = "Android",
};
// For debug builds, use NoReset to preserve Fast Deployment libraries
androidOptions.AddAdditionalAppiumOption(
MobileCapabilityType.NoReset, "true");
androidOptions.AddAdditionalAppiumOption(
AndroidMobileCapabilityType.AppPackage,
"com.companyname.myapp");
androidOptions.AddAdditionalAppiumOption(
AndroidMobileCapabilityType.AppActivity,
"com.companyname.myapp.MainActivity");
driver = new AndroidDriver(androidOptions);
}
[OneTimeTearDown]
public void RunAfterAnyTests()
{
driver?.Quit();
AppiumServerHelper.DisposeAppiumLocalServer();
}
}
Observação
Para compilações de depuração no Android, defina NoReset para true. As compilações de depuração usam o Fast Deployment, e o comportamento de reset predefinido do Appium elimina as bibliotecas que o Fast Deployment exige. Para compilações de release, pode definir a propriedade App para o caminho completo do ficheiro assinado .apk.
iOS
using NUnit.Framework;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.iOS;
namespace UITests;
[SetUpFixture]
public class AppiumSetup
{
private static AppiumDriver? driver;
public static AppiumDriver App => driver
?? throw new NullReferenceException("AppiumDriver is null");
[OneTimeSetUp]
public void RunBeforeAnyTests()
{
AppiumServerHelper.StartAppiumLocalServer();
var iOSOptions = new AppiumOptions
{
AutomationName = "XCUITest",
PlatformName = "iOS",
PlatformVersion = "17.0",
DeviceName = "iPhone 15 Pro",
App = "com.companyname.myapp",
};
driver = new IOSDriver(iOSOptions);
}
[OneTimeTearDown]
public void RunAfterAnyTests()
{
driver?.Quit();
AppiumServerHelper.DisposeAppiumLocalServer();
}
}
Windows
using NUnit.Framework;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Windows;
namespace UITests;
[SetUpFixture]
public class AppiumSetup
{
private static AppiumDriver? driver;
public static AppiumDriver App => driver
?? throw new NullReferenceException("AppiumDriver is null");
[OneTimeSetUp]
public void RunBeforeAnyTests()
{
AppiumServerHelper.StartAppiumLocalServer();
var windowsOptions = new AppiumOptions
{
AutomationName = "windows",
PlatformName = "Windows",
App = "com.companyname.myapp_9zz4h110yvjzm!App",
};
driver = new WindowsDriver(windowsOptions);
}
[OneTimeTearDown]
public void RunAfterAnyTests()
{
driver?.Quit();
AppiumServerHelper.DisposeAppiumLocalServer();
}
}
Mac Catalyst
using NUnit.Framework;
using OpenQA.Selenium.Appium;
using OpenQA.Selenium.Appium.Enums;
using OpenQA.Selenium.Appium.Mac;
namespace UITests;
[SetUpFixture]
public class AppiumSetup
{
private static AppiumDriver? driver;
public static AppiumDriver App => driver
?? throw new NullReferenceException("AppiumDriver is null");
[OneTimeSetUp]
public void RunBeforeAnyTests()
{
AppiumServerHelper.StartAppiumLocalServer();
var macOptions = new AppiumOptions
{
AutomationName = "mac2",
PlatformName = "Mac",
App = "/path/to/MyApp/bin/Debug/net10.0-maccatalyst/maccatalyst-x64/MyApp.app",
};
macOptions.AddAdditionalAppiumOption(
IOSMobileCapabilityType.BundleId,
"com.companyname.myapp");
driver = new MacDriver(macOptions);
}
[OneTimeTearDown]
public void RunAfterAnyTests()
{
driver?.Quit();
AppiumServerHelper.DisposeAppiumLocalServer();
}
}
Importante
Para o Mac Catalyst, tens de definir essa BundleId opção. Sem isso, a Appium automatiza o Finder em vez da tua aplicação.
Escrever testes de interface de utilizador
Adicione classes de teste ao projeto Partilhado para que corram em todas as plataformas. Cada classe de teste deve herdar de BaseTest. O exemplo seguinte testa o botão contador no modelo padrão .NET MAUI:
using NUnit.Framework;
namespace UITests;
public class MainPageTests : BaseTest
{
[Test]
public void AppLaunches()
{
App.GetScreenshot().SaveAsFile($"{nameof(AppLaunches)}.png");
}
[Test]
public void ClickCounterTest()
{
// Arrange
var element = FindUIElement("CounterBtn");
// Act
element.Click();
Task.Delay(500).Wait();
// Assert
App.GetScreenshot().SaveAsFile($"{nameof(ClickCounterTest)}.png");
Assert.That(element.Text, Is.EqualTo("Clicked 1 time"));
}
}
O FindUIElement método localiza os controlos pelo seu AutomationId valor. Também pode usar outros seletores:
| Selector | Método | Notes |
|---|---|---|
| AutomationId |
MobileBy.Id() ou MobileBy.AccessibilityId() |
Preferido. Usa o FindUIElement utilitário para abstrair a diferença entre plataformas. |
| XPath | MobileBy.XPath() |
Mais lento, mas útil para consultas complexas. |
| Nome da classe | MobileBy.ClassName() |
Encontra elementos pelo nome da sua classe nativa. |
Sugestão
Defina AutomationId sobre todos os elementos que quer testar. É a forma mais fiável e eficaz de localizar elementos em todas as plataformas.
Executar testes de interface do usuário
Antes de fazer testes, certifique-se:
- A aplicação .NET MAUI é implementada no dispositivo ou emulador de destino.
- Para Android, um emulador é arrancado ou um dispositivo físico está ligado.
- Para iOS, um simulador está a correr ou um dispositivo está provisionado.
- Para Windows, a aplicação é instalada (por exemplo, executando-a primeiro pelo Visual Studio).
- Para macOS, o
.appbundle é construído e está disponível no caminho especificado emAppiumSetup.cs.
Execute testes a partir de Visual Studio usando Explorador de Testes, ou a partir da linha de comandos:
dotnet test UITests.Android/UITests.Android.csproj
Substitui o percurso do projeto pela plataforma que queres testar.
Consulte também
- Testes unitários
- Introdução ao teste da Interface de Utilizador de aplicações .NET MAUI usando Appium (post do blog)
- Use BrowserStack App Automate com Testes de Interface do Utilizador do Appium para Apps .NET MAUI (artigo de blog)
- Documentação do Appium
- Template.Maui.UITesting (modelos de projetos)