Usar o framework dinâmico de aplicações do AppStream 2.0 para criar um provedor dinâmico de aplicações

O framework dinâmico de aplicações do AppStream 2.0 fornece operações de API em uma instância de streaming do AppStream 2.0 que você pode usar para criar um provedor dinâmico de aplicações. Provedores de aplicativos dinâmicos pode usar as operações da API fornecidas para modificar o catálogo de aplicativos que os usuários podem acessar em tempo real. Os aplicativos gerenciados pelos provedores de aplicativos dinâmicos podem estar dentro da imagem ou podem estar fora da instância, como em um compartilhamento de arquivos do Windows ou uma tecnologias de virtualização de aplicativos.

nota

Esse recurso requer uma frota sempre ativa ou sob demanda do AppStream 2.0 associada a um domínio do Microsoft Active Directory. Para obter mais informações, consulte Usando o Active Directory com AppStream 2.0.

Sobre a estrutura de aplicativos dinâmicos

A estrutura de aplicativos dinâmicos usa a Estrutura de software do Apache Thrift para mensagens entre processos. Ela é exposta por meio de pipes nomeados no Windows. O uso da estrutura Thrift permite criar o provedor de aplicativos dinâmicos no idioma de desenvolvimento de software de sua preferência. A estrutura de aplicativos dinâmicos é composta por três operações da API: AddApplications, RemoveApplications e ClearApplications.

Nomes de pipes nomeados e definições Thrift da estrutura de aplicativos dinâmicos

O Thrift permite que você use arquivos de definição simples fornecidos pelo AppStream 2.0 para compilar os clientes RPC. Os clientes RPC permitem que você se comunique com o software do agente do AppStream 2.0 em execução em uma instância de streaming. Para obter informações sobre como compilar o cliente RPC para o seu idioma, consulte a documentação do Apache Thrift. Após compilar as bibliotecas do Thrift para o idioma de sua escolha, crie um cliente Thrift usando o transporte de pipe nomeado. Use D56C0258-2173-48D5-B0E6-1EC85AC67893 como o nome de pipe.

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

Ações de API para gerenciar direitos de aplicações para o AppStream 2.0

Você pode usar as operações de API a seguir para gerenciar direitos de aplicações para o AppStream 2.0.

Operação do AddApplicationsRequest

Adiciona aplicações ao catálogo de aplicações para os usuários do AppStream 2.0. O catálogo de aplicações exibido pelo AppStream 2.0 inclui as aplicações que você adiciona usando essa operação de API e as aplicações que você adiciona na imagem. Após adicionar aplicativos usando um ou ambos os métodos, os usuários podem executar os aplicativos.

Sintaxe da solicitação

string SID do usuário;

list<Application> applications;

Parâmetros de solicitação

SID do usuário

O SID do usuário ao qual a solicitação se aplica.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 208 caracteres.

applications

A lista de aplicativos à qual a solicitação se aplica.

Tipo: string

Obrigatório: Sim

Objeto Application

Descreve os metadados de aplicativos necessários para exibir e executar o aplicativo. O identificador de aplicativo deve ser exclusivo e não estar em conflito com outros aplicativos especificados por meio da operação da API ou a imagem.

id

O identificador do aplicativo que está sendo especificado. Esse valor, que corresponde ao valor application_name em um relatório de aplicações do AppStream 2.0, é fornecido quando um usuário inicializa a aplicação. Quando você habilita os relatórios de uso, para cada dia que os usuários executam pelo menos uma aplicação durante as sessões de streaming, o AppStream 2.0 exporta um relatório de aplicações para o seu bucket do Amazon S3. Para obter mais informações sobre relatórios de aplicativos, consulte Campos do relatório de aplicativos.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 512 caracteres.

Nome de exibição

O nome de exibição do aplicativo que está sendo especificado. Esse nome é exibido ao usuário no catálogo de aplicativos.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 512 caracteres.

Caminho de execução

O caminho do sistema de arquivos do Windows para o executável do aplicativo a ser iniciado.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 32,767 caracteres.

Ícone de dados

A imagem codificada em base64 para exibir no catálogo de aplicativos. A imagem deve estar em um dos seguintes formatos: .png, .jpeg ou .jpg.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 1,000,000 caracteres.

Parâmetros de execução

Os parâmetros usados para executar o aplicativo.

Tipo: string

Obrigatório: não

Restrições de tamanho: o tamanho máximo é de 32.000 caracteres.

workingDirectory

O caminho do sistema de arquivos do Windows para o diretório de trabalho no qual o aplicativo deve ser executado.

Tipo: string

Obrigatório: não

Restrições de tamanho: o tamanho máximo é de 32.767 caracteres.

Operação do RemoveApplicationsRequest

Remove os aplicativos que foram adicionados usando a operação AddApplicationsRequest. Os aplicativos são removidos do catálogo de aplicativos para o usuário. Após a remoção dos aplicativos, eles não podem ser executados. Se uma aplicação ainda estiver em execução, o AppStream 2.0 não a fechará. Não é possível remover as aplicações especificadas diretamente na imagem do AppStream 2.0.

Sintaxe da solicitação

string SID do usuário;

list<Application> applications;

Parâmetros de solicitação

SID do usuário

O SID do usuário ao qual a solicitação se aplica.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 208 caracteres.

applications

A lista de aplicativos à qual a solicitação se aplica.

Tipo: string

Obrigatório: Sim

Operação do ClearApplicationsRequest

Remove todos os aplicativos que foram adicionados ao catálogo de aplicativos usando a operação AddApplicationsRequest. Após a remoção dos aplicativos, eles não podem ser executados. Se as aplicações estiverem em execução quando a operação ClearApplicationsRequest for aplicada, o AppStream 2.0 não as fechará. Não é possível remover as aplicações especificadas diretamente na imagem do AppStream 2.0.

Sintaxe da solicitação

string SID do usuário;

Parâmetros de solicitação

SID do usuário

O SID do usuário ao qual a solicitação se aplica.

Tipo: string

Obrigatório: Sim

Restrições de comprimento: mínimo de 1, máximo de 208 caracteres.