Inspect an app with the new Appium Desktop

Elias Nogueira
3 min readMar 2, 2017

--

Now the Appium team created a new Appium.app called Appium Desktop.

https://github.com/appium/appium-desktop

The images can take a while to load because they are gif :)

Introduction

The new one Appium Desktop continue to works on Windows and MacOSx platforms, and now in Linux. The main propose stills: a server and an inspector running the last version of Appium.

There is a new GUI written in Electron, React and Redux totally remodeled with three different​ parts:

  • Simple: you can change the default host and port
  • Advanced: you can control general settings like log path, log level, node path, session and timezone. You also can change default bootstrap and Selendroid port, as ChromeDriver port and path for Android and WebDriverAgent for iOS
  • Presets: Is any change you can do and save for future executions
Appium Main Window

When you start Appium server you can also see the log output like the older Appium.app

Appium Server Log

So, how can I inspect an app in Appium Desktop?

You need to click on Start New Session button after start Appium server.

A new window will appear…

Appium Session Window

As you can see four options:

  • Automatic Server: you can add the Desired Capabilities to start any app and configure it in localhost
  • Custom Server: you can add Desired Capabilities to start any app and configure it in a remote host
  • Sauce Labs: you can start a new session over SauceLabs environment
  • TestObject: you can start a new session over TestObject environment

To start and, after, inspect any app, you must set the Desired Capabilities writing the name and type (text, boolean, number, filepath or JSON object). The JSON Representation will apear in the right side.
These Desired Capabilities can be saved as presets (Save Capability Sets) and used for any options above (Automatic and Custom server, Sauce Labs and TestObject).

Appium Session Window — Configuration

To start the session with your Desired Capabilities set, click on Start Session button.

Starting Appium Session

After this you will be able to inspect any Android or iOS apps.
In the image bellow I’m inspecting an iOS app.

Now you'll be able to inspect an app with new Appium Desktop.

--

--