AppPerfect

Functional Testing iPhone Application

You can use App Test to test various GUI functionalities of Windows/Java/MacOs applications. In particular, App Test helps you record GUI interactions in your applications and lets you replay them and automatically validates your expected test conditions.

The following tutorial shows you how you could use the iOS simulator to also test your iOS applications (iPhone and iPad apps).

Before you proceed with the tutorial, please complete the following steps.

  1. Install IOS SDK (which includes the required iOS simulator) from http://developer.apple.com/devcenter/ios/index.action

    You will need an Apple Developer's account to download this software. You can create one for free at http://developer.apple.com/programs/register/
  2. Install App Test from http://www.appperfect.com/download/index.php
  3. App Test requires 'access for assistive devices' turned on. To do this go to 'System Preferences ...' from your Apple menu (on the left top corner of your screen). Click on 'Universal Access' and make sure 'Enable access for assistive devices' is checked as shown below.

To keep the tutorial simple we will will record/replay the 'Contacts' application that is available all iOS systems. (To learn how to install your custom application to the simulator, please refer to 'iOS Simulator Help' from the Help menu in 'iOS Simulator').

Start App Test. If you are using App Test for the first time, you will be asked to complete App Test software's licensing requirements.

Creating a Project
  1. Launch the Define New Project Dialog by clicking File ->New... menu option. The New Project wizard will be launched.
  2. Keep the default project name and location for the purpose of this exercise. We don't have to provide "Notification" settings. Click on the OK button.
  3. A confirmation message saying that the project is saved will be displayed. Click on the OK button.

Once the common project is successfully created another dialog - Define Project Properties dialog - will be displayed. The dialog shows various options which can be configured for the project. To compensate for the slow animation effects in iOS Simulator, we might need to enable 'Record Think Time' (or increase the 'Default Think Time' to more than a second). The following screenshot shows how to enable 'Record Think Time' :

In the 'Test Replaying' section, uncheck 'Ignore Think Time during replaying', as shown in the screenshot below :

For this tutorial, leave all other options to their default and click on OK button. You can change the project properties later, as needed, by right clicking on your project name from the 'Editor' tab and selecting 'Properties...'.

Click through all the menu items to familiarize yourself with the available features and how to access them. Viewing through all menu items will give a reasonable overview of the application.

Click Help -> Table of Contents menu item to see AppPerfect App Test product documentation.

Open the Preferences dialog by selecting the menu option Tools -> Options...
Review the default settings for App Test and click the OK button to close the dialog.

Recording a Test for iPhone

Please follow the steps below:

  1. To start recording, click on Project -> Record test... in the menu bar.'
  2. 'AppPerfect Recorder' dialog will be displayed. Select ActionGroup1 from the Group combo and provide proper executable path as "/Developer/Platforms/iPhoneSimulator.platform/Developer/Applications/iPhone Simulator.app/Contents/MacOS/iPhone Simulator" depending on the path on your machine. Now Click on 'Start recording' button.
  3. An instance of iOS Simulator will be launched. Go to the Hardware menu -> Devices and select 'iPhone'.
  4. Click on 'Contacts' application at the bottom of the iPhone GUI.
  5. Click on '+' button at the top right corner to add a new contact. Enter some text in the first three text boxes, and click 'Done' at the top right corner.
  6. The contact will be saved and you will be taken showing the new contact's Info. Click Edit on the top right corner.
  7. Use your mouse to drag downwards on the Edit Screen (click somewhere on the screen and without lifting the mouse button, gently move downwards). Stop after the 'Delete Contact' button is visible.
  8. Click 'Delete Contact'. Click 'Delete Contact' again to confirm.
  9. From the 'iOS Simulator' menu click 'Quit iOS Simulator'.
  10. Click on the Stop button of "AppPerfect Recorder" dialog to stop the recording session.
  11. Click on Close button to close the 'AppPerfect Recorder' dialog.
  12. In the AppPerfect App Test window, look at the tree on the left. Each action you performed has been recorded.
  13. Click on any of the recorded action on the left. The image of the window associated with that action is displayed on right hand frame. You can also find element/event details and recorded window properties/attributes there.

Recorded actions can be viewed from the editor, as shown below.

Replaying a test
  1. To start replay of the recorded test, click on Project -> Run from the menu bar.
  2. An instance of 'iOS Simulator' will be launched and each of the recorded events is replayed. No manual intervention is required during test replay, unless an error is encountered.
Viewing and analyzing results
  1. After replay, results are displayed in Results tab located at the top left of the window.
  2. Click on Results tab. Test results details are displayed on the right. Click on individual items in the tree on the left to view details on specific actions.
  3. Browse and examine the different views that are displayed on selecting the various nodes in the navigation tree.
  4. Select the Action Group node. This report gives a summary of the successful, failed, timed-out & not played Events & Windows.