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.
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.
- Using git (or GitHub) retrieve the following project:
- Locate the Stockfish.xcodeproj file in Finder and double-click to open it.
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.
- Expand the panel to reveal the underlying target "Stockfish." Familiarize yourself with the Stockfish project before proceeding.
- 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.
- Login to your CloudTest instance and open the Resources page (found at the bottom of Central).
- Download MakeAppTouchTestable Utility from the Downloads section.
- Unarchive the ZIP file.
- 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
- Open a Terminal window and navigate to the location where the ZIP was unarchived. For example,
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