Menu
AWS Device Farm
Developer Guide (API Version 2015-06-23)

Use a Remote Access Session in AWS Device Farm

For information about sessions, see Sessions.

Prerequisites

  • Create a session. Follow the instructions in Create a Session, and then return to this page.

Use a Session in the Device Farm Console

As soon the device you requested for a remote access session becomes available, the console displays the device screen. The session has a maximum length of 60 minutes. The time remaining in the session appears below the menu bar on the right side of the console.

Installing an Application

To install an application on the session device, in Install applications, choose Upload, and then choose either the .apk file for an Android application or the .ipa file for an iOS application you want to install. Applications you run in a remote access session don't require any test instrumentation or provisioning.

Note

At present, we do not display a confirmation once an app is finished installing. Try interacting with the app icon to see if the app is ready to use.

Tip

When you upload an app, there is sometimes a delay before the app is available. Look at the system tray to determine whether the app is available.

Controlling the Device

You can interact with the device displayed in the console as you would the actual physical device using your mouse for touch and the device's on-screen keyboard. For Android devices, there are buttons in View controls that function just as the Home and Back buttons on an Android device do. For iOS devices, there is a Home button that functions just like the home button on an iOS device. You can also switch between applications running on the device by choosing Recent apps.

Switching between Portrait and Landscape Mode

You can also switch between portrait (vertical) and landscape (horizontal) mode for the devices you are using.

Next Steps

Device Farm will continue the session until you stop it manually or until the sixty-minute time limit is reached. To end the session, choose the Stop session button. After it stops, you can access captured video and logs generated by the session. For more information about getting session results, see Get Session Results.

Tips and Tricks

In some regions, you may experience performance issues with the remote access session. This is due in part to latency in some regions. If you experience performance issues, give the remote session a chance to catch up before interacting with the app again.