Integrate NUnit test suite with App Accessibility testing

Set your BrowserStack credentials

Save your BrowserStack credentials as environment variables to make it easier to run your test suite from your local or CI environment.

export BROWSERSTACK_USERNAME=YOUR_USERNAME
export BROWSERSTACK_ACCESS_KEY=YOUR_ACCESS_KEY

setx BROWSERSTACK_USERNAME "YOUR_USERNAME"
setx BROWSERSTACK_ACCESS_KEY "YOUR_ACCESS_KEY"
set BROWSERSTACK_USERNAME=YOUR_USERNAME
set BROWSERSTACK_ACCESS_KEY=YOUR_ACCESS_KEY

Install BrowserStack SDK

Run the following command to install the BrowserStack SDK and create a browserstack.yml file in the root directory of your project.

dotnet add package BrowserStack.TestAdapter
dotnet build
dotnet browserstack-sdk setup --userName "YOUR_USERNAME" --accessKey "YOUR_ACCESS_KEY"

dotnet add package BrowserStack.TestAdapter
dotnet build
dotnet browserstack-sdk setup --userName "YOUR_USERNAME" --accessKey "YOUR_ACCESS_KEY"

[Only for Macs with Apple silicon] Install dotnet x64 on macOS

If you are using a Mac computer with Apple silicon chip (M1 or M2) architecture, use the given command.

cd #(project folder Android or iOS)
dotnet browserstack-sdk setup-dotnet --dotnet-path "<path>" --dotnet-version "<version>"

Here, <path> refers to the absolute path to the directory where you want to save dotnet x64 and <version> refers to the dotnet version which you want to use to run tests.

Navigate to the platform folder

Based on your testing platform, navigate to the android or iOS directory.

Modify the configuration file

The browserstack.yml file defines the required capabilities to run tests on BrowserStack. It is platform-specific and located in the corresponding platform folder (android/ or ios/). Make sure you modify the file that corresponds to your testing platform.

1. Open the browserstack.yml file.
2. Set your BrowserStack userName and accessKey.
3. Set your projectName and buildName.
4. Set the framework to nunit.
5. Set the accessibility flag to true. The default value is false.
6. Configure the accessibilityOptions property to set various accessibility testing options. For details, see Configuration options.
7. Add the relative or absolute path of the app you want to test in the app property. For example, app: ./examples/BStackSampleApp.apk.
   You can upload an Android app (.apk or .aab file) or an iOS app (.ipa file) from your local filesystem.
8. Specify all the device, OS, and OS version combinations that you want to test in the platforms section.
9. Save the file.

Run the automated test

From your platform folder (Android or iOS), run the following command:

dotnet build
dotnet test --filter <EXPRESSION> [other_args]

dotnet build
dotnet test --filter <EXPRESSION> [other_args]

dotnet build
dotnet64 test

View the Accessibility test report

After the test completes, view the report in your project folder on the App Accessibility dashboard.

Visit App Accessibility dashboard