Creating an AFT Suite to run mobile tests on pCloudy Cloud

When you want to run multiple mobile tests recorded on a mobile application, you can create an AFT. You can configure the AFT Suite with details of the tests, devices to use, and the location from where the tests must be initiated. You can then run the mobile tests on devices that are connected to the pCloudy Cloud.

You must have completed the following tasks:
  • Created or recorded mobile tests for the mobile application that you want to test.
  • Set up your account to access pCloudy Cloud. You must have valid credentials such as the hostname or the URL of the pCloudy Cloud instance, the user name, and an API key to authenticate the connection.
  • Noted the IDs or names of the devices connected to pCloudy Cloud that you want to use.
  • Noted the IP address of the remote agent computer if the mobile cloud is connected to the remote computer.
Restrictions:
  • You must consider the wait time for the device after each test run, and then start the next test run. The device that you want to test must be in the released state on pCloudy Cloud.
  • The AFT test run starts only if the configured devices are available at run time.
  • The devices that are available to you and the number of devices that are available for parallel test runs depend on the subscription plan that you have opted for in pCloudy Cloud.
  1. Open the UI Test perspective in Test UI if it is not already open.
  2. Go to File > New > Other.

    The Select a wizard dialog is displayed.

  3. Perform the following actions in the Select a wizard dialog:
    1. Select the XML File option in the XML folder.
    2. Click Next.

      The projects that contain the tests are displayed.

    3. Select the project where you want to save the XML file.
    4. Enter a name for the XML file in the File name field.
    5. Click Next.
    6. Select the Create XML file from an XML template option.
    7. Click Finish.
      An XML document is displayed for editing in the Source view tab.
      Note:
      Open the Source view tab if the Design view tab is displayed.
      A sample of the syntax or structure of the XML is as follows:
      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<inits id="<any_alphanumeric_value>" type="com.ibm.rational.test.ft.aftSuite">
 <group>
  <tests>
     <test path="<path_to_mobile_test_1>"/>
     <test path="<path_to_mobile_test_2>"/>
  </tests>
  <devices>
     <device id="<name of the device 1>”/>
  </devices>
  <locations>
     <location host="<location_where_test_is_run>"/>
  </locations>
 </group>
</inits>
    Refer to the following table to know the variables for the attributes mentioned in the XML sample:
    Element Attribute Variable Description
    inits id <any_alphanumeric_value> Specifies that you can enter any alphanumeric value that helps to identify the XML file.
    test path <path_to_mobile_test_1><path_to_mobile_test_2><path_to_mobile_test_3> Specifies the path to the mobile test in your project.
    Note:
    You can right-click the test, and then go to Properties > Resource to find the path.
    device id <name_of_the_device_1> Specifies the name or ID of the device that is connected to the device cloud.
    location host <location_where_test_is_run> Specifies the location as the computer that runs the test. The host can be the computer that is running Test UI or the remote agent computer.
  4. Create the following elements in the XML document:
    Note:
    You can copy the sample syntax, and then edit the values in the UI. Alternatively, you can create the elements in the XML in the UI.
    1. <group>

      The start and end tags are automatically inserted.

    2. Create <tests> within the <group> tag.
    3. Create <test> within the <tests> tag.
    4. Add the attribute path to the <test> as follows:
      <test path="">
      Note:
      You must enclose all values that you enter for the attributes within a double quotation mark.
    5. Add additional rows for each mobile test.
    6. Create <devices> within the <group> tag.
    7. Create <device> within the <devices> tag.
    8. Add the attribute id as follows:
      <device id=""></device>
    9. Create <locations> within the <group> tag.
    10. Create <location> within the <locations> tag.
    11. Add the attribute host as follows:
      <location host=""></location>
  5. Refer to the following table for the values of the attributes that you can use in the XML file:
    Element Attribute Example of a value Explanation
    test path MyProject\test_1 The path in the workspace that contains the project with the test. You can find the path of the test from the Test Navigator by right-clicking the test, and then go to Properties > Resource.
    device id pcloudy:Pixel_2_API_30 The name of the Android device is Pixel 2 API 30 that is connected to the pCloudy Cloud.
    pCloudy:Apple_iPhone8plus_Ios_12.2.0_9db66 The name of the iOS device is Apple_iPhone8plus_Ios_12.2.0_9db66 that is connected to the pCloudy Cloud.
    location host localhost The host is localhost if the device cloud is connected to the computer that runs Test UI.
    1.20.30.40 The host is the IP address of the remote agent computer, if the device cloud is connected to the remote agent computer.
  6. Enter the values for the attributes for your tests, device, and location in the XML file.
  7. Save the XML file.

You have created an AFT Suite for mobile tests, which you can use to run the mobile tests on devices that are connected to pCloudy Cloud.

You can initiate a run of the mobile tests that are in the AFT Suite. See Running mobile tests as an AFT Suite on pCloudy Cloud.