Supported platforms and features
Device Connect for AWS Device Farm runs on your computer and connects your local Android Debug Bridge (adb) to Android devices in remote access sessions. The following sections list the operating systems, versions, adb commands, and port forwarding that Device Connect supports.
Most adb commands work as they do with a local device.
Topics
Supported operating systems
At this time, devicefarm-connect runs on the operating systems and architectures in
the following table.
| Operating system | Architectures | Notes |
|---|---|---|
macOS |
arm64 (Apple silicon), amd64 (Intel) |
macOS 13 or later. |
Linux |
amd64, arm64 |
|
Windows |
amd64 |
Windows 10 build 17063 or later. Windows 10 version 1803 and later, and
Windows 11, have such a build. To check your build, run |
devicefarm-connect doesn't include adb. You install adb separately. For more
information, see Prerequisites.
Supported adb and Android versions
The following table lists the adb and device versions that Device Connect supports.
| Component | Supported versions | Notes |
|---|---|---|
adb on your computer |
Android Debug Bridge version 1.0.41, from Android SDK Platform-Tools 29.0.0 or later |
|
Device |
Public devices with Android 9 or later |
At this time, Device Connect works only with metered public devices. It doesn't work with private devices or unmetered public slots. It doesn't support iOS devices. |
Your adb must be version 1.0.41. An adb with another version can't connect through the bridge,
so every command fails. In Android Studio, update Android SDK Platform-Tools
in the SDK Manager. To check every adb on your computer, run devicefarm-connect doctor
with --session-arn. For more information, see adb server version doesn't match this client.
Supported adb commands
Most adb commands work as they do with a local device. For example, adb shell,
adb install, and adb logcat work. The bridge handles a few requests on your
computer, such as adb devices and adb forward, and sends every other request to
the device. The commands named on this page are examples, not a complete list.
Android Studio works with the attached device, except for device mirroring. For more information, see Using Android Studio.
Two adb clients can use one bridge at the same time. They share the connection limit of the
bridge. Several computers can also attach the same session, but only one of them at a time can use
adb reverse. For the limits, see Device Connect limits.
Refused commands
The following adb reverse commands fail with the message shown:
-
adb reverse tcp:0:localreverse tcp:0 is not supported on AWS Device Farm. -
adb reverseto a device port from 5555 to 5585:reverse to a device port in 5555 to 5585 is not permitted on AWS Device Farm. -
adb reverseto the adb port of the bridge:cannot reverse to tcp:.port: the bridge listens on that port -
adb reversewith an end that is nottcp:, such asportadb reverse localabstract::nametcp:portunsupported socket specification:.spec; adb reverse accepts only tcp:<port> on AWS Device Farm
Device Farm also blocks commands that can disrupt the device, such as
adb reboot.
Supported port forwarding
The following table lists what adb forward and adb reverse
support.
| Property | adb forward |
adb reverse |
|---|---|---|
On by default |
Yes |
No |
End on your computer |
|
|
End on the device |
|
|
Address on your computer |
Listens on |
Connects to |
With tcp:0 as the end on your computer, adb forward picks a free port and
prints it.
To turn on adb reverse, start the bridge with
--allow-adb-reverse.
--allow-adb-reverse lets the device open connections to this machine, so use it only
with a device you trust; a public device can run software you do not control.
For the limits on rules, connections, and device ports, see Device Connect limits. For instructions, see Forwarding ports and Reaching your computer from the device with adb reverse.
Unsupported features
Device Connect doesn't support the following. For adb commands that fail, see Refused commands. For the limits, see Device Connect limits.
- More than one attached device
-
The bridge holds the device of one remote access session at a time. adb can't list or use two Device Farm devices together. To use another device, detach the attached device first. For instructions, see Switching to another device.
- Local devices and Device Farm devices on one adb server
-
The bridge takes the place of the local adb server. It shows only the attached Device Farm device, not your local devices. A tool that uses one adb server, such as Android Studio, can't use both kinds of device together.
To keep your local devices, run the bridge on another port. The bridge then leaves port 5037 to your local adb server, and Android Studio uses your local devices only. For instructions, see Using a different port.
- Rules to a socket on the device, and device mirroring in Android Studio
-
At this time, an
adb forwardoradb reverserule must usetcp:on both ends. A tool that needs a rule to a socket on the device, such as aportlocalabstract:socket, doesn't work. For example, device mirroring in Android Studio and Chrome DevTools for Chrome on the device don't work. For another way to view the screen, see Viewing the device screen while you use Android Studio.