Skip to main content

AS - iOS - Build Your First Test

info

Please note that this tool is classified as a Legacy tool. We recommend transitioning to our updated solutions to maintain optimal performance and security in your workflows. For more information on this matter, please reach out to technical support .

This page guides you on how to build a test case for an iOS device using Appium Studio.

Connect the Device​

Connect your device using the USB cable.

Make sure you have iTunes installed and that it is up to date.

warning

You can use the iOS Simulator.  See iOS simulator support.

Add Device to Studio​

Click on the 'Add Device' icon and on 'iOS Device'.

If no Provisioning Profile is found, you are prompted to configure a profile.

  1. Click Configure Profile.

  2. Click the Add Profile 

     button.

  3. Click Register Your iOS Developer Account, then click Next.

  4. Enter your Apple developer account user and password. These are used to register this device to your account and to download the Provisioning Profile.

Open the Device​

Click OK, then click the Open Device 

 button.

The device reflection opens.

tip

The device reflection is interactive,.  You can fully control the device from the reflection. You can also use the Object Spy 

to analyze the current screen objects.

Target Application​

To work with your application you need to import it.

  1. Click the Import 

     button.

  2. Select your IPA file if you work with a real device or .app file in case of a simulator.

    tip

    You can use the ExperiBank application available in the applications repository.

  3. Select the application you would like to work with.

Select Capabilities​

Once a device and an application are selected you can select another capability. This sets your test and application lifecycle.

info

The selected capabilities affect are:

  • Recording
  • Code generation
  • Execution within the studio.

Record Your Test​

  1. Click the Record  

     button.

  2. Wait for the device to be ready for recording.

  3. Perform the operations on the device reflection screen. Use your mouse to simulate touch and swipe actions, and your keyboard to send keys.

  4. Stop recording.

It is recommended to end your recording on the same page you have started the recording. This enables easily cycled execution when you debug your script.

After you stop the recording, the script is generated in the studio test tab.

You can add new commands and modify the existing commands and commands parameters.

info

You can verify your recording is valid by executing the recorded script. To do so, click Play.

Create a New Appium Project in Eclipse (Gradle)​

  1. Click File → New → Other...**

    **

  2. Click Gradle → Gradle Project.

  3. Check the 'Create a simple project (skip archetype selection)' checkbox, then click Next.

  4. Open the newly created project.

  5. Open the build.gradle file.

  6. Replace the content with the following:

    build.gradle

    apply plugin: 'java'
    apply plugin: 'maven'
    apply plugin: 'eclipse'
     
    repositories {
             
         maven { url "https://cloud.experitest.com/repo" }
         maven { url "http://repo.maven.apache.org/maven2" }
         mavenCentral()
    }
    dependencies {
        compile group: 'com.experitest', name: 'appium', version:'4.1.2'
    }

  7. Run the clean, cleanEclipse, and eclipse task to prepare your Eclipse environment.

Create a New Test Class​

  1. Right-click on your test source folder, then click New → Class.

  2. Provide the name of your test. (You can also provide a package that your test will be placed in).

  3. Click Finish.

Export Your Test Into Eclipse​

  1. In Appium Studio click Copy to Clipboard .
  2. Paste your code into the new Java class you created.
Last updated on