TouchTest Initial Project Setup (iOS)

Document created by DPM Admin Employee on Jul 18, 2017Last modified by Trishala Kalal on Aug 9, 2017
Version 3Show Document
  • View in full screen mode

nitial Project Setup

In this section we will use git to retrieve the project, download the MakeAppTouchTestable utility (for use in the next section), and examine the Stockfish project by opening it in Xcode.


Note: If you are on iOS 10, you need to sign into Xcode with your development team name. Visit the Using TouchTest with iOS 10 help page for more details.


The Stockfish sample project is used throughout the TouchTest iOS Tutorial. You can easily follow along applying all of the steps to your own project or app. In this section we will use git (or GitHub) to retrieve the source code project, after which we'll also open and examine the project as is—before we make any modifications to it.


  1. Using git (or GitHub) retrieve the following project:

git clone


Note: The git command must be installed on the given node and in the path to succeed.


  1. Locate the Stockfish.xcodeproj file in Finder and double-click to open it.

TIP: You can also open Xcode and then use File > Open… to select the Stockfish.xcodeproj.


The project's components prior to running the utility are shown below.


Note that out-of-the-box there is one target, Stockfish, defined in this project. We will now duplicate that target for use with TouchTest.


  1. Expand the panel to reveal the underlying target "Stockfish." Familiarize yourself with the Stockfish project before proceeding.


  1. If you're using static instrumentation, right click the Stockfish target and choose Duplicate. The Duplicate target is used only with static instrumentation. Xcode will create a new target called Stockfish copy.


SOASTA highly recommends that you create a new Xcode target for use with TouchTest for static instrumentation. For now, create the duplicate target but note that if you use dynamic instrumentation then you will not actually use the duplicate target. For static users, the target duplication technique allows you to easily build two versions of your app: a testable version that is linked with TouchTest Driver, and a production-ready version that does not include any TouchTest functionality.


  1. Login to your CloudTest instance and open the Resources page (found at the bottom of Central).


  1. Download MakeAppTouchTestable Utility from the Downloads section.


  1. Unarchive the ZIP file.

Note: It is not necessary to open any of the files shown below, but it's good to know that they are there. Occasionally, you'll need to download a new MakeAppTouchTestable and this is where the updated, unarchived files will go.


  • MakeAppTouchTestable.jar utility is the script that will make the necessary project modifications and create a mobile app in CloudTest
  • The TouchTestDriver folder. The contents of this folder will be automatically copied to your project
  1. Open a Terminal window and navigate to the location where the ZIP was unarchived. For example,

cd Downloads/MakeAppTouchTestable

Next Step

Now that you've retrieved the project, and the MATT utility, the next thing is to decide whether to use static instrumentation or dynamic instrumentation to make the project TouchTestable. Click here for MATT Utility instrumentation instructions.


Go to: TouchTest Onboarding