Prerequisites
Before your start, make sure you do the following:- If you use Windows, install Git Bash.
- Install AWS CLI on your local development machine.
- Install AWS Session Manager plugin.
- Install and configure Android SDK Platform Tools so that the
adbcommand is added to the PATH environment variable. For details, see Command-line tools in the Android developer documentation.
Access the remote debug feature
First, connect to a device by following the instructions in Connect remotely to devices. On the connected device, switch to the Dashboard tab, scroll down to the Remote Debug card, and follow the on-screen instructions to make sure you meet all prerequisites. To start a remote debug session- Click Start Session.
- Follow the on-screen instructions.
- If Appstore Quality Central shows a prompt to trust your ADB fingerprint, click Add Key.
-
Verify that the device is connected locally by entering
adb devices -lat the command prompt. You should see a device listed aslocalhost:XXXXX device product:XXXXX model:XXXXX device:XXXXX transport_id:X.
Additional guidance
Use the following guidance for working with remote debug sessions.-
If you see the message
adb: device unauthorizedorlocalhost:XXXXX unauthorized transport_id:Xwhen you run adb commands, you can try to resolve this by reconnecting:- Close the current session and then open a new session.
- Follow the steps in Access the remote debug feature.
-
If you run any commands that cause the device to disconnect (such as
adb reboot), your session will disconnect. If you get disconnected, you must start a new session through Appstore Quality Central. -
adb reversecommands have no effect and any app or feature that depends onadb reversemight not function. -
If during a remote session your computer goes to sleep and wakes up, the remote device might still show up when you run
adb devices -l. However, you might not be able to run ADB commands if the remote debug session is terminated. In this case, runadb disconnectto disconnect all devices and restart the session from Appstore Quality Central.
Interact with the device locally using scrcpy
You can also interact with a remote device without needing Appstore Quality Central open in a browser tab. Using scrcpy (pronounced “screen copy”), you can interact with your device locally. With the scrcpy tool, you can display and control your device directly from your computer. To use scrcpy-
At the command prompt, run
adb devicesto find the name of the remote device. -
Launch scrcpy using the command
scrcpy --serial localhost:50104 --force-adb-forward. Replacelocalhost:50104with the name and port of the remote device that shows up underadb devices. -
For optimal performance of scrcpy, use this command:

