Configure Citrix Workspace app

You can configure Citrix Workspace app for Mac using Global App Configuration service User Interface (UI) and Mobile Device Management. Settings can be configured for both cloud (Citrix Workspace) and on-premises (Citrix StoreFront) environments.

For more information, see the following:

• Global App Configuration service
  • Configure settings for cloud stores
  • Configure settings for on-premises stores

  USB redirection

  HDX USB device redirection enables redirection of USB devices to and from a user device. A user can connect a flash drive to a local computer and access it remotely from a virtual desktop or a desktop hosted application. For more information, see USB.

  Keyboard layout synchronization

  Keyboard layout synchronization enables you to switch between the preferred keyboard layouts on the client device. This feature is disabled by default. After you enable this feature, the client keyboard layout automatically synchronizes to the virtual apps and desktops. For more information, see Keyboard layout synchronization.

  Channel support for Global App Configuration service

  The Global App Configuration service for Citrix Workspace allows a Citrix administrator to deliver Workspace service URLs and Workspace App settings through a centrally managed service. Global App Configuration service now allows administrators to test the settings before rolling it out to all users. This feature allows to resolve any issues before applying the global app configurations to the entire user base.

  You can achieve the channel support by mapping the settings that you want to test to a channel and then add the channel in the payload. For more information, see Global App Configuration service documentation.

  Citrix Virtual Channel SDK

  The Citrix Virtual Channel software development kit (VCSDK) supports writing server-side applications and client-side drivers for more virtual channels using the ICA protocol. The server-side virtual channel applications are on Citrix Virtual Apps and Desktops servers. If you want to write virtual drivers for other client platforms, contact Citrix Technical support.

  The Virtual Channel SDK provides:

  • The Citrix Virtual Driver Application Programming Interface (VDAPI) is used with the virtual channel functions in the Citrix Server API SDK (WFAPI SDK) to create new virtual channels. The virtual channel support provided by VDAPI makes it easy to write your own virtual channels.
  • The Windows Monitoring API, which enhances the visual experience and support for third-party applications integrated with ICA.
  • Working source code for virtual channel sample programs to demonstrate programming techniques.

  The Virtual Channel SDK requires the WFAPI SDK to write the server side of the virtual channel.

  Load Custom Virtual Channels on Macs with Apple Silicon

  As an end-user, you can load the Custom Virtual Channel SDK (VCSDK) successfully on a Mac with the M1 and M2 chipset. With universal architecture, you must load the VCSDK by recompiling your Custom Virtual Channels using the latest VCSDK on the M1 and M2 chipset device. You can download the universal architecture build from the Virtual Channel SDK 2204 for macOS (Apple silicon) - Universal Architecture section at Downloads.

  To load the VCSDK, do the following:

  1. Download Virtual Channel SDK 2204 for macOS from Downloads.
  2. Open your Custom Virtual Channel project in Xcode.
  3. Change your code.
  4. Compile your Custom Virtual Channel to generate the virtual channel bundle.

  Test your Virtual Channel Software Development Kit (VCSDK)

  If you’re using the Citrix Virtual Channel Software Development Kit (VCSDK), you must customize so your customized virtual channels run correctly. To test your VCSDKs, do the following:

  1. Ensure that all the linked libraries of your customized virtual channels are compiled for Universal Binary.
  2. Change the Project file to support Universal Binary:
     • Open Project >Build Settings.
     • Set Architectures to Standard Architectures.

  

  Examples for the VCSDK can be found inside VCSDK.dmg. These examples support Apple’s Universal macOS Binary that runs natively on both Apple silicon and Intel-based Mac computers. Because it contains executable code for both architectures. You can use these examples as a reference.

  

  Modernized Citrix Virtual Channel SDK for Citrix Workspace app for Mac

  Starting with the 2311 version, the Citrix Virtual Channel Software Development Kit (VCSDK) supports writing server-side applications and client-side drivers for more virtual channels using the ICA protocol. The server-side virtual channel applications are on Citrix Virtual Apps and Desktops servers. This version of the SDK supports writing new virtual channels and screen sharing for Citrix Workspace app for Mac.

  For more information, see Citrix Virtual Channel SDK for Citrix Workspace app for Mac in the Developer documentation.

  Increase in the number of supported virtual channels

  Previously, Citrix Workspace app for Mac supported up to 32 virtual channels. Starting with the 2308 version, you can use up to 64 virtual channels in a session.

  Modernized Citrix Virtual Channel SDK for Citrix Workspace app for Mac

  Starting with the 2405 version, the Citrix Virtual Channel Software Development Kit (VCSDK) supports the desktop and screen sharing VCSDK API and gbuffer sharing.

  The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

  DIESER DIENST KANN ÜBERSETZUNGEN ENTHALTEN, DIE VON GOOGLE BEREITGESTELLT WERDEN. GOOGLE LEHNT JEDE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNG IN BEZUG AUF DIE ÜBERSETZUNGEN AB, EINSCHLIESSLICH JEGLICHER GEWÄHRLEISTUNG DER GENAUIGKEIT, ZUVERLÄSSIGKEIT UND JEGLICHER STILLSCHWEIGENDEN GEWÄHRLEISTUNG DER MARKTGÄNGIGKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG VON RECHTEN DRITTER.

  CE SERVICE PEUT CONTENIR DES TRADUCTIONS FOURNIES PAR GOOGLE. GOOGLE EXCLUT TOUTE GARANTIE RELATIVE AUX TRADUCTIONS, EXPRESSE OU IMPLICITE, Y COMPRIS TOUTE GARANTIE D'EXACTITUDE, DE FIABILITÉ ET TOUTE GARANTIE IMPLICITE DE QUALITÉ MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET D'ABSENCE DE CONTREFAÇON.

  ESTE SERVICIO PUEDE CONTENER TRADUCCIONES CON TECNOLOGÍA DE GOOGLE. GOOGLE RENUNCIA A TODAS LAS GARANTÍAS RELACIONADAS CON LAS TRADUCCIONES, TANTO IMPLÍCITAS COMO EXPLÍCITAS, INCLUIDAS LAS GARANTÍAS DE EXACTITUD, FIABILIDAD Y OTRAS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN EN PARTICULAR Y AUSENCIA DE INFRACCIÓN DE DERECHOS.

  本服务可能包含由 Google 提供技术支持的翻译。Google 对这些翻译内容不做任何明示或暗示的保证，包括对准确性、可靠性的任何保证以及对适销性、特定用途的适用性和非侵权性的任何暗示保证。

  このサービスには、Google が提供する翻訳が含まれている可能性があります。Google は翻訳について、明示的か黙示的かを問わず、精度と信頼性に関するあらゆる保証、および商品性、特定目的への適合性、第三者の権利を侵害しないことに関するあらゆる黙示的保証を含め、一切保証しません。

  ESTE SERVIÇO PODE CONTER TRADUÇÕES FORNECIDAS PELO GOOGLE. O GOOGLE SE EXIME DE TODAS AS GARANTIAS RELACIONADAS COM AS TRADUÇÕES, EXPRESSAS OU IMPLÍCITAS, INCLUINDO QUALQUER GARANTIA DE PRECISÃO, CONFIABILIDADE E QUALQUER GARANTIA IMPLÍCITA DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO E NÃO INFRAÇÃO.