uap3:AppExtension

  • Articolo

Dichiara un punto di estendibilità dell'app di tipo windows.appExtension. Questo elemento indica le categorie di estensioni che l'app intende utilizzare e/o ospitare.

Gerarchia degli elementi

<Pacchetto>

    <Applicazioni>

         <Applicazione>

              <Estensioni>

                   <uap3:Extension>

                        <uap3:AppExtension>

Sintassi

<uap3:AppExtension
    Name = 'A string with a value between 2 and 255 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
    Id = 'A string with a value between 2 and 39 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
    PublicFolder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'A string with a value between 1 and 256 characters in length.'
    Description = 'A string between 1 and 2048 characters in length.' >

  <!-- Child elements -->
  uap3:Properties?

</uap3:AppExtension>

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Obbligatoria Valore predefinito
Descrizione Descrizione dell'app Stringa compresa tra 1 e 2048 caratteri. No
DisplayName Nome descrittivo dell'estensione dell'app che può essere visualizzato agli utenti. Stringa con un valore compreso tra 1 e 256 caratteri. Sì
Id Punto di ingresso in base al quale l'app host accede all'istanza della categoria di estensione, se sono presenti più punti di ingresso. Stringa con un valore compreso tra 2 e 39 caratteri costituiti da caratteri alfanumerici, punti (ad eccezione del primo carattere) e trattini. Sì
Nome Tipo di estensione che l'app intende utilizzare e/o ospitare. Stringa con un valore compreso tra 2 e 255 caratteri costituiti da caratteri alfanumerici, punti (ad eccezione del primo carattere) e trattini. Sì
Cartella pubblica Cartella dichiarata dall'istanza come percorso in cui un host può avere accesso in lettura ai file tramite un broker. Stringa con un valore compreso tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, "|, ?, o *. Sì

Elementi figlio

Elemento figlio Descrizione
uap3:Properties Contiene codice XML opaco che rappresenta informazioni personalizzate specifiche dell'estensione semplicemente archiviate e non lette dal sistema operativo. Le informazioni vengono lette solo dall'app host.

Elementi padre

Elemento padre Descrizione
uap3:Extension Dichiara un punto di estendibilità per l'app.

Esempio

L'esempio seguente indica che l'app ospita o utilizza l'estensione del browser a prestazioni ridotte

<Package
    xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"  
    IgnorableNamespaces="... uap3">
    <Applications>
        <Application>
            <Extensions>
                <uap3:Extension 
                    Category="windows.appExtension">  
                    <uap3:AppExtension
                        Name="com.microsoft.browser.ext"
                        Id="Extension.Low.Performance"
                        PublicFolder="public\lowperf"
                        DisplayName="Low Performance Extension"/>  
                </uap3:Extension>  
              </Extensions>
        </Application>
    </Applications>
</Package>

Requisiti

Elemento Valore
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3
Minimum OS Version Windows 10 versione 1607 (Build 14393)