The iOS MonkeyTalk Transform automates testing of an iOS application.

This Transform reads configuration data from a CSV file and generates a JavaScript for the MonkeyTalk Java runner extension.

Note: To avoid timeouts, close all other applications on the iPhone.

Sample Project

The iOS MonkeyTalk Sample is installed in the MxSuite Installation Folder in the Sample subfolder. To use the sample, copy it to another folder outside of the Program Files folder. It is not included in the Copy Samples dialog.

CSV File Format

This CSV file has 3 input columns:

File Name: The file name of the JavaScript files generated by the Transform.

Field Type: There are two types: button and input.  Button specifies any event type (“Tap() event in iOS”) and input specifies the message type (“Entertext() event in iOS”) which accepts specified input data to the scripts. For example: Mac id of an external Bluetooth device, or a phone number to call.

Field Name: The button names on the native iOS app installed with the Monkey Talk agent. For example: Call, or Play/Pause.





Configuring the Transform

1.Select the iOS Monkey Talk Transform from the toolbox.


2.Select the following in the Transform properties :

CSV/Input path: The path of a CSV file formatted as described above.

Note: Make sure the specified folder contains three files: MonkeyTalkAPI.js, monkeytalk-runner.jar, and cmd.exe. The file names must be exactly as listed. These files are available in the Dependencies folder in the iOS MonkeyTalk sample.

iOSHostDeviceIP: IP address of the iOS device as it is connected to the same network as the test PC.



Ports are generated on the Transform corresponding to the names in the File name column of the CSV file. The JavaScript files are generated in the folder specified by the CSV/Input path property.


3.Export all the ports to MxVDev, and use them to create a TestCase.



Note: Input message type signals are allowed to take a maximum of 17 ASCII characters/digits. For example: mxphoneNo, mxDeviceMac.

Use-Case: Call Sequence

The Signal mxphoneNo transmits the phone number to call and the mxcall event Signal raises the call event.



This image shows how to create a message on the mxphoneNo Signal. Double-click on the plot line to open the transition editor. Enter as many as 17 digits as shown:




To initiate a call, create an event transition on the mxcall Signal by double-clicking on the plot line.

Click the run (Run_btn) button to run the TestCase.

Note: For this test, reports with screen-shots are generated in the .mxout folder.


Danlaw iOS Test Application (IPA)

Installing the IPA on the iPhone

1.Connect the iPhone to the Mac Book or Windows PC from which you want to install the application.

2.Copy the IPA file into the iTunes Apps View in your Mac or PC.

3.Check your Mac or PC for the iPhone name and see the list of visible Apps.

4.Click on the install option for the “Danlaw_iOS_Test” App and select the apply button.

5.You can see the installed application on your iPhone (see Danlaw logo as App icon).  

Running the Application



1.Make sure that you have the Mac ID of the Bluetooth Headset and the Headset is in pairing mode.

2.Select the BT ON button to turn the Bluetooth on, then select the BT ON button again to scan the available Bluetooth devices.

3.Enter the MAC ID of the Bluetooth device in the MAC ID field.

4.Select the Connect button to pair with the desired Bluetooth device.

5.To confirm whether device is connected or not, check the Bluetooth symbol on the IPA screen.

6.After confirming that the Bluetooth device is paired, enter the phone number in the Phone number field and select the call button to make a call.

7.Click on End call from the heads up unit.

8.For Music Player, select the Play/Pause button to play or pause the music.

9.Select the Next button for next song and previous button for the previous song.

10.Go to the Bluetooth options in head unit and select disconnect and unpair.

11.If you want to make the device forget over the phone first close the background application of this app and go to the setting in iPhone and select the “i” symbol and select forget device.

12.Make sure that the device does not show in the devices list.