About this release 编辑

What’s new in 2211

This release addresses issues that help to improve overall performance and stability.

Fixed issues in 2211

• The VDA might crash after redirecting the Audio interface of the device. This issue occurs when you enable the “Client USB device redirection” policy on DDC and attach composite USB devices to the endpoint, such as the USB Headset. [HDX-44117]
• The QWERTY keyboard of Bloomberg 4 might be locked to the session after using the USB redirection. [HDX-44555]
• You might fail to register and use your YubiKey devices with PIN code on Citrix Workspace app. [HDX-44951]

Known issues in 2211

• When the snap-store process runs in the background, you might not be able to start protected apps and desktops. As a workaround, close the snap process to start protected apps and desktops. [APPP-110]
• Transaction ID error messages might appear when you start a session. For example: “The option “-transactionid” is invalid”. As a workaround, click OK to close the message box and proceed. [HDX-45618]

• When you install and start Citrix Workspace app, the following error message might appear:

  “The X request 130.1 caused error:”10: BadAccess(Attempt to access private resource denied”

  Click Cancel to proceed with the session. [HDX-44416]

• When you sign out from the Citrix Workspace app and sign in again, the Citrix Workspace app starts without entering the sign-in credentials. This issue occurs only in cloud deployments and if the longLivedTokenSupport parameter value is set to True. As a workaround, do the following:

  1. Navigate to the /config/AuthManConfig.xml file.
  2. Go to the [AuthManLite] section and update the following entry:

  <longLivedTokenSupport>false</longLivedTokenSupport>

  [RFLNX-9160]

Note:

For a complete list of issues in the earlier releases, see Known issues.

Earlier releases

This section provides information on the new features and fixed issues in the previous releases that we support as per the Lifecycle Milestones for Citrix Workspace app.

2209

What’s new

Support for authentication using FIDO2 [Technical Preview]

With this release, you can authenticate virtual apps or desktops by using FIDO2 security keys. FIDO2 security keys provide a seamless way for enterprise employees to authenticate to apps or desktops that support FIDO2 without entering a user name or password. For more information about FIDO2, see FIDO2 Authentication.

Note:

If you’re using the FIDO2 device through USB redirection, remove the USB redirection rule of your FIDO2 device from the usb.conf file in the $ICAROOT/ folder. This update helps you to switch to the FIDO2 virtual channel.

By default, FIDO2 authentication is disabled. To enable FIDO2 authentication, do the following:

1. Navigate to the <ICAROOT>/config/module.ini file.
2. Go to the ICA 3.0 section.
3. Set FIDO2= On.

This feature currently supports roaming authenticators (USB only) with PIN code and touch capabilities. You can configure FIDO2 Security Keys based authentication. For information about the prerequisites and using this feature, see Local authorization and virtual authentication using FIDO2.

When you access an app or a website that supports FIDO2, a prompt appears, requesting access to the security key. If you’ve previously registered your security key with a PIN (a minimum of 4 and a maximum of 64 characters), then you must enter the PIN while signing in.

If you’ve registered your security key previously without a PIN, simply touch the security key to sign in.

Limitation:

You might fail to register the second device to a same account using FIDO2 authentication.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Keyboard input mode enhancements [Technical Preview]

Previously, you were able to enable different keyboard input modes only by updating the value of KeyboardEventMode in the configuration file. There was no UI option to select the keyboard input mode.

Starting with Citrix Workspace app 2209, you can configure different keyboard input modes from the newly introduced Keyboard input mode settings section. You can select Scancode or Unicode as keyboard input mode.

For more information, see Keyboard input mode enhancements in the Keyboard layout synchronization documentation.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Support for extended keyboard layouts [Technical Preview]

Starting with Citrix Workspace app version 2209, the Scancode keyboard input mode supports the following extended keyboard layouts:

• Japanese 106 keyboard
• Portuguese ABNT/ABNT2 keyboards
• Multimedia keyboards

The Scancode keyboard input mode supports the extended keyboard layouts along with all keyboard layout synchronization modes.

This support is enabled by default.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Microsoft Teams enhancements

• App sharing enabled: Starting with Citrix Workspace app 2209 for Linux and Citrix Virtual Apps and Desktops 2109, you can share an app using the Screen sharing feature in Microsoft Teams.
• Enhancements to high DPI support: When the high DPI feature is enabled and you’re using 4K monitors, Microsoft Teams video overlays are in the desired position and of the correct size. Irrespective of your display settings such as single or multi-monitor arrangements, overlays always appear correctly and aren’t scaled up or appear in an undesired position. To enable this enhancement, ensure that the DPIMatchingEnabled parameter in the wfclient.ini configuration file is set to True. For more information, see Support for DPI matching.
• WebRTC SDK upgrade: The version of the WebRTC SDK that is used for the optimized Microsoft Teams is upgraded to version M98.

Upgraded version of compatibility libraries

Starting with this release, Citrix Workspace app for Linux is compatible with the following libraries:

• glibc 2.27 or later
• glibcxx 3.4.25 or later

App Protection update

Note:

App Protection is not supported on Ubuntu 22.04. As a result, if you install the App Protection module on Ubuntu 22.04, you might not be able to start virtual apps and desktops in the Citrix Workspace app. For more information on App Protection, see App Protection.

Fixed issues

• When the App Protection feature is enabled, the anti-keylogging functionality might not work for the Authentication Manager interface that loads the web page in a separate window. [RFLNX-9004]
• After upgrading to Citrix Workspace app 2007 for Linux, adding a Store using Storebrowse might take long time as the Store attempts to contact the app config service that is unreachable. [CVADHELP-20618]
• When you connect to a cloud store from the self-service user interface, a spinning wheel might appear on the sign-in page. [CVADHELP-20039]
• When you start two apps from two different delivery groups, there might be a delay in starting the second app. [CVADHELP-18198]

2207

What’s new

Enhancement to improve audio quality

Previously, the maximum output buffering value to play the audio smoothly was 200 ms in Citrix Workspace app. Because of this value set, 200 ms latency was added in the playback scenario. This maximum output buffering value had an impact on interactive audio applications as well.

With this enhancement, the maximum output buffering value is decreased to 50 ms in Citrix Workspace app. As a result, the user experience on the interactive audio application is improved. Also, the Round trip time (RTT) is decreased by 150 ms.

Starting with this release, you can select the appropriate playback threshold and pulse audio prebuffer to improve the audio quality. For this enhancement, the following parameters are added in the [ClientAudio] section of the module.ini file:

• PlaybackDelayThreshV4 – To specify the initial level of output buffering in milliseconds. Citrix Workspace app tries to maintain this level of buffering throughout a session’s duration. The default value of the PlaybackDelayThreshV4 is 50 ms. This parameter is valid only when AudioRedirectionV4 is set to True.
• AudioTempLatencyBoostV4 – When the audio throughput undergoes a sudden spike or isn’t enough for an unstable network, this value increases the output buffering value. This increase in the output buffering value provides smooth audio. However, the audio might be slightly delayed. The default value of AudioTempLatencyBoostV4 is set to 100 ms. This parameter is only valid when AudioRedirectionV4 is set to True and AudioLatencyControlEnabled is set to True. By default, the value of AudioLatencyControlEnabled is set to True.

For more information on how to enable this enhancement, see the Enhancement to improve audio quality section in the Audio documentation.

Support for DPI matching [Technical Preview]

With this release, the display resolution and DPI scale values set in the Citrix Workspace app match to the corresponding values in the virtual apps and desktops session. You can set the required scale value in the Linux client, and the scaling of the VDA session is updated automatically.

DPI scaling is mostly used with large size and high-resolution monitors. This feature helps to display the following in a size that can be viewed comfortably:

• Applications
• Text
• Images
• Other graphical elements

Limitation:

Currently, the DPI matching feature does not support the fractional scaling on the client side. If the DPI scale value is high, the Microsoft Teams optimization might not support as expected.

For more information on how to enable this feature, see Support for DPI matching.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Composite USB device redirection

Starting with this release, Citrix Workspace app allows splitting of composite USB devices. A composite USB device can perform more than one function. These functions are accomplished by exposing each of those functions using different interfaces. Examples of composite USB devices include HID devices that consist of audio and video input and output.

Currently composite USB device redirection is available in desktop session only. The split devices appear in the Desktop Viewer.

Earlier when a device was unplugged and plugged in during a session, the device was auto-redirected. As a result, the device was auto connected to the VDA. With this release, you are required to enable auto-redirection manually through configuration file settings. Auto-redirection of composite USB devices is disabled, by default.

For more information on configuring composite USB device redirection, see the Composite USB device redirection section in the USB documentation.

Improved audio echo cancellation support [Technical Preview]

Starting with this release, Citrix Workspace app supports echo cancellation. This feature is designed for real-time user cases, and it improves the user experience. The echo cancellation feature supports low quality, medium quality, and adaptive audio. Citrix recommends using adaptive audio for better performance.

By default, the echo cancellation feature is disabled. During real-time user cases, it is recommended to turn on the echo cancellation if the speaker is used instead of the headset.

Limitation:

By design, the echo cancellation feature is disabled for high quality audio.

For more information, see the Improved audio echo cancellation support section in the Audio documentation.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Support for secondary ringer

You can use the Secondary ringer feature to select a secondary device on which you want to get the incoming call notification when Microsoft Teams is optimized (Citrix HDX optimized in About/Version). For example, consider that you have set a speaker as the Secondary ringer and your endpoint is connected to the headphone. In this case, Microsoft Teams sends the incoming call signal to the speaker even though your headphones are the primary peripheral for the audio call itself. You can’t set a secondary ringer in the following cases:

• When you aren’t connected to more than one audio device
• When the peripheral is not available (for example, Bluetooth headset)

Note:

This feature is available only after the roll-out of a future update from Microsoft Teams. To know when the update is rolled-out by Microsoft, see the Microsoft 365 roadmap. You can also refer to CTX253754 for the documentation update and the announcement.

Fixed issues

• When you launch a desktop in full-screen mode using the Lightweight X11 Desktop Environment (LXDE) and disconnect from the network, you get a Connection to <XXX> has been lost error message with a Quit option on the dialog. The message appears if the Auto Client Reconnect (ACR) or Session Reliability (SR) policy is expired. When you click Quit, the user desktop disappears. However, if you click anywhere else on the screen, the Quit button might never appear on the dialog. You must manually exit the user desktop by pressing the Esc or Enter key. [CVADHELP-17478]
• Citrix Workspace app for Linux might interpret URLs containing the string, cloud (for example <xxx-yyy-cloud.com>) as cloud domain URLs even if they represent on-premises URLs. [CVADHELP-19480]
• The session might disconnect while you try to use the HDX webcam. The issue occurs only in VDA version 2203. [CVADHELP-20223]
• Copying and pasting content between published applications, VDI sessions, or a VDI session and a published application might fail. The session or the application might become unresponsive for some time. [CVADHELP-19899]
• When you preview a video using a webcam in the Skype, the preview might show a black screen. [HDX-37860]
• HDX RealTime Webcam video compression does not support camera with MJPEG video format in Citrix Workspace app. [HDX-40352]
• While sharing the screen or an app during the Microsoft Teams call, your peer might see visual artifacts. This issue occurs due to unstable frame rates, such as incorrect video playback (frozen or transient black frames). This release includes improved frame rates or sampling rates that help to reduce visual artifacts. [HDX-38032]
• The video or an image in Citrix Workspace app might not render correctly. This issue occurs when Citrix Workspace app is used along with VDA version 2109 or later. [HDX-40287]
• When you launch wfica with the -span o command, the session might fail to launch and span across all available monitors. Similarly, when you launch wfica with the -span h command, the list of the monitors currently connected to the user device might fail to print. [HDX-32519]
• When you launch wfica with the -span o command, the session might fail to launch and span across all available monitors. Similarly, when you launch wfica with the -span h command, the list of the monitors currently connected to the user device might fail to print. For more information, see command reference. [HDX-32519]
• When an SSL error occurs on one protocol during a TCP and EDT/UDP connection attempt, both connections might fail because of the race condition. This SSL error can occur if the TLS configuration differs between the protocols, and the client cannot connect via one protocol. [RFLNX-8747]
• When you try to connect remotely to a machine that has Citrix Workspace app with App Protection installed, the x11vnc server crashes and the connection fail. As a result, you might not be able to connect remotely to the machine through x11vnc server. [RFLNX-8933]
• When you add a store with default settings, the Storebrowse enumeration might fail. This issue occurs only in the Debian 32-bit OS. [RFLNX-8743]
• You might get an error message when you install the Citrix Workspace app with App Protection feature enabled on 32-bit Linux machines. [RFLNX-8809]
• When you add a store using the storebrowse -a command and enumerate using the storebrowse -E command, the Storebrowse enumeration might fail. This issue occurs only in the Raspberry Pi OS. [RFLNX-8803]

2205

What’s new

Authentication enhancement for Storebrowse

Note:

This feature is generally available for Citrix Workspace app.

Starting with this release, the authentication dialog is present inside Citrix Workspace app and the store details are displayed on the logon screen. This feature provides a better user experience. The authentication tokens are encrypted and stored so that you don’t need to reenter credentials when your system or session restarts.

You can also toggle the authentication enhancement for Storebrowse feature off or on using the StorebrowseIPC key in the AuthmanConfig.xml file. By default, the toggle functionality is disabled.

The authentication enhancement supports storebrowse for the following operations:

• Storebrowse -E: Lists the available resources.
• Storebrowse -L: Launches a connection to a published resource.
• Storebrowse -S: Lists the subscribed resources.
• Storebrowse -T: Terminates all sessions of the specified store.
• Storebrowse -Wr: Reconnects the disconnected yet active sessions of the specified store. The [r] option reconnects all the disconnected sessions.
• storebrowse -WR: Reconnects the disconnected yet active sessions of the specified store. The [R] option reconnects all the active and disconnected sessions.
• Storebrowse -s: Subscribes the specified resource from a given store.
• Storebrowse -u: Unsubscribes the specified resource from a given store.
• Storebrowse -q: Launches an application using the direct URL. This command works only for StoreFront stores.

Note:

• You can continue to use the remaining storebrowse commands as used earlier (using AuthMangerDaemon).
• The authentication enhancement is applicable for cloud deployments only.
• With this enhancement, the persistent login feature is supported.

For more information, see the Authentication enhancement.

Persistent login [Technical Preview]

The Persistent login feature enables you to stay logged in for up to the duration (2–365 days) configured by your admin. When this feature is enabled, you need not provide login credentials for the Citrix Workspace App during the configured period.

With this functionality, the SSO to Citrix DaaS sessions is extended up to a period of 365 days. This extension is based on the lifetime of Long-Lived Tokens. Your credentials are cached by default for 4 days or Lifetime whichever is lower. And, then extended when you become active within these 4 days by connecting to the Citrix Workspace App.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

For more information, see Persistent login.

Email-based auto-discovery of store

Note:

This feature is generally available for Citrix Workspace app.

You can now provide your email address in Citrix Workspace app to automatically discover the store associated with the email address. If there are multiple stores associated with a domain, by default the first store returned by the Global App Configuration Service is added as the store of choice. Users can always switch to another store if necessary.

For more information, see the Email-based auto-discovery of store section at Adding store URL to Citrix Workspace app documentation.

Provision to disable LaunchDarkly service

Starting with this release, you can disable LaunchDarkly service on Citrix Workspace app.

For more information, see Feature flag management documentation.

Fixed issues

• The DNS server in a customer environment with limited internet access might not resolve the URL, clientstream.launchdarkly.com. As a result, Citrix Workspace app sends a large number of DNS queries (>1000 within three seconds per day) to the URL. [CVADHELP-19559]
• When the App Protection feature is enabled, the anti-keylogging functionality might not work for the Authentication Manager interface that uses the UIDialogLibWebKit3.so library. This issue is resolved in the gnome and kde desktop environment. [RFLNX-8027]
• Attempting to print from a VDA session running on Raspberry Pi ARMHF client version 3 or 4 might make the session unresponsive. [CVADHELP-18506]

• When you launch the self-service user interface with the default settings, the following error message might appear:

  “Response for Secondary Token request is not 200/400/404 42”

  This issue occurs on Fedora 35. [RFLNX-8603]

2203

What’s new

Support for EDT IPv6

Starting with this release, Citrix Workspace app supports EDT IPv6.

Support for TLS protocol version 1.3

Starting with this release, Citrix Workspace app supports Transport Layer Security protocol (TLS) version 1.3. For more information, see TLS.

Custom web stores

Starting with 2203, this feature is generally available for Citrix Workspace app. You can access your organization’s custom web store from the Citrix Workspace app.

Note:

The Pinning multi-monitor screen layout feature is not supported in the custom web store.

For more information, see Custom web stores.

Authentication enhancement experimental feature

Starting with this release, authentication enhancement supports storebrowse for the following operations:

• Storebrowse -E to list the available resources.
• Storebrowse -L to launch a connection to a published resource.
• Storebrowse -S to list the subscribed resources.

Note:

You can continue to use the remaining storebrowse commands in the AuthMangerDaemon and will be supported with authentication enhancement in the future release.

For more information, see Authentication enhancement for Storebrowse.

Keyboard layout synchronization enhancement

Keyboard layout synchronization enables you to switch among preferred keyboard layouts on the client device. This feature is disabled by default. When enabled, the client keyboard layout automatically synchronizes to the Citrix Virtual Apps and Desktops and Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) session.

Starting with version 2203, Citrix Workspace app supports the following three different keyboard layout synchronization modes:

• Sync only once - when session launches – Based on the KeyboardLayout value in the wfclient.ini file, the client keyboard layout is synchronized to the server when the session launches. If the KeyboardLayout value is set to 0, the system keyboard is synchronized to VDA. If the KeyboardLayout value is set to a specific language, the language-specific keyboard is synchronized to VDA. Any changes you make to the client keyboard layout during the session do not take effect immediately. To apply the changes, sign out and sign in to the app. The Sync only once - when session launches mode is the default keyboard layout selected for Citrix Workspace app.
• Allow dynamic sync - This option synchronizes the client keyboard layout to the server when you change the client keyboard layout.
• Don’t sync - Indicates that the client uses the keyboard layout present on the server.

For more information, see Keyboard layout synchronization.

Multi-window chat and meetings for Microsoft Teams

You can use multiple windows for chat and meetings in Microsoft Teams, when optimized by HDX in Citrix Virtual Apps and Desktops 2112 or higher. You can pop out the conversations or meetings in various ways. For details about the pop-out window feature, see Teams Pop-Out Windows for Chats and Meetings.

If you’re running an older version of Citrix Workspace app or Virtual Delivery Agent (VDA), remember that Microsoft will deprecate the single-window code in the future. However, you can upgrade to a version of the VDA or Citrix Workspace app that supports multiple windows (2203 and greater). To upgrade to a higher version, you will have a minimum of nine months after this feature is generally available.

Note:

This feature is available only after the roll-out of a future update from Microsoft Teams. When the update is rolled-out by Microsoft, you can check CTX253754 for the documentation update and the announcement.

Enhancement to auto-redirection of USB devices

Earlier when a device was unplugged and plugged in during a session, the device was auto-redirected. As a result, the device was auto-connected to the VDA. With this release, you are required to enable auto-redirection manually through configuration file settings. Auto-redirection of USB devices is disabled, by default. For more information, see USB section.

Fixed issues

• When you add a store and authenticate it to the Citrix Workspace app, the authentication window is loaded for the second time, even after successful authentication. This issue occurs when you first sign into the Citrix Workspace app after setting the AuthManLiteEnabled to True. [RFLNX-8694]
• After you install the Citrix Workspace app with App Protection feature enabled on OS that uses glibc 2.34 or later, the OS boot might fail on restarting the system. [RFLNX-8358]
• When you are using Microsoft Teams to make a P2P call or to attend a meeting, and wait for some time, the load for one CPU core might increase to 100% due to socket error. [HDX-38974]
• Citrix Workspace app does not support the new version of Raspberry Pi OS based on the Debian bullseye. [HDX-37000]
• When you launch a session with the ICA file and sign off from the session, the expected return value that you receive from the wfica command line is 0. However, instead of the expected value, the value that you receive is 2. This issue occurs in Citrix Workspace app version 2106 or later. [HDX-38916]

• In Citrix Workspace app, you might experience intermittent failures when answering or making a Microsoft Teams call. The following error message appears:

  “Call could not be established.”

  [HDX-38819]

2202

What’s new in 2202

UDP audio through Citrix Gateway

Note:

This enhancement is generally available for Citrix Workspace app.

With this release, Citrix Workspace app supports Datagram Transport Layer Security (DTLS) protocol for UDP audio. As a result, you can access the UDP audio through Citrix Gateway.

To enable UDP audio through Citrix Gateway:

1. Navigate to the <ICAROOT>/config folder and open the module.ini file.

2. Go to the [WFClient] section and set the following entry:

   EnableUDPThroughGateway=True

3. Go to the [ClientAudio] section and set the following entry:

   EnableUDPAudio=True

For more information, see the Enabling UDP audio section in the Audio documentation.

Note:

If you use the StoreFront default.ica configuration, the value of EnableUDPThroughGateway set in the [Application] section takes precedence over the value set in the module.ini file. However, you can set the EnableUDPAudio value in the [ClientAudio] section only using the module.ini file. Also, it does not take precedence over the value set in the StoreFront default.ica configuration.

Fixed issues

• When you install Citrix Workspace app, add a store, and launch a desktop, the session window might fail to appear. This issue occurs if the libpcscd library is not installed on Ubuntu 16.04. [HDX-36574]
• In Citrix Workspace app 2112, you might experience high CPU utilization on endpoint when a webcam is turned on in an optimized Microsoft Teams video call. [HDX-37168]
• You experience performance issues because of 100% CPU utilization. [RFLNX-8200]

• On a desktop session launched using the self-service GUI, saving the current session layout using the Save layout button on the Desktop Viewer toolbar might fail with the following error message:

  “Unable to save session layout.”

  However, the session layout can be restored during the next session reconnection. [CVADHELP-18971]

• Creating folders or files on mapped drives using client drive mapping might fail on Windows VDAs running on newer versions of client-operating systems with the following error message:

  “You need permission to perform this action.” The operating systems can be such as Ubuntu 21.04 and Fedora 34 or later. [CVADHELP-18448]

• The DNS server in a customer environment with limited internet access might not resolve the URL, clientstream.launchdarkly.com. As a result, Citrix Workspace app for Linux sends DNS queries to the URL constantly. This action might result in millions of DNS queries for a few hundred online Linux clients, causing the DNS server to go down. [CVADHELP-19140]

  Note:

  The DNS queries to LaunchDarkly related sites might be sent for three seconds in a day.

2112

What’s new in 2112

Support for cursor color inverting

Previously, the Citrix Workspace app displayed a dotted cursor that appeared the same in color to the black and white background of a text. As a result, it was difficult to locate the position of the cursor.

With this release, the cursor color inverts based on the background color of a text. As a result, you can easily locate the position of the cursor in the text. By default, this feature is disabled.

Prerequisites:

• If .ICAClient is already present in the home folder of the current user:

  Delete All_Regions.ini file

  Or,

  To retain the All_Regions.ini file, add the following lines at the end of the [Virtual Channels\Thinwire Graphics] section:

  InvertCursorEnabled=

  InvertCursorRefreshRate=

  InvertCursorMode=

If the .ICAClient folder is not present then it indicates a fresh install of the Citrix Workspace app. In that case, the default setting for the feature is retained.

To enable this feature, do the following:

1. Navigate to the $HOME/.ICAClient/wfclient.ini configuration file.

2. Go to [Thinwire3.0] section and set the following entry:

   InvertCursorEnabled=True

Note:

The cursor does not invert when the value for the Use video codec for compression policy in Citrix Studio is set to Do not use video codec.

Adaptive audio update

Adaptive audio now works when using User Datagram Protocol (UDP) audio delivery. For more information, see Adaptive audio.

Note:

This enhancement requires VDA version 2112 or later.

For information on UDP audio configuration using adaptive audio on Citrix Workspace app, see the Enabling UDP audio section in the Audio documentation.

Support for multiple audio devices [Technical Preview]

Starting with this release, Citrix Workspace app displays all available local audio devices in a session with their names. In addition, plug-and-play support for Bluetooth and HDMI audio devices is also provided.

This feature is disabled by default. To enable this feature, set the value for AudioRedirectionV4 to True in the module.ini file.

For more information, see Audio.

Note:

Starting with this release, the VdcamVersion4Support attribute in the module.ini file is renamed to AudioRedirectionV4.

UDP audio through Citrix Gateway [Technical Preview]

With this release, Citrix Workspace app supports Datagram Transport Layer Security (DTLS) protocol for UDP audio. As a result, you can access the UDP audio through Citrix Gateway.

To enable UDP audio through Citrix Gateway:

1. Navigate to the <ICAROOT>/config folder and open the module.ini file.

2. Go to the [WFClient] section and set the following entry:

   EnableUDPThroughGateway=True

3. Go to the [ClientAudio] section and set the following entry:

   EnableUDPAudio=True

For more information, see the Enabling UDP audio section in the Audio documentation.

Note:

If you use the StoreFront default.ica configuration, the value of EnableUDPThroughGateway set in the [Application] section takes precedence over the value set in the module.ini file. However, you can set the EnableUDPAudio value in the [ClientAudio] section only using the module.ini file and it does not take precedence over the value set in the StoreFront default.ica configuration.

Enhancement on smart card support

Note:

This enhancement is generally available for Citrix Workspace app.

With this release, Citrix Workspace app supports the Plug and Play functionality for smart card reader.

When you insert a smart card, the smart card reader detects the smart card in the server and client. You can plug-and-play multiple cards at the same time, and all of these cards are detected.

Prerequisites:

Install the libpcscd library on the Linux client.

Note:

This library might be installed by default in the recent versions of most Linux distributions. However, you might need to install the libpcscd library in earlier versions of some Linux distributions, such as Ubuntu 1604.

To disable this enhancement:

1. Navigate to the <ICAROOT>/config/module.ini folder.
2. Go to the SmartCard section.
3. Set the DriverName=VDSCARD.DLL.

Enhancements to Microsoft Teams optimization

Note:

The following features are available only after the roll-out of a future update from Microsoft Teams. When the update is rolled-out by Microsoft, you can check CTX253754 for the documentation update and the announcement.

• Request control in Microsoft Teams

With this release, you can request control during a Microsoft Teams call when a participant is sharing the screen. Once you have control, you can make selections, edits, or other modifications to the shared screen.

To take control when a screen is being shared, click Request control at the top of the Microsoft Teams screen. The meeting participant who’s sharing the screen can either allow or deny your request.

While you have control, you can make selections, edits, and other modifications to the shared screen. When you’re done, click Release control.

Limitations:

• Users on a Linux client cannot Give control to other users. In other words, after the user on the Linux client starts sharing content, the option Give control is not present in the sharing toolbar. This is a Microsoft limitation.

• The Request Control option is not available during the peer-to-peer call between the following users:

  • An optimized user
  • A user on the native Microsoft Teams desktop client that is running on the endpoint.

  As a workaround, users can join a meeting to get the Request Control option.

• Support for dynamic e911

With this release, Citrix Workspace app supports dynamic emergency calling. When used in Microsoft Calling Plans, Operator Connect, and Direct Routing, it provides the capability to:

• configure and route emergency calls
• notify security personnel

The notification is provided based on the current location of the Citrix Workspace app that runs on the endpoint, instead of the Microsoft Teams client running on the VDA.

Ray Baum’s law requires the 911 caller’s dispatchable location to be transmitted to the appropriate Public Safety Answering Point (PSAP). Starting from Citrix Workspace app 2112 for Linux, Microsoft Teams Optimization with HDX is compliant with Ray Baum’s law. The LLDP library must be included in the Operating System distribution of the Thin Client to support this feature.

Fixed issues

• When playing lengthy videos, the audio stops but the video continues to play seamlessly. The issue occurred when you set the VdcamVersion4Support (renamed as AudioRedirectionV4) to True. [RFLNX-6472]
• During Microsoft Teams peer-to-peer audio calls, audio might not work for the first 15 seconds of the call. [HDX-29526]
• During the screen-sharing session, the red border indicating the shared screen spans across the screens, when Microsoft Teams is running in the seamless mode and multimonitor setup. [HDX-34978]
• During the Microsoft Teams video call, the camera might flash. [HDX-36345]
• Double hop session does not support the Plug and Play functionality for the smart card reader. [HDX-34582]
• Attempts to launch a session using smart card authentication might fail. The issue occurred with Citrix Workspace app for Linux Version 2104 and later. [CVADHELP-18402]
• Playing back audio in a session might deteriorate network performance factors such as round-trip time and session reliability. [CVADHELP-18723]
• Citrix Workspace app 2106 and later installed on thin client might fail when connected to virtual desktop with Opus codec (renamed as adaptive audio) enabled. This issue occurred because the opus.dll file built in the ICAClient directory included the opus lib file built from a different repository. This opus lib file included the AVX-512 instruction set that does not support some of the thin client’s CPU. [HDX-36440]
• When you connect to a cloud store from the self-service user interface, a spinning wheel might appear on the sign-in page. [RFLNX-8486]
• After you sign in to the self-service user interface, the attempt to terminate the selfservice process using the Killall selfservice command from the command line might fail. [RFLNX-8248]

2111

What’s new

Workspace with intelligence [Technical Preview]

This version of Citrix Workspace app is optimized to take advantage of the Workspace intelligence features when they are released. For more information, see Workspace Intelligence Features - Microapps.

Battery status indicator

Previously, the battery status of a device was not appearing in the notification area for server VDAs.

With this release, the battery status indicator appears for server VDAs.

Support for custom web stores [Technical Preview]

With this release, you can access your organization’s custom web store from the Citrix Workspace app.

The administrator must add the domain or the custom web store to the list of allowed URLs in the Global App Configuration Service to use this feature. After the URL is added, you can provide the custom web store URL in the Add Account screen in the Citrix Workspace app. The custom web store opens in the native Workspace app window.

For more information about configuring web store URLs for end-users, see Global App Configuration Service.

To remove the custom web store, go to Accounts > Add or Remove accounts, select the custom web store URL, and click Remove.

As a prerequisite, you must enable the custom web store in the AuthManConfig.xml file. For more information, see Custom web stores.

Note:

You can only use the URLs listed in the AuthManConfig.xml file for the custom web store. You can add different URLs in the AuthManConfig.xml file that you want to be considered for the custom web store.

Webcam redirection for 64-bit [Technical Preview]

This release improves the overall performance and stability of the webcam with 32-bit applications. It also introduces support for webcam redirection for 64-bit applications. For more information, see Webcams.

Enhancement on smart card support [Technical Preview]

With this release, Citrix Workspace app supports the Plug and Play functionality for smart card reader.

When you insert a smart card, the smart card reader detects the smart card in the server and client. You can plug-and-play multiple cards at the same time, and all of these cards are detected.

To configure this feature:

1. Navigate to the <ICAROOT>/config/module.ini folder.
2. Go to the SmartCard section.
3. Set the DriverName=VDSCARDV2.DLL.

Microsoft Teams enhancements

• Addition of a new dependency for llvm-12: In this release, a new dependency called libunwind-12 library is added for llvm-12. However, by default, it does not exist in the original repository. Install the libunwind-12 library manually in the repository. For more information on installing the libunwind-12 library, see Optimization for Microsoft Teams.
• Enhancement to echo cancellation, auto gain control, and noise suppression configurations: If Microsoft Teams configures auto gain control and noise suppression options, Citrix-redirected Microsoft Teams honors the values as configured. Otherwise, by default, these options are enabled. However, by default, the echo cancellation option is disabled. For more information, see Optimization for Microsoft Teams.

Fixed issues

• Attempts to reconnect to the session might occur only once during auto-client reconnection. As a result, the Auto client reconnect policy might not work as expected. [HDX-34114]
• You experience call failures when a P2P call is made from Citrix Workspace app for Linux 2109 to Citrix Workspace app for Windows 2109 or Citrix Workspace for Mac 2109. [HDX-35223]

2109

What’s new

Session reliability enhancement

Previously, with HDX Broadcast session reliability, you continue to see a published application’s window if the connection to the application experiences an interruption.

With this release, you can see the screen changes when session reliability begins. The session window is grayed out and a countdown timer shows the time until the next reconnection attempt.

Note:

This feature is supported only for Citrix Virtual Desktops.

Enhancement to logging

Previously, there was no tool available to collect log files in Citrix Workspace app. Log files were present in different folders. You had to manually collect log files from different folders.

Starting with this release, Citrix Workspace app introduces the collectlog.py tool, which lets you collect log files from different folders. You can run this tool using the command line. The log files are generated as a compressed log file. You can download this compressed log file from the local server. For more information see, Logging.

Service continuity

Note:

This feature is generally available for Citrix Workspace app.

Service continuity removes or minimizes the dependency on the availability of components that are involved in the connection process. Users can launch their Citrix Virtual Apps and Desktops and Citrix DaaS regardless of the health status of the cloud services.

For information on requirements that support service continuity on Citrix Workspace app, see System Requirements.

For information on installing service continuity with Citrix Workspace app, see Installing Service Continuity.

For more information, see the Service continuity section in the Citrix Workspace documentation.

Support for Service continuity with Citrix Workspace Web Extension for Google Chrome

Support for service continuity with the Citrix Workspace Web Extension for Google Chrome is in public technical preview. You can use Workspace Web Extension for Google Chrome with Citrix Workspace app for Linux 2109. This extension is available at Google Chrome web store. The Workspace app communicates with the Citrix Workspace Web extension using the native messaging host protocol for browser extension. Together, the Workspace app and the Workspace Web extension use Workspace connection leases to give browser users access to their apps and desktops during outages. For more information, see Service continuity.

Adaptive audio

With adaptive audio, you don’t need to manually configure the audio quality policies on the VDA. Adaptive audio optimizes settings for your environment and replaces obsolete audio compression formats to provide an excellent user experience. Adaptive audio is enabled by default. For more information, see Adaptive audio.

Note:

If UDP audio delivery is required for real-time audio applications, adaptive audio must be disabled on the VDA to allow fallback to UDP audio delivery.

Storebrowse enhancement for service continuity

Previously, the Workspace connection lease files were synced with files available on the remote server only if you connected using the Self-Service plug-in. As a result, the service continuity feature was not supported when you launched apps or desktop session using storebrowse. Most third-party thin-client vendors use storebrowse to connect to the Workspace platform and the service continuity feature was not enabled for them.

Starting with this release, the Workspace connection lease files sync with files available on the remote server when you connect using storebrowse as well. This feature helps the third-party thin-client vendors to access Workspace even when offline.

Note:

• This enhancement is available only when service continuity is enabled in cloud deployments. For more information, see the Configure Service Continuity section in the Citrix Workspace documentation.
• This enhancement is not available if you have set the value of AuthManLiteEnabled to True in the $ICAROOT/config/AuthManConfig.xml file. By default, this value is set to False.

Global App Config Service (Public Technical Preview)

The new Global App Configuration Service for Citrix Workspace allows a Citrix administrator to deliver Workspace service URLs through a centrally managed service.

As a prerequisite, you must enable this feature in the AuthManConfig.xml file. Navigate to $ICAROOT/config/AuthManConfig.xml and add the following entries:

     <key>AppConfigEnabled</key>
     <value> true </value>
<!--NeedCopy-->