Folha de referências do Xamarin.UITest
Importante
O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.
Este documento é uma folha de referência que condensa algumas informações de UITest para referência rápida, que contém os seguintes tópicos:
Gravando testes
Este snippet é uma clichê TestFixture para uma classe de teste em uma única plataforma:
using System;
using NUnit.Framework;
using Xamarin.UITest;
using Xamarin.UITest.Android;
using Xamarin.UITest.Queries;
namespace MyApp.MyUITests
{
[TestFixture]
public class Tests
{
IApp app;
[SetUp]
public void BeforeEachTest()
{
// Uncomment the line that's appropriate for the platform:
// app = ConfigureApp.Android.StartApp();
// app = ConfigureApp.iOS.StartApp();
}
// Test cases here
}
}
Para soluções que envolvem Android e iOS, o código a seguir ajudará na gravação de UITests multiplataforma.
using System;
using NUnit.Framework;
using Xamarin.UITest;
using Xamarin.UITest.Queries;
namespace MyApp.MyCrossPlatformUITests
{
public class AppInitializer
{
public static IApp StartApp(Platform platform)
{
if(platform == Platform.Android)
{
return ConfigureApp.Android.StartApp();
}
return ConfigureApp.iOS.StartApp();
}
}
[TestFixture(Platform.Android)]
[TestFixture(Platform.iOS)]
public class Tests
{
IApp app;
Platform platform;
public Tests(Platform platform)
{
this.platform = platform;
}
[SetUp]
public void BeforeEachTest()
{
app = AppInitializer.StartApp(platform);
}
}
}
As soluções do Xamarin.Forms devem seguir as instruções descritas no guia Automatizando o teste do Xamarin.Forms com o Xamarin.UITest e o App Center.
Inicializando o Xamarin.UITest no iOS
Adicione o seguinte snippet ao FinishedLaunching método da classe AppDelegate :
#region Code for starting up the Xamarin Test Cloud Agent
// Newer version of Visual Studio for Mac and Visual Studio provide the
// ENABLE_TEST_CLOUD compiler directive to prevent the Calabash DLL from
// being included in the released version of the application.
#if ENABLE_TEST_CLOUD
Xamarin.Calabash.Start();
#endif
#endregion
O Agente de Nuvem de Teste do Xamarin usa APIs apple não públicas, o que faz com que os aplicativos sejam rejeitados pelo App Store. O vinculador Xamarin.iOS removerá o Agente de Nuvem de Teste do Xamarin do IPA final se ele não for explicitamente referenciado em qualquer lugar pelo código. Os builds de versão não têm a variável do ENABLE_TEST_CLOUD compilador, o que faz com que o Agente de Nuvem de Teste do Xamarin seja removido do pacote de aplicativos. Os builds de depuração têm a diretiva do compilador definida, impedindo que o vinculador remova o Agente de Nuvem de Teste do Xamarin.
Determinar a ID do dispositivo para o simulador do iOS
Você pode determinar a UUID para os simuladores do iOS em um computador, use o instruments comando conforme mostrado abaixo:
$ xcrun xctrace list devices
Known Devices:
bushmaster [5A4B28A1-392A-59FB-81C5-137E881D61E9]
Resizable iPad (8.1 Simulator) [B3BF8A06-2938-4B74-BF87-16C223F8690C]
Resizable iPhone (8.1 Simulator) [E712409B-CFCC-409A-8162-627B6254EB3C]
iPad 2 (7.1 Simulator) [E8572F8F-227B-4DB0-8C92-590DC770360D]
iPad 2 (8.1 Simulator) [1F425263-3F96-4DAB-B843-0D041C3C71EA]
iPad Air (7.1 Simulator) [2863AFF6-D9FC-45E8-8385-E2A548F19002]
iPad Air (8.1 Simulator) [BBCF5CF2-20A4-4C47-9FA5-EBFF7311B071]
iPad Retina (7.1 Simulator) [B7CBB024-E1D3-4B24-8C20-3E9F7B54CF61]
iPad Retina (8.1 Simulator) [3E21ECD3-397A-4251-AEB6-2ADCF29AEE89]
iPhone 4s (7.1 Simulator) [D36354DD-D6A3-4E08-A25B-276620D844B8]
iPhone 4s (8.1 Simulator) [5C8FE602-8BA7-494D-A113-66C8B9AB3CB7]
iPhone 5 (7.1 Simulator) [C696E83D-F9FE-4DBC-8C67-FA0FC533246E]
iPhone 5 (8.1 Simulator) [9A8A5D92-A7D9-4A3C-81AA-97A9924F7D09]
iPhone 5s (7.1 Simulator) [6CDF5B5C-A315-4A8C-9D38-29437FE59C6D]
iPhone 5s (8.1 Simulator) [3F1C286F-3D5D-47B2-92B8-66B673BD0236]
iPhone 6 (8.1 Simulator) [995FF713-9DE4-460B-800E-F5A20FD93AA7]
iPhone 6 Plus (8.1 Simulator) [AB1C20F6-BFFC-4C80-879C-F19A7E3F0B5C]
Iniciando uma instância do simulador do iOS
É possível executar UITests em uma versão e simulador do iOS específicos usando a ID do dispositivo.
const string simId = "3F1C286F-3D5D-47B2-92B8-66B673BD0236"; //iPhone 5s (8.1 Simulator)
app = ConfigureApp.iOS.DeviceIdentifier(simId).StartApp();
Redefinir um simulador do iOS para padrões de fábrica
Esse snippet de código pode ser usado para interromper um determinado simulador do iOS e redefini-lo de volta para padrões de fábrica:
static void ResetSimulator(string deviceId)
{
var shutdownCmdLine = string.Format("simctl shutdown {0}", deviceId);
var shutdownProcess = Process.Start("xcrun", shutdownCmdLine);
shutdownProcess.WaitForExit();
var eraseCmdLine = string.Format("simctl erase {0}", deviceId);
var eraseProcess = Process.Start("xcrun", eraseCmdLine);
eraseProcess.WaitForExit();
}
Snippets de código
Esta seção fornecerá alguns snippets de código que podem ser úteis para escrever UITests.
Consultando elementos com base no valor da propriedade
//Finds all elements that have a "hint" property with a value of "Search"
app.Query(e => e.All().Property("hint", "Search"));
Habilitar capturas de tela localmente
app = ConfigureApp.Android
.EnableLocalScreenshots()
.StartApp();
O exemplo de código acima coloca capturas de tela no diretório onde está o assembly de teste, nomeando a imagem screenshot-X-png.
Invocar um método em um elemento AppResult ou UI
É possível executar métodos nativos em exibições subjacentes com o AppQuery.Invoke método . O método invocado deve corresponder ao nome do método nativo, não ao nome do método C#. Por exemplo, para invocar o setGravity método em um Android TextView:
app.Query(e => e.Id("userName").Invoke("setGravity", 1)); //center text
O Invoke usa o método Java TextView.setGravity e não a propriedade TextView.Gravity do C#.
Manipulando permissões do Android
ConfigureApp.Android.Debug().ApkFile(apkpath).StartApp()
Se você instalar usando .ApkFile(apkpath) em vez de PreferIdeSettings(), o aplicativo receberá permissões "all", que removem os pop-ups de permissão. .ApkFile(apkpath) No método , apkpath deve apontar para o arquivo apk compilado.