Aller au contenu

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.