/legerity-uno

An extension framework to Legerity for speeding up the development of automated UI tests for Uno Platform applications with Appium/Selenium on .NET

Primary LanguageC#MIT LicenseMIT

Legerity for Uno project banner

Legerity for Uno Platform

/ləˈdʒɛr ɪ ti/ (luh-jer-i-tee)
noun
  1. physical or mental quickness; nimbleness; agility.

GitHub release Nuget Nuget Preview NuGet Downloads Build status Legerity docs Legerity discussions

Legerity for Uno Platform is a cross-platform automated UI testing framework for building maintainable, write once, run everywhere tests quickly for Uno Platform applications with .NET.

It simplifies the development by providing easy-to-use element wrappers for Uno Platform app controls that allow developers to quickly get up and running with UI tests in no time.

Legerity also provides a best practice page object pattern for building UI tests with a maintainable structure. Together with app control wrappers, Legerity for Uno Platform provides the best experience for building maintainable UI automation with speed for Uno Platform apps.

Discover what's new in Legerity for Uno Platform

Features ⭐

  • UnoAppManager - A wrapper around the Selenium WebDriver and Appium WebDrivers to simplify starting your UI tests. Supports running a single set of UI tests across multiple platforms, or browsers.
  • Page Object Pattern - Provides a BasePage that can be used to create page objects associated with pages in your application that are easy to implement and maintain.
  • Page Object Generator - A dotnet CLI tool that will automatically create page objects by understanding your Uno Platform page files!
  • Element Wrappers - Contains a collection of out-of-the-box wrappers for Uno Platform UI elements across all platforms that are easy to use with interactions.
  • Testing Frameworks - Legerity for Uno Platform is agnostic of .NET testing frameworks (e.g. NUnit, xUnit, MSTest, etc.) so you can work with what you know.
  • CI - Legerity for Uno Platform is also agnostic of host CI runner platforms (e.g. GitHub Actions, Azure Pipelines, etc.) and can be run anywhere.
  • Extendable - UnoElementWrapper provides everything you need to build out element wrappers for your own Uno Platform controls.

Documentation 📃

If you want to deep dive into the Legerity for Uno Platform framework with details on how to use the features, you can browse the documentation for help getting up and running!

Our documentation includes usages examples, as well as API documentation for your technical reference.

Installation 💾

Legerity for Uno Platform is publicly available via NuGet. Each available package is detailed below.

Package Downloads
Nuget NuGet Downloads

Support Legerity for Uno Platform 💗

As many developers know, projects like Legerity for Uno Platform are built and maintained in spare time. If you find this project useful, please Star the repo and if possible, sponsor the project development on GitHub.

Contributing 🚀

Looking to help build Legerity for Uno Platform? Take a look through our contribution guidelines. We actively encourage you to jump in and help with any issues!

Building Legerity for Uno Platform 🛠

Legerity for Uno Platform is built using .NET Standard, taking advantage of the new SDK-style projects.

You can build the solution using Visual Studio with the following workloads installed:

  • .NET desktop development
  • .NET Core cross-platform development

Got components? 💭

Do you have a collection of custom components that you'd like to see added to the Legerity for Uno Platform framework? Feel free to drop a feature request into our work tracker!

Even better, why not help build out your custom control wrapper elements within the framework and help out the community!

UI Automation tooling 🧰

When contributing to new element wrappers, we recommended using the Accessibility Insights tool. The tool is capable of inspecting and providing property values for Android, Web, and Windows applications.

Alternatively, you can use the Inspect.exe tool for Windows applications installed with the Windows SDKs. This is not recommended as the tool is considered legacy and can often cause oddities in UI when using.

For your Uno Platform web application, you can also use F12 developer tools to inspect your application layout tree.

License

Legerity for Uno Platform is made available under the terms and conditions of the MIT license.