Release Notes

Client SDK for macOS 22.04

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 guides.
  • Build clients that adapt to customized workflows (for example, embed a PCoIP session into a software solution).

PCoIP Client SDK 22.04 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 of the PCoIP Client SDK for macOS contains the following updates:

Setting Log-Levels via the PCoIP Client UI

In this release of the PCoIP Software Client for macOS, you can set the log-level of the PCoIP Client in the pre-session UI. For information on how to do this, see Setting Log Levels

macOS 12 (Monterey) Support

In this release of the PCoIP Software Client for macOS, macOS 12 (Monterey) support has been added.

Collaboration Enhancements

In this release of the PCoIP Software Client for macOS, collaborators can now connect to PCoIP Ultra Collaboration sessions initialized on Windows and Linux PCoIP Agents in addition to the existing macOS PCoIP Agent support. Guest collaborators can connect using a CAS brokered connection when using the latest Modern Connection Manager, no longer requiring a direct connection to the shared PCoIP Agent. See Collaboration for more information on this feature.

Relative Mouse Menu and Hot Key

In this release of the PCoIP Software Client for macOS, you can turn on/off the Relative Mouse feature using an in-session menu or hot key combination. For more information on this, see Enabling Relative Mouse.

Security and Stability Updates

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

Release History

Version/Build

Date

Description

3.5 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
21.07 August 2021 GA release
21.10 October 2021 GA release
22.01 January 2022 GA release
     

Compatibility 


 

Supported Clients

PCoIP Software Client for Mac

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

  • macOS Catalina (10.15) Darwin v19
  • macOS Big Sur (11.0) Darwin V20 This OS does not support connecting USB devices to a remote desktop.
  • Apple M1 Hardware. This processor does not support USB or PCoIP Ultra.
  • macOS Monterey (12.0)

 

Supported Hosts

Teradici Cloud Access Software Agents
PCoIP Remote Workstation Cards
Known Issues

Audio does not work when connected to a Remote Workstation Card

 
144640

Audio in/out is not available when the host is a Remote Workstation Card

Workaround:

Use PCoIP Client version 21.07 if audio functionality is required with the Remote Workstation Card.

macOS client only detects audio output device at session start

 
132429

The macOS client will not detect a change in the audio output device while in session.

Workaround:

Disconnect and reconnect to the session when changing the audio output device.

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.