SDK und API

HDX™ SDK

• Die Citrix Workspace-App für ChromeOS führt eine API (experimentelle API) ein, die es Chrome-Apps von Drittanbietern ermöglicht, sich zu sperren, zu entsperren und die Verbindung zu folgenden Elementen zu trennen:

• Citrix Virtual Apps and Desktops
• Citrix DaaS (ehemals Citrix Virtual Apps and Desktops Service)-Sitzung

Mithilfe dieser API können Sie die Citrix Workspace-App für ChromeOS sowohl im eingebetteten Modus als auch im Kioskmodus starten. Im eingebetteten Modus gestartete Sitzungen funktionieren ähnlich wie im Kioskmodus gestartete Sitzungen.

Die SDK-Dokumentation finden Sie unter HDX SDK für Citrix Workspace-App für ChromeOS.

Beispiele für das HDX SDK finden Sie auf der Citrix Downloadseite.

Verbesserungen an den Chrome HDX SDK APIs

• Zuvor hatten externe Apps mit der HDX SDK für ChromeOS-Integration keine Einsicht in Sitzungen, die über andere Methoden als das SDK gestartet wurden.

Ab Version 2408 bieten die neuen Verbesserungen am Chrome HDX SDK die Möglichkeit, alle aktiven Sitzungen zu identifizieren, bestimmte Sitzungen zu trennen, alle aktiven Sitzungen zu trennen und den Benutzer von allen Stores in der Citrix Workspace™-App abzumelden (nur lokale Stores).

Weitere Informationen zur Verwendung von APIs finden Sie unter Sitzungen aufzählen.

Citrix Virtual Channel SDK

Das Citrix Virtual Channel Software Development Kit (SDK) unterstützt Sie beim Schreiben von serverseitigen Anwendungen und clientseitigen Treibern für zusätzliche virtuelle Kanäle unter Verwendung des ICA®-Protokolls.

Die serverseitigen virtuellen Kanalanwendungen befinden sich auf Citrix Virtual Apps- oder Citrix Virtual Apps and Desktops-Servern. Diese Version des SDK unterstützt Sie beim Schreiben neuer virtueller Kanäle für die Citrix Workspace-App für ChromeOS. Wenn Sie virtuelle Treiber für andere Clientplattformen schreiben möchten, wenden Sie sich an Citrix.

Das Virtual Channel SDK bietet:

• Eine einfache Schnittstelle, die mit den virtuellen Kanälen im Citrix Server API SDK (WFAPI SDK) verwendet werden kann, um neue virtuelle Kanäle zu erstellen.

• Funktionierenden Quellcode für mehrere Beispielprogramme für virtuelle Kanäle, die Programmiertechniken demonstrieren.

• Das Virtual Channel SDK erfordert das WFAPI SDK, um die Serverseite des virtuellen Kanals zu schreiben.

Die VC SDK-Dokumentation finden Sie unter Citrix Virtual Channel SDK für Citrix Workspace-App für ChromeOS.

Verbesserungen am Virtual Channel SDK

Ab Version 2305 unterstützt die Citrix Workspace-App für ChromeOS Window Management APIs im Virtual Channel SDK. Web-APIs ermöglichen es IT-Administratoren, interaktive Anwendungen zu erstellen und diese für ihre Endbenutzer anzupassen.

• Verfahren zur Nutzung der API in der Chrome-App eines Drittanbieters

1. Installieren Sie die neueste Version der Citrix Workspace-App für ChromeOS. Details finden Sie auf der Citrix Downloadseite.
2. Fügen Sie die Chrome-App eines Drittanbieters zur Zulassungsliste hinzu, indem Sie die Richtliniendatei für die Citrix Workspace-App für ChromeOS hinzufügen. Verwenden Sie die Chrome-Verwaltungseinstellungen, um die Richtlinie hinzuzufügen.

• Weitere Details finden Sie unter Chrome-Apps nach Organisationseinheit verwalten im Google-Support.

  Um die Chrome-App eines Drittanbieters zur Zulassungsliste hinzuzufügen, finden Sie hier die Beispiel-JSON-Daten für policy.txt:

   {
         "settings": {
                "Value": {
                "settings_version": "1.0",
                "store_settings": {
                "externalApps": [“<3rdParty_App1_ExtnID>”,“<3rdParty_App2_ExtnID>”]
                                  }
                          }
                   }
   }
   <!--NeedCopy-->
  

  Hinweis:

  <3rdParty_App1_ExtnID> wird als Beispiel für den Namen von externalApps verwendet und kann Nachrichten an die Citrix Workspace-App für ChromeOS senden. Rufen Sie Ihre App-ID von der Website chrome://extensions ab.

1. Starten Sie die Anwendung oder eine Desktopsitzung in Citrix Workspace für ChromeOS wie folgt:

• workspaceappID abrufen

  var workspaceappID = " haiffjcadagjlijoggckpgfnoeiflnem ";

  Hinweis:

  In diesem Beispiel gibt workspaceappID die Store-Version der Citrix Workspace-App für ChromeOS an. Wenn Sie eine neu verpackte Version der Citrix Workspace-App für ChromeOS verwenden, verwenden Sie die entsprechende workspaceappID.

• ICA-Daten vom INI- ins JSON-Format konvertieren.

  Hinweis:

• Typischerweise wird die ICA-Datei von StoreFront als INI-Datei abgerufen. Verwenden Sie die folgende Hilfsfunktion, um eine ICA-INI-Datei in JSON zu konvertieren.

   //Helper function to convert ica in INI format to JSON
   function convertICA_INI_TO_JSON(data){
   var keyVals = {};
   if (data) {
   var dataArr;
   if(data.indexOf('\r')==-1){
   dataArr = data.split('\n');
   }else{
   dataArr = data.split('\r\n');
   }
   for (var i = 0; i \< dataArr.length; i++) {
   var nameValue = dataArr[i].split('=', 2);
   if (nameValue.length === 2) {
   keyVals[nameValue[0]] = nameValue[1];
   }
   // This is required as LaunchReference contains '=' as well. The above split('=',2) will not provide
   // the complete LaunchReference. Ideally, something like the following should be used generically as well
   // because there can be other variables that use the '=' character as part of the value.
   if (nameValue[0] === "LaunchReference") {
   var index = dataArr[i].indexOf('=');
   var value = dataArr[i].substr(index + 1);
   keyVals[nameValue[0]] = value;
   }
   }
   console.log(keyVals);//to remove
   return keyVals;
   -  }
   return null;
   }
  
   <!--NeedCopy-->
  

• Eine ICA-Nachricht von der Chrome-App eines Drittanbieters an die Citrix Workspace-App für ChromeOS senden.

   var icaFileJson = {...}; // ICA file passed as JSON key value pairs.
   var message = {
   "method" : "launchSession",
   "icaData" : icaJSON
   };
   chrome.runtime.sendMessage(workspaceappID, message,
   function(launchStatus) {
   if (launchStatus.success) {
   // handle success.
   console.log("Session launch was attempted successfully");
   } else {
   // handle errors.
   console.log("error during session launch: ", launchStatus.message);
   }
   });
  
   <!--NeedCopy-->
  

Weitere Details zu den sendMessage API-Befehlen finden Sie unter den folgenden Links:

https://developer.chrome.com/extensions/runtime#event-onMessageExternal

https://developer.chrome.com/extensions/runtime#method-sendMessage

Unterstützung von Manifest V3 für SDK-Szenarien

Ab Version 2305 unterstützt die Citrix Workspace-App für ChromeOS das HDX SDK mit Chrome-Erweiterungen, die Manifest-Version 3 verwenden.

Weitere Informationen finden Sie unter Citrix Workspace-App für ChromeOS HDX SDK in der Dokumentation der Entwicklerhandbücher.

Unterstützung für Unified Communications (UC) SDK

Das Citrix Unified Communications SDK ermöglicht es Anbietern von Unified Communications, Cloud-Contact-Center-Anbietern, Communications Platform as a Service (CPaaS)-Anbietern oder allen WebRTC-basierten Kommunikationsanbietern, sich nahtlos in Electron-basierte Desktop- oder Browser-basierte Anwendungen zu integrieren.

Weitere Informationen finden Sie unter Unified Communications (UC) SDK, einem Tech-Zone-Artikel.

Umleitung von WebHID-APIs

Das Unified Communications SDK für die Citrix Workspace-App für ChromeOS implementiert die Umleitung von WebHID-APIs, wie in Citrix-WebRTC definiert, mit bestimmten bekannten Einschränkungen:

• Wenn mehrere HID-Geräte desselben Typs vorhanden sind, kann der Benutzer kein bestimmtes Gerät zum Testen auswählen.

Hinweis:

Diese Funktion ist standardmäßig deaktiviert.

Konfiguration

Sie können die Funktion aktivieren, indem Sie Folgendes verwenden:

• Google Admin Policy
• Global App Configuration Service

Google Admin Policy

Für verwaltete Geräte und Benutzer können Administratoren die Funktion mithilfe der Google Admin Policy wie folgt aktivieren:

1. Melden Sie sich bei der Google Admin Policy an.
2. Gehen Sie zu Geräteverwaltung > Chrome-Verwaltung > Nutzereinstellungen.

3. Fügen Sie die folgenden JSON-Strings zur Datei policy.txt unter dem Schlüssel engine_settings hinzu.

   Hinweis:

   Sie können diese Konfiguration auch auf Folgendes anwenden:

   • Gerät > Chrome > Apps und Erweiterungen > Benutzer und Browser > Erweiterung suchen > Richtlinie für Erweiterungen.
   • Gerät > Chrome > Apps und Erweiterungen > Kioske > Erweiterung suchen > Richtlinie für Erweiterungen.
   • Gerät > Chrome > Apps und Erweiterungen > Verwaltete Gastsitzungen > Erweiterung suchen > Richtlinie für Erweiterungen.

4. Stellen Sie sicher, dass Sie das Attribut webHID auf true setzen. Das Folgende ist ein Beispiel für JSON-Daten:

   'features' : {
       'msTeamsOptimization' : { 
           'webHID' : true 
           } 
           }
   <!--NeedCopy-->
   

5. Setzen Sie das Attribut hidDeviceBlockList im richtigen Format. Wenn Sie einige HID-Geräte blockieren möchten, finden Sie hier ein Beispiel für JSON-Daten:

   'features' : {
   'msTeamsOptimization' : {       
       // The format of the blocklist is ["VID:PID", "VID:PID", "VID:PID", ...]
       // Each VID and PID is an up to 4-digit hexadecimal number with an optional "0x" prefix.
       // The VID is a required field. The PID is optional, so the colon and PID can be omitted.
       // example ["35ab:21ff", "45ac", "0x567:123a", "0x1234:0x5678"]
       'hidDeviceBlockList' : [] 
       }
   }
   <!--NeedCopy-->
   

6. Speichern Sie die Änderungen.

Global App Configuration Service

Administratoren können die Funktion aktivieren, indem sie zu Workspace-Konfiguration > App-Konfiguration > HDX und Multimedia > MS Teams > WebHID-Umleitung aktivieren und HID-Geräte-Blockierungsliste navigieren. Aktivieren Sie das Kontrollkästchen und den entsprechenden Umschalter, um die Funktion zu aktivieren.