Release Notes

Client SDK for macOS 21.03

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.03 for Mac:

Security and Stability Updates

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

PCoIP Client Command Line Parameters Added

New command line parameters have been added to the PCoIP Client for macOS. For information on these parameters, see here.

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

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

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

122555

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

Fixed issue with PCoIP Ultra GPU Offload

113653

Several libraries required to support GPU offload were not included in the Client SDK. These are now packaged with the Client SDK.

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.

PCoIP Client will crash on illegal instruction on M1 Mac with PCoIP Ultra GPU Offload

116740

If PCoIP Ultra GPU Offload or Auto Offload is enabled on the PCoIP Agent, the PCoIP Client running on an M1 Mac will crash due to an illegal instruction that Rosetta 2 cannot translate for the M1 processor.

Workaround:

To disable PCoIP Ultra on the PCoIP Client for macOS, add the following line to ~/.pcoip.rc:

pcoip.enable_h264 = 0

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.