Release Notes

Client SDK for macOS 21.07

Important Notes and Requirements

  • Use of Anyware Client SDK requires a separate agreement with HP Anwyare.

  • The SDK is intended for use cases where client customizations are required and when Anyware Software Clients, PCoIP Zero Clients, and PCoIP Mobile Clients are not sufficient. 

  • The SDK is intended for customers with software development skills and knowledge, as well as a sound understanding of virtualization systems.

Release Overview

The PCoIP Client Software Development Kit (SDK) is a set of libraries and binaries provided to Teradici Cloud Access Platform customers who require the ability to customize and build a PCoIP client.

With control over how the PCoIP client is built, you can:

  • Build clients that conform to your company style and branding guidelines.
  • Build clients that adapt to customized workflows (for example, embed a PCoIP session into a software solution).

PCoIP Client SDK 21.03 introduces new fixes and updates to the previous release. This article provides a summary of key additions, compatibility notes, resolved issues, and known issues for this release.

To build additional functionality, such as extended peripheral support, you can utilize the Teradici PCoIP Virtual Channel SDK.

What's New in This Release 

This release introduces the following features and enhancements to the PCoIP Client SDK 21.07 for macOS:

Security and Stability Updates

Increased security and stability updates and enhancements around the PCoIP Client SDK.

Changes in PCoIP Client Keyboard Handling

The keyboard handling of the PCoIP Client for macOS has be updated to support the PCoIP Agent for macOS. New default handling for the CMD key to capture and send to remote systems when the PCoIP Client application is in focus. Additionally, the CMD key will no longer be mapped to the CTRL key. This functionality is on by default. For further information on this feature, see here.

TLS 1.1 Deprecation

The PCoIP Client SDK for macOS will no longer negotiate Broker or PCoIP connections using TLS 1.1.

Important Notes and Requirements

  • The PCoIP Client SDK is intended for Teradici Cloud Access customers only.

  • The SDK is intended for customers who require client customizations when PCoIP Software Client for Windows and Mac, PCoIP Zero Clients, and PCoIP Mobile Clients do not meet their needs. 

  • The SDK is intended for customers with software development skills and knowledge, as well as a sound understanding of virtualization systems.

Release History

Version/Build

Date

Description

3.5.0 April 2018 GA release
3.6.1 July 2018 GA release
3.7.0 October 2018 GA release
3.8.0 February 2019 GA release
19.05 May 2019 GA release
19.08 August 2019 GA release
19.11 November 2019 GA release
20.01 January 2020 GA release
20.04 April 2020 GA release
20.07 July 2020 GA release
20.10 October 2020 GA release
21.01 January 2021 GA release
21.03 April 2021 GA release

Compatibility 


 

Supported Clients

PCoIP Client SDK for macOS

PCoIP Client SDK for Mac is compatible with the following Apple operating systems:

    • macOS Catalina (10.15) Darwin v19
    • macOS Mojave (10.14) Darwin v18
    • macOS Big Sur (11.0) Darwin v 20 This OS does not support connecting USB devices to a remote desktop.
    • Apple M1 Hardware. This processor does not support USB or PCoIP Ultra.

 

 

Supported Hosts

Teradici Cloud Access Software
Resolved Issues

Fixed issue with USB Devices menu with macOS client running on Catalina or Mojave

130948

Fixed an issue with the USB driver which prevented USB devices from being connected to the remote desktop.

Fixed issue with client connecting to Cloud Access Connector (CAS Manager) that was configured for external access

129546

Fixed an issue that prevented the client from connecting to a Cloud Access Connector server that is configured for external access.

Fixed mouse coordinates for specific display topologies

103635

There were a number of display topologies where the mouse coordinates were not accurately calculated. This resulted in the mouse pointer being drawn at the wrong locations. Some of these conditions occurred only when relative mouse was enabled.

Known Issues

macOS client may only minimize one display on OS X 10.11

61740

If you launch the PCoIP Software Client in OS X 10.11 and you have not clicked anywhere within the display before using the minimize hot key (Ctrl+Alt+M), the display that has not been used will not be minimized. This does not occur in macOS 10.12 (Sierra) or 10.13 (High Sierra).

Workaround:

Click with the mouse on both displays of the client any time before pressing Ctrl+Alt+M, and both displays will be minimized.

Using an invalid or corrupt branding package crashes client

61678

If the branding package does not match the hash value specified for the branding package, the session client will terminate.

Workaround:

Replace the corrupt branding file or use the correct hash value.

Datalogic barcode scanner cannot be redirected when bridged in macOS

44028

The Datalogic Quickscan QS6500 barcode scanner does not work when the device is bridged.

Workaround:

Do not bridge the device. The device works as expected with the remote host when it is not bridged.

USB keyboards do not work in bridged mode

40580

Keyboards do not work when bridged. This affects both Windows and macOS PCoIP Software Client.

Workaround:

Do not bridge the keyboard. Keyboards function correctly when locally terminated.

Audio input in PCoIP Software Client with PCoIP Remote Workstation Card does not work

26355

When in session with a PCoIP Remote Workstation Card, PCoIP Software Client supports audio out from the host, but not audio into the host.