Skip to main content

AS - Android - 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 to build a test case for Android devices using Appium Studio.

Connect the Device​

  1. Connect the device to your machine using a USB cable.

  2. If you work on a Windows machine make sure you have a USB driver installed (MAC machine doesn't require any driver). For an updated list of drivers see: http://developer.android.com/tools/extras/oem-usb.html

  3. Make sure the device is "USB debugging" enabled.

warning

You can use Genymotion emulator. Just start the emulator to make it ready to work with.

tip

How to verify the device is configured correctly? Troubleshooting device connectivity...

Add the Device to the Studio​

  1. Click on the Add Device icon, then click Android.

  2. Click OK.

Open the Device​

Double-click the added device or click on the Open icon. . A device reflection is opened.

info

Once a device is open a device reflection is available. You can use this reflection screen to control the device.

Target Application​

  1. Click on the Import icon.

  2. Select your APK / IPA / APP file. Your application is added to the application repository.

    info

    You can also use the EriBank demo application, available in the application 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 life cycle.

info

The selected capabilities affect the following:

  • 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 the Play button.

Create a New Appium Project in Eclipse (Gradle)​

  1. Click File->New->Other...**

    **

  2. Click Gradle → Gradle Project, then click Next.

  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 that was created.

  6. Replace the content with the following:

    build.gradle

    apply plugin: 'java'
    apply plugin: 'maven'
    apply plugin: 'eclipse'
     
    repositories {
         maven { url "http://repo.maven.apache.org/maven2" }
         mavenCentral()
    }
    dependencies {
       compile group: 'io.appium', name: 'java-client', version: '+'
    }

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

Create a New Test Class​

  1. Right-click 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 have created.
Last updated on