Uso del marco de aplicaciones dinámicas de AppStream 2.0 para crear un proveedor de aplicaciones dinámicas

El marco de aplicaciones dinámicas de AppStream 2.0 proporciona operaciones API en una instancia de streaming de AppStream 2.0 que se pueden utilizar para crear un proveedor de aplicaciones dinámicas. Los proveedores de aplicaciones dinámicas pueden utilizar las operaciones API para modificar el catálogo de aplicaciones al que los usuarios pueden obtener acceso en tiempo real. Las aplicaciones administradas por los proveedores de aplicaciones dinámicas pueden estar dentro o fuera de la imagen, como en un recurso compartido de archivos de Windows o en una tecnología de virtualización de aplicaciones.

nota

Esta característica requiere que haya una flota de AppStream 2.0 siempre disponible o bajo demanda vinculada a un dominio de Microsoft Active Directory. Para obtener más información, consulte Uso de Active Directory con AppStream 2.0.

Acerca del marco de aplicaciones dinámicas

El marco de aplicaciones dinámicas utiliza el marco de software Apache Thrift para la mensajería entre procesos. Se expone a través de la opción "Canalizaciones con nombre" de Windows. El marco de Thrift le permite crear un proveedor de aplicaciones dinámicas en el lenguaje de desarrollo de software que prefiera. El marco de aplicaciones dinámicas se compone de tres operaciones API: AddApplications, RemoveApplications y ClearApplications.

Definiciones de Thrift y nombres de las canalizaciones con nombre en el marco de aplicaciones dinámicas

Thrift le permite utilizar archivos de definición sencillos proporcionados por AppStream 2.0 para compilar clientes RPC. Los clientes RPC le permiten comunicarse con el software del agente de AppStream 2.0 que se ejecuta en una instancia de streaming. Para obtener información acerca de cómo compilar el cliente RPC en su lenguaje, consulte la documentación de Apache Thrift. Una vez que haya compilado las bibliotecas de Thrift en lenguaje elegido, cree un cliente de Thrift utilizando el transporte de canalización con nombre. Utilice D56C0258-2173-48D5-B0E6-1EC85AC67893 como nombre de la canalización.

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),
}

Acciones de API para administrar los derechos de una aplicación en AppStream 2.0

Puede utilizar las siguientes operaciones API para administrar los derechos de las aplicaciones en AppStream 2.0.

Operación de AddApplicationsRequest

Añade aplicaciones al catálogo de aplicaciones de los usuarios de AppStream 2.0. El catálogo de aplicaciones que muestra AppStream 2.0 contiene las aplicaciones que se añaden a través de esta operación API y las aplicaciones que se añaden en la imagen. Una vez que se han añadido aplicaciones mediante uno o ambos de estos métodos, los usuarios pueden lanzar las aplicaciones.

Sintaxis de la solicitud

cadena userSid;

list<Application> applications;

Parámetros de solicitud

userSid

SID del usuario al que se aplica la solicitud.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 208 caracteres.

applications

Lista de aplicaciones a la que se aplica la solicitud.

Tipo: Cadena

Obligatorio: sí

Objeto Application

Describe los metadatos de la aplicación necesarios para mostrar y lanzar la aplicación. El identificador de la aplicación debe ser único y no puede estar en conflicto con otras aplicaciones especificadas a través de la operación API o la imagen.

id

Identificador de la aplicación que se está especificando. Este valor, que corresponde al valor application_name de un informe de aplicaciones de AppStream 2.0, se proporciona cuando un usuario lanza la aplicación. Cuando habilita los informes de uso, AppStream 2.0 exporta un informe de aplicaciones a su bucket de Amazon S3 para cada día que los usuarios lanzan al menos una aplicación durante sus sesiones de streaming. Para obtener más información acerca de los informes de aplicaciones, consulte Campos de los informes de aplicaciones.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 512 caracteres.

displayName

Nombre para mostrar de la aplicación que se está especificando. Este nombre es el que el usuario ve en el catálogo de aplicaciones.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 512 caracteres.

launchPath

Ruta de acceso del sistema de archivos de Windows correspondiente al ejecutable de la aplicación que se va a lanzar.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 32 767 caracteres.

iconData

Imagen codificada en base 64 que se va a mostrar en el catálogo de aplicaciones. La imagen debe estar en uno de los siguientes formatos: .png, .jpeg o .jpg.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 1 000 000 caracteres.

launchParams

Parámetros que se van a utilizar para lanzar la aplicación.

Tipo: Cadena

Obligatorio: no

Limitaciones de longitud: longitud máxima de 32 000 caracteres.

workingDirectory

Ruta de acceso del sistema de archivos de Windows correspondiente al directorio de trabajo en el que debe lanzarse la aplicación.

Tipo: Cadena

Obligatorio: no

Limitaciones de longitud: longitud máxima de 32 767 caracteres.

Operación de RemoveApplicationsRequest

Elimina las aplicaciones que se han añadido con la aplicación AddApplicationsRequest. Las aplicaciones se eliminan del catálogo del usuario. Una vez que las aplicaciones se han eliminado, no se pueden lanzar. Si una aplicación se mantiene en ejecución, AppStream 2.0 no la cerrará. Las aplicaciones especificadas directamente en la imagen de AppStream 2.0 no pueden eliminarse.

Sintaxis de la solicitud

cadena userSid;

list<Application> applications;

Parámetros de solicitud

userSid

SID del usuario al que se aplica la solicitud.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 208 caracteres.

applications

Lista de aplicaciones a la que se aplica la solicitud.

Tipo: Cadena

Obligatorio: sí

Operación de ClearApplicationsRequest

Elimina todas las aplicaciones que se han añadido al catálogo de aplicaciones con la operación AddApplicationsRequest. Una vez que las aplicaciones se han eliminado, no se pueden lanzar. Si las aplicaciones están en ejecución cuando se utiliza la operación ClearApplicationsRequest, AppStream 2.0 no las cierra. Las aplicaciones especificadas directamente en la imagen de AppStream 2.0 no pueden eliminarse.

Sintaxis de la solicitud

cadena userSid;

Parámetros de solicitud

userSid

SID del usuario al que se aplica la solicitud.

Tipo: Cadena

Obligatorio: sí

Limitaciones de longitud: la longitud mínima es 1 carácter; la longitud máxima son 208 caracteres.