macOS expects a unique UUID for every plug-in it loads in the latest build toolchain.

Objective

As an end-user, you can load Custom Virtual Channel (VC) SDK successfully after upgrading to Citrix Workspace app Mac 2110 or later.

Background

In Citrix Workspace app for Mac 2110, the developer build tools have been upgraded. As the existing Custom Virtual Channels, that are customized may not be compatible with Citrix Workspace app for Mac 2110, there might be problems in loading the Custom Virtual Channels with Citrix Workspace app for Mac 2110. The solution is to recompile your Custom Virtual Channels using the latest Virtual Channel SDK for Mac 2110.

1. Download the latest Custom Virtual Channels SDK from http://www.citrix.com/downloads/workspace-app/virtual-channel-sdks/virtual-channel-sdk.html.
2. Open your Custom Virtual Channel project in Xcode.
3. Remove the reference to the older Virtual Channel SDK already linked to the Xcode project.
4. Link the downloaded Custom Virtual Channels SDK for Mac 2110.
5. Generate a unique UUID from macOS Terminal. See the following section Generation of Unique UUID for more information.
6. Go to info.plist of your Custom Virtual Channels Xcode project.
7. In the sections, Plug-in factory interfaces and Plug-in types, replace the default UUID with the new UUID you have generated.
8. Compile your Custom Virtual Channel to generate the virtual channel bundle.
9. You now have successfully upgraded your Custom Virtual Channel plug-in to be compatible with the Virtual Channel SDK for Mac 2110.

Generation of Unique UUID:

1. Open the macOS Terminal app.
2. Run the command “uuidgen” in macOS Terminal to generate a unique UUID for your custom virtual channel.
3. Copy the generated UUID to the clipboard.

Note: If you have more than one Custom Virtual Channel plug-in, ensure that your Custom Virtual Channel UUID is unique in each virtual channel.