Amazon WorkSpaces Android Client Application - Amazon WorkSpaces

Amazon WorkSpaces Android Client Application

The following information will help you get started with the Amazon WorkSpaces Android client application.

Requirements

The Amazon WorkSpaces Android client application requires the following:

  • Amazon Kindle Fire tablets released after 2012 with Fire OS 4.0 and later.

  • Android tablets and phones with Android OS 4.4 and later. The client application works on most devices with Android version 4.4 or later, but some devices might not be compatible. If you have problems with a device, you can report the problem on the Amazon WorkSpaces forum.

    Note

    Versions of the Android client application after 2.4.15 require devices with Android OS 9 and later.

  • Chromebooks that support installing Android applications. Chromebooks launched in 2019 or later support installing Android applications. However, some Chromebooks launched before 2019 might not support installing Android applications.

    We recommend using the Android client application if your Chromebook supports it. To determine whether your Chromebook is compatible with the Amazon WorkSpaces Android client application or whether it requires the Amazon WorkSpaces Chromebook client application, see the installation steps for Chromebooks launched before 2019.

Note

The WorkSpaces Android client application is not available for the WorkSpaces Streaming Protocol (WSP) beta.

Setup and Installation

To download and install the client application, complete the following procedure.

(For devices other than Chromebooks launched before 2019) To download and install the client application

  1. On your device, open https://clients.amazonworkspaces.com/ and choose the link for your device (either Android/Chromebook or Fire Tablet).

  2. Download and install the application.

  3. Verify that the Amazon WorkSpaces client application icon appears on one of the device desktops.

(For Chromebooks launched before 2019) To download and install the client application

  1. Determine whether your Chromebook supports Android applications by checking its status on the list of Chrome OS Systems Supporting Android Apps.

  2. Depending on your Chromebook's status, do one of the following:

    • If your Chromebook's status is marked as Stable Channel, do the following:

      1. Follow the instructions in Install Android apps on your Chromebook to enable your Chromebook to install Android applications.

        Note

        In some cases, your WorkSpaces administrator might need to enable your Chromebook to install Android applications. If you are unable to install the Android client application on your Chromebook, contact your WorkSpaces administrator for assistance.

      2. On your Chromebook, open https://clients.amazonworkspaces.com/ and choose Android/Chromebook.

      3. Download and install the application.

      4. Verify that the Amazon WorkSpaces client application icon appears on one of the device desktops.

    • If your Chromebook's status is marked as Planned or if your Chromebook does not appear on the list, do the following:

      1. Determine whether your Chromebook meets the requirements of the Amazon WorkSpaces Chromebook client application:

        • The Amazon WorkSpaces Chromebook client application requires a Chromebook with Chrome OS version 45 or later. The client application works on most Chromebooks with version 45 or later, but some devices might not be compatible. If you have problems with a device, you can report the problem on the Amazon WorkSpaces forum.

        • To check the version of Chrome OS on your Chromebook, go to the status area, where your account picture appears. Choose Settings, About Chrome OS.

      2. If your Chromebook is running Chrome OS version 45 or later, open the link to the Amazon WorkSpaces Chromebook client application on the Chrome Web Store.

      3. Download and install the application.

      4. Verify that the Amazon WorkSpaces client application icon appears in your Chromebook search.

Connecting to Your WorkSpace

To connect to your WorkSpace, complete the following procedure.

To connect to your WorkSpace

  1. On your device, open the Amazon WorkSpaces client application.

  2. The first time that you run the client application, you are prompted for your registration code, which is contained in your welcome email. The Amazon WorkSpaces client application uses the registration code and user name to identify which WorkSpace to connect to. When you launch the client application later, the same registration code is used. You can enter a different registration code by launching the client application and tapping Enter new registration code on the login screen.

  3. Enter your user name and password and tap Sign In. If your Amazon WorkSpaces administrator has enabled multi-factor authentication for your organization's WorkSpaces, you are prompted for a passcode to complete your login. Your Amazon WorkSpaces administrator will provide more information about how to obtain your passcode.

  4. If your Amazon WorkSpaces administrator has not disabled the "Remember Me" feature, you are prompted to save your credentials securely so that you can connect to your WorkSpace easily in the future. Your credentials will be securely cached up to the maximum lifetime of your Kerberos ticket.

    After the client application connects to your WorkSpace, your WorkSpace desktop is displayed.

Gestures

The following gestures are supported for the Amazon WorkSpaces Android client application.

Single tap

Equivalent to a single click in Windows.

Double tap

Equivalent to a double-click in Windows.

Two finger single tap

Equivalent to a right-click in Windows.

Two finger double tap

Toggles the on-screen keyboard display. If a keyboard is attached to the device, a set of keyboard shortcuts is shown instead.

Swipe from left

Displays the sidebar menu. For more information, see Sidebar Menu.

Two finger scroll

Scrolls vertically.

Two finger pinch

Zooms display in or out.

Two finger pan

Pans the desktop when zoomed in.

Sidebar Menu

The sidebar menu is displayed by swiping from the left side of the screen.


                Android sidebar menu

The sidebar menu provides quick access to the following features:

Trackpad Mode – Turns the trackpad on or off. For more information, see Trackpad Mode.

Show Keyboard – Toggles the display of the on-screen keyboard. If a keyboard is already attached, only a row of keyboard shortcuts is displayed.

Settings – Displays controls to change the screen resolution or the scroll direction.

Connection Check – Displays the connection status.

Windows Menu – Displays the Windows Start Menu.

Disconnect – Disconnects the client application without logging off.

Keyboard

To toggle the display of the on-screen keyboard, double-tap with two fingers anywhere on the screen. Special key combinations are displayed in the top row of the keyboard.

Trackpad Mode

The trackpad mode is set using the sidebar menu.

Trackpad Mode Off

When trackpad mode is off, the mouse cursor is placed wherever you tap your finger. In this mode, a single tap is equivalent to a left mouse button click and a two finger single tap is equivalent to a right mouse button click.

Trackpad Mode On

When trackpad mode is on, the mouse cursor tracks the movement of your finger on the screen. In this mode, simulate a left mouse button click by tapping the left mouse button icon.


                    Left mouse button icon

Simulate a right mouse button click by tapping the right mouse button icon.


                    Right mouse button icon

Disconnect

To disconnect the Android client, display the sidebar menu, tap the disconnect icon, and tap Disconnect. You can also log off of the WorkSpace, which disconnects the client.

Clipboard Support

The clipboard supports copy and paste of text and HTML content only. The maximum uncompressed object size is 20 MB. For more information, see I'm having trouble copying and pasting.

Note

When copying from a Microsoft Office app, the clipboard only contains the last copied item, and the item is converted into standard format. If you copy content larger than 890 KB from a Microsoft Office app, the app might become slow or unresponsive for up to 5 seconds.

Release Notes

The following table describes the changes to each release of the Android client application.

Release Date Changes

2.4.18

October 19, 2020
  • Adds support for certain Chromebook models that were previously not supported

  • Fixes multiple key-mapping issues pertaining to English, French, and Japanese keyboard layouts

  • Adds support for faster reconnection to WorkSpaces on Chromebook devices when resuming from sleep mode

2.4.17

February 24, 2020

Minor bug fixes and enhancements

2.4.16

January 30, 2020

Adds 64-bit support for Android 9 and 10

2.4.15

June 24, 2019

Adds support for mouse cursor contextual shape changes

2.4.14

  • Adds support for the Right alt key mapping with Japanese keyboard layouts

  • Resolves an occasional issue with blue overlay

2.4.13

Minor fixes

2.4.12

  • Resolves an issue that makes the login page bounce on a few devices

  • Minor bug fixes

2.4.11

  • Resolves an issue with content being selected with two-finger scrolling

  • Minor bug fixes

2.4.10

Improves support for Japanese keyboard layouts

2.4.9

Adds support for Samsung Galaxy Note 9

2.4.7

  • Improves clipboard redirection

  • Improves DeX startup

2.4.6

Adds support for uniform resource identifiers (URIs), which enable login orchestration

2.4.5

  • Adds support for time zone redirection for more Regions: America/Indianapolis America/Indiana/Marengo America/Indiana/Vevay America/Indiana/Indianapolis

  • Includes text changes to the Login page user interface

2.4.4

Minor improvements to session provision handling

2.4.2

  • Minor fixes

  • Improves copy and paste

2.4.0

  • New logo

  • Improves the user interface and stability

2.3.4

  • Addresses a display overlay issue on Android Oreo when a mouse is connected to the device

  • Adds support for Samsung S8/S8+ screen configurations

  • Resolves minor issues

2.3.3

Localization enhancements

2.2.0

  • Adds support for the German language

  • Improves the Japanese user interface

  • Improves stability

2.1.0

  • Adds support for the following new WorkSpace states: STOPPING and STOPPED

  • Adds support for audio in, enabling you to make calls or attend web conferences

  • Resolves minor bugs and improves stability

2.0.0

  • Adds support for saving registration codes, enabling you to switch WorkSpaces without re-entering the registration codes

  • Improves usability and stability

1.0.15

  • Adds advanced connection health checks, enabling you to troubleshoot connection issues

  • Improves stability

1.0.11

  • Improves the user interface and login experience

  • Adds support for choosing the screen resolution

  • Adds support for choosing the scrolling direction

1.0.10

  • Improves the login experience

  • Adds time zone synchronization between the local device and the WorkSpace

1.0.9

Improves the login experience

1.0

Initial release

The following table describes the changes to each release of the Chromebook client application.

Note

Version 2.4.13 is the final release of the Amazon WorkSpaces Chromebook client application. Because Google is phasing out support for Chrome Apps, there will be no further updates to the WorkSpaces Chromebook client application, and its use is unsupported.

Release Date Changes

2.4.13

April 24, 2019

Fixed an issue that causes the app not to restore to full-screen mode after a screen unlock

2.4.12

Minor bug fixes

2.4.11

Minor bug fixes

2.4.10

Improves support for Japanese keyboard layouts

2.4.8

Improves support for UK keyboards

2.4.7

  • Improves clipboard redirection

  • Adds support for tap-to-click for trackpads

  • Improves device resolution

2.4.6

  • Resolves an issue that causes screens to freeze

  • Resolves trackpad issues

2.4.5

  • Adds support for time zone redirection for more Regions: America/Indianapolis America/Indiana/Marengo America/Indiana/Vevay America/Indiana/Indianapolis

  • Includes text changes to the Login page user interface

2.4.4

Minor improvements to session provision handling

2.4.2

Resolves a bug with Caps Lock

2.4.0

  • New logo

  • Improves the user interface and stability

2.2.7

Resolves minor issues

2.2.4

Localization enhancements

2.2.1

  • Adds support for the German language

  • Improves the Japanese user interface

  • Improves stability

2.1.3

  • Adds support for the following new WorkSpace states: STOPPING and STOPPED

  • Adds support for audio in, enabling you to make calls or attend web conferences

  • Resolves minor bugs and improves stability

2.0.0

  • Adds support for saving registration codes, enabling you to switch WorkSpaces without re-entering the registration codes

  • Improves usability and stability

1.0

Initial release