Preparing your Uno Platform apps

By default, Uno Platform apps don't expose the XAML IDs that you may have configured in your app's UI in order to reference them in your UI tests. However, Uno Platform provides a mechanism to do this with alterations to each app's .csproj file and a change in your App.xaml.cs file.

Project file changes

To allow mapping of your automation properties to controls in your Uno Platform apps, you must add the following line to the default PropertyGroup of each project's .csproj file.

<IsUiAutomationMappingEnabled>true</IsUiAutomationMappingEnabled>

Setting this will replace certain properties in each platform's app with the x:Uid or AutomationProperties.AutomationId XAML attribute value.

For Android, this sets the View.ContentDescription property

For iOS, it sets the UIView.AccessibilityIdentifier property

For WebAssembly, it sets aria-label and the xamlautomationid property

For more information on this, see the Uno Platform docs.

Additional changes for WebAssembly

When viewing the visual tree of your Uno Platform app for WebAssembly with F12 developer tools, you will need to enable UI element feature configurations in your application to display x:Uid and x:Name attributes in the DOM.

This is achieved by adding the following lines to the constructor of your App.xaml.cs file.

#if DEBUG && __WASM__
Uno.UI.FeatureConfiguration.UIElement.AssignDOMXamlName = true;
Uno.UI.FeatureConfiguration.UIElement.AssignDOMXamlProperties = true;
#endif

More information on this can be found in the Uno Platform docs.

Providing additional XAML automation properties for Android and iOS

To get the most out of your app's XAML automation properties, you want to provide additional XAML automation properties to support interactions with Android and iOS.

Adding the following additional property to your XAML elements will provide the correct XAML automation ID for elements that have content. This is required to ensure that the content isn't displayed as the element name.

AutomationProperties.AccessibilityView="Raw"

See Uno Platform's tips on why this is needed.