WorkSpaces iPad client application - Amazon WorkSpaces
RequirementsSetup and installationConnect to your WorkSpaceGesturesRadial menuKeyboard and command shortcutsMouse modesSwiftpoint GT, ProPoint, or PadPoint mouseDisconnectClipboard supportRelease notes

WorkSpaces iPad client application

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

Requirements

The WorkSpaces iPad client application requires the following:

  • iPad 2 or later with iOS 8.0 to 17.0

  • iPad Retina with iOS 8.0 to 17.0

  • iPad Mini with iOS 8.0 to 17.0

  • iPad Pro with iOS 9.0 to 17.0

Note

  • The Amazon WorkSpaces iPad client application is not available for the DCV.

  • If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use version 2.4.17 or later of the Amazon WorkSpaces iPad client application.

  • If your iPad is using iPadOS 14.5 to 17.0, we recommend using version 2.4.18 or later of the Amazon WorkSpaces iPad client application.

Setup and installation

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

To download and install the client application

  1. On your iPad, open Amazon WorkSpaces Client Downloads and choose the iPad link.

  2. Download and install the application.

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

Connect to your WorkSpace

To connect to your WorkSpace, complete the following procedure.

To connect to your WorkSpace

  1. On your iPad, 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 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 choosing Enter new registration code on the login screen.

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

  4. If your 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 WorkSpaces iPad 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.

Swipe from left

Displays the radial menu. For more information, see Radial menu.

Two finger scroll

Scrolls vertically.

Two finger pinch

Zooms display in or out.

Two finger pan

Pans the desktop when zoomed in.

Radial menu

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

iPad radial menu with the buttons for settings, connection status, disconnect/connect, direct mouse mode, help, keyboard, Windows start menu, and offset mouse mode.

The radial menu provides quick access to the following features:

iPad radial menu button for settings. Settings – Displays controls to change the screen resolution, change the scroll direction, or connect or disconnect the Swiftpoint GT, ProPoint, or PadPoint mouse.

iPad radial menu button for connection status. Connection Status – Displays the connection status of the WorkSpace.

iPad radial menu button for radial power. Disconnect – Disconnects the client application without logging off.

iPad radial menu button for direct mouse mode. Direct Mouse Mode – Sets the input to direct mouse mode. For more information, see Mouse modes.

iPad radial menu button for help. Help – Displays the command and gesture tutorial.

iPad radial menu button for keyboard. Keyboard – Toggles the display of the on-screen keyboard.

iPad radial menu button for Windows start menu. Windows Start Menu – Displays the Windows Start Menu.

iPad radial menu button for mouse mode. Offset Mouse Mode – Sets the input to offset mouse mode. For more information, see Mouse modes.

Keyboard and command shortcuts

To toggle the display of the on-screen keyboard, double-tap with two fingers anywhere on the screen. Special key combinations (command shortcuts) that are frequently used in Windows, such as Ctrl+Alt+Del, Alt+Tab, Ctrl+A, Ctrl+C, Ctrl+V, Ctrl+X, and so on, are displayed in the top row of the on-screen keyboard.

If you have a full-size physical keyboard attached to your iPad, you can use Control+Option+Delete Forward delete key on iPad keyboard to send Ctrl+Alt+Del to your Windows WorkSpace. (Be sure to use the forward Delete key, not the backspace Delete key.)

Mouse modes

The mouse mode is set using the radial menu.

Direct mode

In direct mouse mode, 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.

Offset mode

In offset mouse mode, 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

Swiftpoint GT, ProPoint, or PadPoint mouse

You can use the Swiftpoint GT, ProPoint, or PadPoint mouse on an iPad to interact with your WorkSpace. To do so, before you launch the Amazon WorkSpaces iPad client application, enable Bluetooth on your iPad and pair the Swiftpoint mouse with your iPad (the Swiftpoint mouse should pair automatically). To connect the Swiftpoint mouse and your iPad client, display the radial menu, and tap Settings. For SwiftPoint GT Mouse, choose Connect.

Note

Although the Swiftpoint GT mouse is no longer available, you can use the Swiftpoint ProPoint and PadPoint mice with the Amazon WorkSpaces iPad client application instead. The Swiftpoint TRACPOINT, PenPoint, and GoPoint mice aren't supported for use with the WorkSpaces iPad client. For more information, see Swiftpoint GT Mouse.

iPads with iPadOS 13.4 or later also support Bluetooth mice. For more information, see Use a Bluetooth mouse or trackpad with your iPad in the Apple Support documentation.

Disconnect

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

To quit the WorkSpaces iPad client application

  1. Open the App Switcher by doing one of the following:

    • Swipe up from the bottom edge and pause in the center of the screen.

    • Double-click the Home button (on an iPad with a Home button).

  2. Swipe up on the WorkSpaces iPad client application to close it.

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 iPad client application.

Release Date Changes

2.4.24

 May 9, 2023

  • Added connection support to WorkSpaces provisioned in the AWS GovCloud (US-East) Region

  • Added accessibility enhancements

2.4.19

 Oct 20, 2021

Resolves the issue of users not being able to close the on-screen keyboard in iPadOS 15.

2.4.18

 May 9, 2021

Addresses the crash on startup issue on iPadOS 14.5

2.4.17

 February 18, 2021

Improved Japanese keyboard support

2.4.16

 September 27, 2020

Minor bug fixes and enhancements

2.4.15

 June 28, 2020

  • Adds native mouse and trackpad support on iPadOS 13.4+

  • Fixes instances of keyboard shortcuts not working from external keyboards on iPadOS 13.4+

  • Includes improved error messaging and mouse pointer related UI enhancements

  • Minor bug fixes

2.4.14

 April 17, 2020

  • Running the client application on a jailbroken device is no longer supported

  • Minor bug fixes

2.4.13

 February 28, 2020

Minor bug fixes

2.4.11

 October 28, 2019

  • Resolves an issue that can periodically result in repeated key presses with WorkSpaces running Amazon Linux 2

  • Resolves an issue with reconnecting to WorkSpaces

  • Minor bug fixes

2.4.9

Minor bug fixes

2.4.7

Closing the WorkSpaces client app now expires the reconnect token. You can only reconnect to your WorkSpace when the client app is running.

2.4.6

Minor fixes to the on-screen keyboard

2.4.5

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

2.4.4

  • 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.3

  • Adds support for the Swiftpoint GT mouse scroll wheel

  • Minor improvements to session provision handling

2.4.2

  • Minor fixes

  • Improves copy and paste

  • Adds initial support for the Swiftpoint GT mouse (the scroll wheel is not supported)

2.4.0

  • New logo

  • Improves the user interface and stability

2.2.4

Localization enhancements

2.2.3

  • Enables ATS to support HTTPS TLS 1.2

  • Adds a microphone privacy statement

  • Improves the default resolution for iPad Pro models

  • Improves localization in multiple languages

  • Resolves a black screen issue on 9.7-inch iPad Pro models

  • Resolves the app icon zooming issue on iOS 10

  • Resolves an audio echo issue

  • Security fixes and various improvements

2.2.0

  • Adds support for audio session management, enabling you to play music in the background while using WorkSpaces

  • Adds support for the German language

  • Adds support for local IPv6 networking

2.1.0

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

  • 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

  • Resolves an issue with arrow key support on Bluetooth keyboards

  • Resolves an issue with Bluetooth keyboards inadvertently activating the on-screen shortcut bar

  • Improves usability and stability

1.1

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

  • Improves stability

1.0.11

Improves stability on iOS 8

1.0.10

Improves stability

1.0.9

  • Improves the user interface and login experience

  • Adds support for choosing the screen resolution

  • Adds support for choosing the scrolling direction

1.0.8

  • Improves error messages

  • Improves the Bluetooth keyboard experience

  • Improves the scrolling experience

1.0.7

Improves the login experience

1.0.6

Improves the login experience

1.0.5

  • Improves the login experience

  • Improves network connectivity

1.0.4

Improves the login experience

1.0.3

Improves the login experience

1.0.2

  • Adds connection health checks

  • Resolves specific issues with the iPad Air and iPad mini

1.01

Improves radial functionality

1.0

Initial release