Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation du cadre d'application dynamique AppStream 2.0 pour créer un fournisseur d'applications dynamiques

Le cadre d'application dynamique AppStream 2.0 fournit des opérations d'API dans une instance de streaming AppStream 2.0 que vous pouvez utiliser pour créer un fournisseur d'applications dynamiques. Les fournisseurs d'applications dynamiques peuvent utiliser les opérations d'API fournies pour modifier le catalogue des applications auxquelles vos utilisateurs peuvent accéder en temps réel. Les applications gérées par les fournisseurs d'applications dynamiques peuvent se situer dans l'image, ou elles peuvent être hors instance, par exemple à partir d'un partage de fichiers Windows ou d'une application de technologie de virtualisation.

À propos du cadre d'application dynamique

Le cadre d'application dynamique utilise le Cadre de logiciel Apache Thrift pour l'envoi de messages interprocessus. Il est exposé via des canaux nommés dans Windows. L'utilisation du cadre Thrift vous permet de générer votre fournisseur d'application dynamique dans le langage de développement de logiciel de votre choix. Le cadre d'application dynamique se compose de trois opérations d'API : AddApplications, RemoveApplications et ClearApplications.

Définitions de cadre d'application dynamique Thrift et nom de canal nommé

Thrift vous permet d'utiliser des fichiers de définition simple fournis par AppStream 2.0 pour compiler les clients RPC. Les clients RPC vous permettent de communiquer avec le logiciel de l'agent AppStream 2.0 qui s'exécute sur une instance de streaming. Pour obtenir plus d'informations sur la compilation du client RPC pour votre langage, consultez la Documentation Apache Thrift. Une fois que vous avez compilé les bibliothèques Thrift pour le langage de votre choix, créez un client Thrift à l'aide tu transport de canal nommé. Utilisez D56C0258-2173-48D5 B0E6-1EC85AC67893 comme nom de canal.

AppStreamServer.thrift

namespace netstd AppStream.ApplicationCatalogService.Model

const string ServiceEndpoint = "D56C0258-2173-48D5-B0E6-1EC85AC67893";


struct AddApplicationsRequest
{
    1: required string userSid;
    2: required list<Application> applications;
}

struct AddApplicationsResponse
{
}

struct RemoveApplicationsRequest
{
    1: required string userSid; 
    2: required list<string> applicationIds;
}

struct RemoveApplicationsResponse
{
}

struct ClearApplicationsRequest
{
    1: required string userSid; 
}

struct ClearApplicationsResponse
{
}

struct Application
{
    1: required string id;
    2: required string displayName;
    3: required string launchPath;
    4: required string iconData;
    5: string launchParams;
    6: string workingDirectory;
}

exception AppStreamClientException
{
    1: string errorMessage,
    2: ErrorCode errorCode
}
	  
exception AppStreamServerException
{
    1: string errorMessage,
    2: ErrorCode errorCode
}

enum ErrorCode
{
}

service ApplicationCatalogService
{
    AddApplicationsResponse AddApplications(1:AddApplicationsRequest request)
    throws (1: AppStreamClientException ce, 2: AppStreamServerException se),

    RemoveApplicationsResponse RemoveApplications(1:RemoveApplicationsRequest request)
    throws (1: AppStreamClientException ce, 2: AppStreamServerException se),

    ClearApplicationsResponse ClearApplications(1:ClearApplicationsRequest request)
    throws (1: AppStreamClientException ce, 2: AppStreamServerException se),
}

Actions d'API de gestion des droits d'application pour AppStream 2.0

Vous pouvez utiliser les opérations d'API suivantes pour gérer des droits d'application pour AppStream 2.0.

Opération AddApplicationsRequest

Ajoute des applications au catalogue d'applications pour les utilisateurs AppStream 2.0. Le catalogue d'applications affiché par AppStream 2.0 comprend les applications que vous ajoutez à l'aide de cette opération d'API et les applications que vous ajoutez dans l'image. Une fois que vous avez ajouté des applications à l'aide d'une ou deux de ces méthodes, vos utilisateurs peuvent lancer les applications.

Syntaxe de demande

chaîne userSid;

list<Application> applications;

Paramètres de requête

Objet Application

Décrit les métadonnées d'application requises pour afficher et lancer l'application. L'identifiant de l'application doit être unique et ne doit pas être en conflit avec d'autres applications spécifiées par le biais de l'opération d'API ou de l'image.

Opération RemoveApplicationsRequest

Supprime les applications qui ont été ajoutées à l'aide de l'opération AddApplicationsRequest. Les applications sont supprimées du catalogue d'applications pour l'utilisateur. Une fois les applications supprimées, elles ne peuvent pas être lancées. Si une application est en cours d'exécution, AppStream 2.0 ne la ferme pas. Les applications qui sont spécifiées directement dans l'image AppStream 2.0 ne peuvent pas être supprimées.

Syntaxe de demande

chaîne userSid;

list<Application> applications;

Paramètres de requête

Opération ClearApplicationsRequest

Supprime toutes les applications qui ont été ajoutées au catalogue d'applications à l'aide de l'opération AddApplicationsRequest. Une fois les applications supprimées, elles ne peuvent pas être lancées. Si les applications sont en cours d'exécution lorsque l'opération ClearApplicationsRequest est utilisée, AppStream 2.0 ne les ferme pas. Les applications qui sont spécifiées directement dans l'image AppStream 2.0 ne peuvent pas être supprimées.

Syntaxe de demande

chaîne userSid;

Paramètres de requête