Novolis.Testing.Appium 2026.1.1.61

Novolis · Docs · Source

Novolis.Testing.Appium

TUnit helpers that open Android and Windows Appium sessions for MAUI hosts and write a per-test evidence timeline from driver screenshots. The C# client connects to an already running Appium server. This package does not reference Microsoft.Maui.* and does not start Appium, install drivers, or launch emulators.

Install

dotnet add package Novolis.Testing.Appium

Prerequisites: .NET 10 SDK (net10.0), TUnit, Appium server already listening (default http://127.0.0.1:4723/). Install UiAutomator2 and/or the Windows driver on that server outside this repo. Override the URI with APPIUM_HOST.

Quick start (Android)

using Novolis.Testing.Appium;
using TUnit.Core;

public sealed class SettingsTests : AndroidAppiumTestBase<SettingsTests>
{
    protected override AndroidAppiumSessionOptions CreateOptions() => new()
    {
        AppPackage = "com.android.settings",
        AppActivity = ".Settings",
        NoReset = true,
    };

    [Test]
    public async Task Apps_row_opens()
    {
        await Timeline.StepAsync(
            "Open Settings",
            "The apps list is the first screen.",
            _ => Session.StartActivity("com.android.settings", ".Settings"));
        await Assert.That(Driver).IsNotNull();
    }
}

Point AppPath at a built APK when the package is not already on the device. StartActivity sends mobile:startActivity (the 5.x AndroidDriver.StartActivity(package, activity) overload is gone).

Quick start (Windows)

using Novolis.Testing.Appium;

public sealed class HostTests : WindowsAppiumTestBase<HostTests>
{
    protected override WindowsAppiumSessionOptions CreateOptions() => new()
    {
        App = @"C:\apps\Merglyph.exe",
    };
}

App may be an exe path or a packaged application id. The server must run appium-windows-driver; this library only sets capabilities.

Timeline

The driver session stays class-scoped. Each test gets its own recording. Timeline.StepAsync runs the driver work, then stores a PNG via GetScreenshot. Timeline.CaptureAsync stores the current screen without extra work. Record, RecordTelemetry, and Log write evidence that has no frame. The test fixture flushes timeline.json, timeline.md, and timeline.html after the test and refreshes index.html at the collection root.

Override the title without losing the stamp folder:

protected override AppiumTimelineOptions CreateTimelineOptions() =>
    base.CreateTimelineOptions() with { TimelineTitle = "Reach Android" };

Sessions opened with Connect can record without the fixture:

using var session = AndroidAppiumSession.Connect(new AndroidAppiumSessionOptions
{
    AppPath = apk,
    NoReset = true,
});
var timeline = new AppiumTimeline(session.Driver, new AppiumTimelineOptions
{
    TimelineTitle = "Reach Android",
});
await timeline.CaptureAsync(
    "client-launched",
    "The client is ready for a trusted endpoint.");
await timeline.FlushAsync();

Artifact root: NOVOLIS_APPIUM_ARTIFACTS, otherwise artifacts/appium beside the nearest artifacts directory. Frames land in frames/NN-step.png.

Related packages

More documentation

• Getting started
• Design

Support

Pre-release (2026.1.* on GitHub Packages).