Chapter 1. Getting Started

Requirements

The following are prerequisites to use the Remote Test Lab (hereafter RTL) service.

  • Samsung Developers' Samsung account
  • Standard web browser with JavaScript support
  • Java Runtime Environment (JRE)*7 or later, including Java Web Start
  • Internet environment with port 2600 outbound open

*Make sure to use public version if you have not purchased Oracle Java SE subscription.

Starting the RTL Client

The RTL Client provides an environment to run various tests by remotely accessing physical devices through Java applications running on user PCs.

RTL Client
RTL Client

Figure 1 RTL Client

To start the RTL Client, open your web browser and go to the RTL web page ( https://developer.samsung.com/remotetestlab ).

The devices we support are categorized as product lines like Galaxy, Z and Gear, and displayed on each product page.

Device List
Device List

Figure 2 Device List

Select device model and OS version
Select device model and OS version

Figure 3 Select device model and operating system version

Download the JNLP file by clicking the Start button. Run the JNLP file to download and then run the RTL Client.

Controlling the RTL Client

Once the device's screen is displayed on the RTL Client, you can start controlling the actual device.
Try clicking or dragging the mouse cursor on the RTL Client screen.

RTL Client in action
RTL Client in action

Figure 4 RTL Client in action

The RTL Client provides the following input methods:

  • Tap / Swipe / Tap and Hold

    Either tapping the device screen with your finger or dragging the mouse cursor will control the device in the same way. Move the mouse cursor to a location on the screen that you would like to tap and then left click. Both the Swipe and Tap and Hold events can be executed the same way.

  • Hardware Button

    The Hardware button event of the device can also be executed. Click the button located at the bezel as if you were controlling an actual device to execute various events using the Hardware button. However, more than two buttons cannot be clicked at the same time.

  • Keyboard Input

    The RTL Client can deliver keyboard input values to the remote device including alphanumeric characters and simple special symbols.

  • S-Pen

    If the remote device supports S Pen, you can also execute various S Pen events. For more details, please refer to 2.6 Change Input Mode.

RTL Client Features

All features available on the RTL Client are accessible through the context menu.

Context Menu
Context Menu

Figure 5 Context Menu

The following features are provided:

  • Screen features: Screen Quality Control, Orientation, Scale, Capture and Record, Screen Share
  • Device management features: Application manager, Send to Clipboard, Language, File manager, Wireless network reset, Device Reboot
  • Test features: Install Application, Auto-Repeat, View Logs, Remote Shell Access, Remote Debug Bridge