Tests¶
Tester l'interface sans afficher de fenêtre, avec la plateforme headless.
flowchart LR
T["[AvaloniaFact]<br/>test xUnit"] --> H["Plateforme headless<br/>(pas d'écran)"]
H --> W["vraie MainWindow<br/>layout, styles, bindings"]
T -- "KeyTextInput, MouseDown…" --> W
W -- "Assert / CaptureRenderedFrame" --> T
L'interface tourne pour de vrai (layout, bindings, styles), seulement sans écran : idéal en intégration continue.
Mise en place (xUnit v3)¶
dotnet new xunit3 -o MonApp.Tests
cd MonApp.Tests
dotnet add package Avalonia.Headless.XUnit
dotnet add reference ../MonApp/MonApp.csproj
v12
La plateforme headless supporte xUnit v3 et NUnit 4 (Avalonia.Headless.NUnit).
TestAppBuilder.cs
using Avalonia;
using Avalonia.Headless;
[assembly: AvaloniaTestApplication(typeof(MonApp.Tests.TestAppBuilder))]
namespace MonApp.Tests;
public class TestAppBuilder
{
public static AppBuilder BuildAvaloniaApp()
=> AppBuilder.Configure<App>()
.UseHeadless(new AvaloniaHeadlessPlatformOptions());
}
Premier test¶
using Avalonia.Controls;
using Avalonia.Headless.XUnit;
public class MainWindowTests
{
[AvaloniaFact]
public void Le_titre_est_correct()
{
var fenetre = new MainWindow();
fenetre.Show();
Assert.Equal("Mon application", fenetre.Title);
}
}
[AvaloniaFact] / [AvaloniaTheory] exécutent le test sur le thread UI.
Simuler le clavier¶
[AvaloniaFact]
public void Saisir_un_nom_affiche_le_message()
{
var fenetre = new MainWindow();
fenetre.Show();
var saisie = fenetre.FindControl<TextBox>("Nom")!;
saisie.Focus();
fenetre.KeyTextInput("Ada");
var bouton = fenetre.FindControl<Button>("Saluer")!;
bouton.Command?.Execute(null); // ou clic souris, voir ci-dessous
Assert.Equal("Bonjour Ada !", fenetre.FindControl<TextBlock>("Message")!.Text);
}
Touches spéciales¶
fenetre.KeyPress(Key.Enter, RawInputModifiers.None, PhysicalKey.Enter, null);
fenetre.KeyRelease(Key.Enter, RawInputModifiers.None, PhysicalKey.Enter, null);
Simuler la souris¶
var centre = bouton.TranslatePoint(new Point(bouton.Bounds.Width / 2, bouton.Bounds.Height / 2), fenetre)!.Value;
fenetre.MouseDown(centre, MouseButton.Left);
fenetre.MouseUp(centre, MouseButton.Left);
Capture d'écran¶
Nécessite le rendu Skia :
public static AppBuilder BuildAvaloniaApp()
=> AppBuilder.Configure<App>()
.UseSkia()
.UseHarfBuzz()
.UseHeadless(new AvaloniaHeadlessPlatformOptions { UseHeadlessDrawing = false });
[AvaloniaFact]
public void Capture()
{
var fenetre = new MainWindow();
fenetre.Show();
var image = fenetre.CaptureRenderedFrame();
image?.Save("main-window.png");
}
v12 : HarfBuzz
Si vous appelez UseSkia() explicitement, ajoutez le paquet Avalonia.HarfBuzz et .UseHarfBuzz(),
sinon : No text shaping system configured.
Tester les ViewModels¶
Les ViewModels n'ont pas besoin d'Avalonia : de simples tests xUnit suffisent.
[Fact]
public void Ajouter_incremente_le_compteur()
{
var vm = new CompteurViewModel();
vm.AjouterCommand.Execute(null);
Assert.Equal(1, vm.Valeur);
}
C'est l'un des grands intérêts du MVVM.