Utilizza il framework di applicazioni dinamiche di AppStream 2.0 per compilare un provider di app dinamiche - Amazon AppStream 2.0

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizza il framework di applicazioni dinamiche di AppStream 2.0 per compilare un provider di app dinamiche

Il framework di applicazioni dinamiche AppStream 2.0 fornisce operazioni all'interno di un'istanza di streaming AppStream 2.0 che puoi utilizzare per creare un provider di app dinamiche. I provider di app dinamiche possono utilizzare le operazioni API fornite per modificare il catalogo delle applicazioni a cui gli utenti possono accedere in tempo reale. Le applicazioni gestite dai provider di app dinamiche possono essere all'interno dell'immagine oppure possono essere fuori dall'istanza, ad esempio in una condivisione di file di Windows o una tecnologia di virtualizzazione dell'applicazione.

Nota

Questa caratteristica richiede un parco istanze sempre attivo o on demand di AppStream 2.0 che viene aggiunto a un dominio Microsoft Active Directory. Per ulteriori informazioni, consulta Utilizzo di Active Directory con AppStream 2.0.

Informazioni sul framework di applicazioni dinamiche

Il framework di applicazioni dinamiche usa il framework del software Apache Thrift per la messaggistica tra processi. È esposto tramite named pipe in Windows. Utilizzando il framework Thrift puoi compilare il provider di app dinamiche nel linguaggio di sviluppo di software che desideri. Il framework di applicazioni dinamiche consiste di tre operazioni API: AddApplications, RemoveApplications e ClearApplications.

Nome della named pipe e definizioni di Thrift del framework di applicazioni dinamiche

Thrift consente di utilizzare i semplici file di definizione forniti da AppStream 2.0 per compilare i client RPC. I client RPC consentono di comunicare con il software dell'agente AppStream 2.0 in esecuzione su un'istanza di streaming. Per informazioni su come compilare il client RPC nel linguaggio preferito, consulta la documentazione di Apache Thrift. Dopo aver compilato le librerie Thrift nel linguaggio preferito, compila un client Thrift usando il trasporto Named Pipe. Utilizza D56C0258-2173-48D5-B0E6-1EC85AC67893 come il nome della 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), }

Operazioni API per la gestione dei diritti sulle app per AppStream 2.0

Puoi utilizzare le seguenti operazioni API per gestire i diritti sulle applicazioni di AppStream 2.0.

Operazione AddApplicationsRequest

Aggiunge applicazioni al catalogo delle applicazioni per gli utenti di AppStream 2.0. Il catalogo delle applicazioni visualizzato da AppStream 2.0 include le applicazioni che aggiungi utilizzando questa operazione API e le applicazioni che aggiungi nell'immagine. Dopo aver aggiunto le applicazioni utilizzando uno o entrambi questi metodi, gli utenti possono avviare le applicazioni.

Sintassi della richiesta

string userSid;

list<Application> applications;

Parametri della richiesta

userSid

Il SID dell'utente a cui si applica la richiesta.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 208 caratteri.

applications

L'elenco delle applicazioni a cui si applica la richiesta.

Tipo: stringa

Campo obbligatorio: sì

Oggetto Application

Descrive i metadati dell'applicazione necessari per visualizzare e avviare l'applicazione. L'identificatore dell'applicazione deve essere univoco e non in conflitto con altre applicazioni specificate tramite l'operazione API o l'immagine.

id

L'identificatore dell'applicazione specificata. Questo valore, che corrisponde al valore application_name in un report di applicazioni di AppStream 2.0, viene fornito quando un utente avvia l'applicazione. Quando abiliti i report sull'utilizzo, per ogni giorno in cui gli utenti avviano almeno un'applicazione durante le sessioni di streaming, AppStream 2.0 esporta un report delle applicazioni nel bucket Amazon S3. Per ulteriori informazioni sui report di applicazioni, consulta Campi report applicazioni.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 512 caratteri.

displayName

Il nome visualizzato dell'applicazione specificata. Questo nome viene visualizzato nel catalogo delle applicazioni.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 512 caratteri.

launchPath

Il percorso nel file system di Windows dell'eseguibile dell'applicazione da avviare.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 32.767 caratteri.

iconData

L'immagine codificata in base 64 da visualizzare nel catalogo delle applicazioni. Il formato dell'immagine deve essere uno dei seguenti: .png, .jpeg o .jpg.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 1.000.000 caratteri.

launchParams

I parametri utilizzati per avviare l'applicazione.

Tipo: stringa

Required: No

Vincoli della lunghezza: lunghezza massima 32.000 caratteri.

workingDirectory

Il percorso nel file system di Windows della directory di lavoro in cui deve essere avviata l'applicazione.

Tipo: stringa

Required: No

Vincoli della lunghezza: lunghezza massima 32.767 caratteri.

Operazione RemoveApplicationsRequest

Rimuove le applicazioni aggiunte utilizzando l'operazione AddApplicationsRequest. Le applicazioni vengono rimossi dal catalogo delle applicazioni per l'utente. Una volta rimosse, le applicazioni non possono più essere avviate. Se un'applicazione è in esecuzione, AppStream 2.0 non la chiude. Le applicazioni specificate direttamente nell'immagine AppStream 2.0 non possono essere rimosse.

Sintassi della richiesta

string userSid;

list<Application> applications;

Parametri della richiesta

userSid

Il SID dell'utente a cui si applica la richiesta.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 208 caratteri.

applications

L'elenco delle applicazioni a cui si applica la richiesta.

Tipo: stringa

Campo obbligatorio: sì

Operazione ClearApplicationsRequest

Rimuove tutte le applicazioni aggiunte al catalogo delle applicazioni utilizzando l'operazione AddApplicationsRequest. Una volta rimosse, le applicazioni non possono più essere avviate. Se le applicazioni sono in esecuzione quando viene utilizzata l'operazione ClearApplicationsRequest, AppStream 2.0 non le chiude. Le applicazioni specificate direttamente nell'immagine AppStream 2.0 non possono essere rimosse.

Sintassi della richiesta

string userSid;

Parametri della richiesta

userSid

Il SID dell'utente a cui si applica la richiesta.

Tipo: stringa

Campo obbligatorio: sì

Limitazioni della lunghezza: lunghezza minima pari a 1, lunghezza massima pari a 208 caratteri.