Instrumenting iOS Applications in Xamarin Studio

Supported Applications

Requirements

1. Create a Separate Configuration for Testing

2. Add the TestComplete Agent Library to Your Project

3. Change Build Settings

4. Create an IPA File

5. Deploying the IPA File to a Device

Other Preparatory Actions

Information in this topic applies to Xamarin.iOS applications created in Xamarin Studio 6.1.1 - 6.2.1.

• A Mac computer with Xamarin Studio 6.1.1 - 6.2.1, iOS SDK and an iOS development license.

• Access to a Windows computer with TestComplete installed.

To keep your build configurations intact, create a new configuration for testing:

1. Open your application project in Xamarin Studio.

2. Open the project’s Options and then select Build | Configurations.

3. Create a new configuration for testing or copy an existing one:

   

   Click the image to enlarge it.

   Give the configuration a name indicating that it is for testing only.

1. On a Windows computer with TestComplete installed, find the following file:

   <TestComplete>\Bin\Extensions\iOS\libTestComplete-agent-static.a

   Copy or send this file to your Mac.

2. On your Mac, place the library file in the folder where your application project resides.

3. In Xamarin Studio, right-click your application project in the Solution Explorer and then click Add | Add Files:

   

   Click the image to enlarge it.

4. In the resulting dialog, browse for the copied TestComplete Agent library file - libTestComplete-agent-static.a.

5. Select the added TestComplete library file in the Solution Explorer and set its build action to None:

   

   Click the image to enlarge it.

1. Open Options of your application project:

   

   Click the image to enlarge it.

2. Select Build | iOS Build. Make sure your test configuration is selected:

   

   Click the image to enlarge it.

3. In the Additional mtouch arguments text box, enter the following:

   -gcc_flags "-L${ProjectDir} -force_load ${ProjectDir}/libTestComplete-agent-static.a"

   

   Click the image to enlarge it.

1. In Xamarin Studio, select your application project and then click Archive for Publishing:

   

   Click the image to enlarge it.

2. Select the archived application and click Sign and Distribute:

   

   Click the image to enlarge it.

3. In the resulting dialog, select Add Hoc. Then select the provisioning profile you want to use:

   

   Click the image to enlarge it.

   Getting the Provisioning File

   Getting the Provisioning FileGetting the Provisioning File

   Download the provisioning file from Apple Member Center web site:

   1. Open the following web page in your browser and login to the Member Center:

      developer.apple.com/membercenter

   2. If you belong to several teams, Member Center will ask you to enter the team, whose settings you would like to view. Select the team and click Continue.

   3. In the Developer Program Resources section of the next page, click the “Manage your certificates...” link:

      

      Click the image to enlarge it.

      This will invoke the Certificates, Identifiers & Profiles page.

   4. Click Provisioning Profiles in the iOS Apps section.

      

      Click the image to enlarge it.

   5. On the subsequent page, select Provisioning Profiles | Development.

      You will see a list of provisioning profiles of the development type:

      

      Click the image to enlarge it.

   6. Click the needed profile and click Download in the expandable section:

      

      Click the image to enlarge it.

4. After specifying all the required parameters, click Publish.

5. In the Output IPA file dialog, specify the name and location of the IPA file to create:

   

   Click the image to enlarge it.

You can either deploy the signed IPA file to your device manually, or add the file to your TestComplete test project and configure TestComplete to deploy the application to the test device during the test run automatically:

1. Copy or send the signed IPA file from your Mac to the TestComplete computer.

2. Add this IPA file as a tested application to your TestComplete project.

3. Configure your TestComplete project to deploy the application to the test device during the test run automatically.

To learn how to do it, see the Deploying iOS Applications to Devices section in the TestComplete documentation.

Before testing your iOS application with TestComplete, you also need to configure the TestComplete computer. For more information, see Preparing for Running Tests on iOS Devices.