Tester le Headless avec XUnit

Préparation

Cette page suppose qu'un projet XUnit a déjà été créé. Si ce n'est pas le cas, veuillez suivre les sections "Démarrer" et "Installation" de XUnit ici https://xunit.net/docs/getting-started/netfx/visual-studio.

Installer des packages

En plus des packages XUnit, nous devons installer deux autres packages :

• Avalonia.Headless.XUnit qui inclut également Avalonia.
• Avalonia.Themes.Fluent car même les contrôles headless ont besoin d'un thème.

indice

La plateforme headless ne nécessite aucun thème spécifique, et il est possible d'échanger FluentTheme avec n'importe quel autre.

Configurer l'application

Comme dans toute autre application Avalonia, une instance Application doit être créée et les thèmes doivent être appliqués. Lors de l'utilisation de la plateforme Headless, la configuration n'est pas très différente de celle d'une application Avalonia classique et peut principalement être réutilisée.

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="Tests.App">
  <Application.Styles>
    <FluentTheme />
  </Application.Styles>
</Application>

Et le code :

using Avalonia;
using Avalonia.Headless;

public class App : Application
{
    public override void Initialize()
    {
        AvaloniaXamlLoader.Load(this);
    }
}

note

En général, la méthode BuildAvaloniaApp est définie dans le fichier Program.cs, mais les tests NUnit/XUnit ne l'ont pas, donc elle est définie dans le fichier App à la place.

Initialiser les tests XUnit

L'attribut [AvaloniaTestApplication] relie les tests dans le projet actuel à l'application spécifique. Il doit être défini une fois par projet dans n'importe quel fichier.

[assembly: AvaloniaTestApplication(typeof(TestAppBuilder))]

public class TestAppBuilder
{
    public static AppBuilder BuildAvaloniaApp() => AppBuilder.Configure<App>()
        .UseHeadless(new AvaloniaHeadlessPlatformOptions());
}

Exemple de test

[AvaloniaFact]
public void Should_Type_Text_Into_TextBox()
{
    // Configurer les contrôles :
    var textBox = new TextBox();
    var window = new Window { Content = textBox };

    // Ouvrir la fenêtre :
    window.Show();

    // Mettre le focus sur la zone de texte :
    textBox.Focus();

    // Simuler une saisie de texte :
    window.KeyTextInput("Hello World");

    // Vérifier :
    Assert.Equal("Hello World", textBox.Text);
}

Au lieu de l'attribut typique [Fact], nous devons utiliser [AvaloniaFact] car il configure le thread de l'interface utilisateur. De même, au lieu de [Theory], il existe un attribut [AvaloniaTheory].