Execute an automated test for an iOS Xamarin app

In

Visual Studio

, open

iOS.UITests

.

Configure the following properties for the data provider class. If you use the default FileDataProvider class, configure the properties in Common.UITests/Resources/data.json. If you use the SimpleDataProvider class, configure the properties in Common.UITests/DataServices/BaseSimpleDataProvider.cs.

You can change the data provider class in the IDataProvider interface in Common.iOS.UITests/Container/ContainerBootstrapper.cs.

Property	Value
BinaryPath	This is the path of the .ipa or .app file.
DeviceIdentifier	This is the device identifier. To get the identifier (UDID) for an iOS device, run the following command in the terminal: $ cfgutil list-devices To get the simulator device identifier (UUID), run the following command in the terminal: $ xcrun simctl list
DeviceEcid	To get the ECID for an iOS device, run the following command in the terminal: $ cfgutil list-devices If you are using an iOS simulator, specify an empty string.
AdbPath	This property applies to Android devices only. For iOS , specify an empty string.
Email	This is the test user’s email address.
AccessKey	This is the user’s 15 or 17 character access key, in the format "xxxxxxxxxxxxxxx", "xxxxx xxxxx xxxxx", or "xxxxx-xxxxx-xxxxx". You can generate an access key for the user using the UEM management console or the BlackBerry Web Services APIs.
NocAddress	This is the address of the BlackBerry Dynamics NOC. For example, “stage11” for the staging NOC and “prod1” for the production NOC.
Password	This is the user’s password. The password must meet the password requirements configured in the user’s BlackBerry Dynamics policy.
ConfirmPassword	This is the user’s password. The password must meet the password requirements configured in the user’s BlackBerry Dynamics policy.
KeyStorePath	This property applies to Android devices only. For iOS , specify an empty string.
KeyStorePassword	This property applies to Android devices only. For iOS , specify an empty string.
KeyPassword	This property applies to Android devices only. For iOS , specify an empty string.
KeyAlias	This property applies to Android devices only. For iOS , specify an empty string.

Example for an

iOS

app

{
  "BinaryPath": "/userDownloads/com.good.gd.example.xf.blankapp.ipa",
  "DeviceIdentifier": "12a12a12a123abcd12a123456ab1a12ab1ab123a",
  "DeviceEcid": "0x12345678A123A",
  "AdbPath": "" //For Android only
  "Email": "user@acme.com",
  "AccessKey": "01234 56789 01234",
  "NocAddress": "stage11",
  "Password": "abcd",
  "ConfirmPassword": "abcd"
}

Example for an

iOS

simulator

{
  "BinaryPath": "/userDownloads/com.good.gd.example.xf.blankapp.app",
  "DeviceIdentifier": "AB123A12-1234-1ABC-ABCD-12A12A12A1AB",
  "DeviceEcid": "", //For iOS only, not required for iOS simulator
  "AdbPath": "" //For Android only
  "Email": "user@acme.com",
  "AccessKey": "01234-56789-01234",
  "NocAddress": "stage11",
  "Password": "abcd",
  "ConfirmPassword": "abcd"
}

Configure the startup project for the test that you want to run.

Connect the

iOS

device or open the simulator with the device identifier that you specified in step 2.

If you are using an

iOS

simulator, turn off the hardware keyboard.

Run the test.