Azioni delle app nel formato XML del manifesto del pacchetto Windows

Questo articolo descrive il formato XML del manifesto del pacchetto per Azioni App in Windows.

Estensione di app

Il file manifesto del pacchetto dell'app supporta molte estensioni e funzionalità diverse per le app di Windows. Il formato manifesto del pacchetto dell'app è definito da un set di schemi documentati nel Riferimento dello schema del manifesto del pacchetto. I fornitori di azioni dichiarano le informazioni di registrazione all'interno di uap3:AppExtension. L'attributo Name dell'estensione deve essere impostato su "com.microsoft.windows.ai.actions".

I provider di azioni devono includere uap3:Properties come figlio di uap3:AppExtension. Lo schema del manifesto del pacchetto non applica la struttura dell'elemento uap3:Properties, se non per richiedere che sia XML ben formato.

I provider di azioni devono fornire un elemento Registration che specifica il percorso del file JSON di definizione dell'azione. Per ulteriori informazioni, vedere Schema JSON dell'azione per i fornitori di azioni di Windows Copilot.

<uap3:Extension Category="windows.appExtension"> 
    <uap3:AppExtension 
        Name="com.microsoft.windows.ai.actions" 
        DisplayName="..." 
        Id="..." 
        PublicFolder="Assets"> 
      <uap3:Properties> 
        <Registration>path\to\registration.json</Registration> <!-- path relative to the PublicFolder above -->
      </uap3:Properties> 
    </uap3:AppExtension> 
</uap3:Extension> 

Requisiti aggiuntivi

Sia i provider di azioni COM che quelli avviati tramite URI devono avere un'identità del pacchetto. L'identità del pacchetto viene dichiarata nel file manifesto del pacchetto dell'app usando l'elemento Identity . Per altre informazioni, vedere Panoramica dell'identità del pacchetto nelle app di Windows.

I provider di azioni basati su COM devono essere app con attendibilità totale che hanno un livello di integrità medioIL. Questa operazione viene dichiarata nel file manifesto del pacchetto dell'app impostando l'attributo *uap10:TrustLevel su "mediumIL".

Anche i provider di azioni avviate dall'URI devono avere un livello di attendibilità medio. Se un provider di azioni avviato dall'URI restituirà output, l'app deve implementare la possibilità di essere avviata per ottenere risultati. Per altre informazioni, vedere Avviare un'app per ottenere risultati. Anche i provider di azioni avviati dall'URI che restituiscono output devono creare un'istanza del runtime.