Skip Navigation

Execute an automated test for an 
iOS
 Xamarin app

  1. In 
    Visual Studio
    , open 
    iOS.UITests
    .
  2. 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 only to 
    Android
     devices. For 
    iOS
    , specify an empty string.
    Email
    This is the test user’s email address.
    AccessKey
    The user’s 17 character access key, in the format "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.
    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" }
  3. Configure the startup project for the test that you want to run.
  4. Connect the 
    iOS
     device or open the simulator with the device identifier that you specified in step 2.
  5. If you are using an 
    iOS
     simulator, turn off the hardware keyboard.
  6. Run the test.