uap4:Extension

Dichiara un punto di estendibilità per l'app.

Gerarchia degli elementi

<Pacchetto>

    <Applicazioni>

         <Applicazione>

              <Estensioni>

                   <uap4:Extension>

Sintassi

<uap4:Extension
  Category = 'A string that can have one of the following values: "windows.sharedFonts", "windows.userDataTaskDataProvider", "windows.mediaCodec", "windows.contactPanel", "windows.loopbackAccessRules", "windows.devicePortalProvider", "windows.printWorkflowBackgroundTask", or "windows.printWorkflowForegroundTask".'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
  uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  uap4:SharedFonts
  uap4:UserDataTaskDataProvider
  uap4:MediaCodec 
  uap4:ContactPanel
  uap4:LoopbackAccessRules
  uap4:DevicePortalProvider?

</uap4:Extension>

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
Categoria	Tipo di punto di estendibilità del pacchetto.	Stringa che può avere uno dei valori seguenti: windows.sharedFonts, windows.userDataTaskDataProvider, windows.mediaCodec, windows.contactPanel, windows.loopbackAccessRules, windows.devicePortalProvider, windows.printWorkflowBackgroundTask o windows.printWorkflowForegroundTask.	Sì
EntryPoint	ID classe attivabile.	Stringa con un valore compreso tra 1 e 256 caratteri. Rappresenta l'attività che gestisce l'estensione (in genere il nome completo dello spazio dei nomi di un tipo di Windows Runtime). Se EntryPoint non viene specificato, viene invece usato entrypoint definito per l'app.	No
File eseguibile	Eseguibile di avvio predefinito.	Stringa con un valore compreso tra 1 e 256 caratteri, che deve terminare con .exee non può contenere questi caratteri: <, >, :, ", |, ?o *. Specifica il file eseguibile predefinito per l'estensione. Se non specificato, viene usato il file eseguibile definito per l'app. Se specificato, viene utilizzata anche la proprietà EntryPoint. Se la proprietà EntryPoint non viene specificata, viene utilizzato il EntryPoint definito per l'app.	No
RuntimeType	Provider di runtime. In genere viene usato quando sono presenti framework mescolati in un'app.	Stringa con un valore compreso tra 1 e 255 caratteri che non può iniziare o terminare con un oggetto . o contenere caratteri: <, >, :, ", |, ?o *.	No
StartPage	Pagina Web che gestisce il punto di estendibilità.	Stringa con un valore compreso tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, "|, ?, o *.	No
ResourceGroup	Tag facoltativo usato per raggruppare le attivazioni dell'estensione per scopi di gestione delle risorse, ad esempio CPU e memoria. Vedere la sezione Osservazioni in Application@ResourceGroup.	Stringa alfanumerica compresa tra 1 e 255 caratteri. Deve iniziare con una lettera.	No
uap10:TrustLevel	Specifica il livello di attendibilità dell'estensione.	Valore stringa facoltativo. Se specificato, può essere uno dei valori seguenti: appContainer o mediumIL.	No
uap10:RuntimeBehavior	Specifica il comportamento di runtime di un'estensione.	Valore stringa facoltativo. Se specificato, può essere uno dei valori seguenti: windowsApp, packagedClassicApp o win32App.	No
uap10:HostId	Specifica l'ID del runtime host per l'estensione.	Stringa alfanumerica con un valore facoltativo compreso tra 1 e 255 caratteri. Deve iniziare con una lettera.	No
uap10:Parameters	Contiene i parametri della riga di comando da passare all'estensione. Supportato solo per le app desktop.	Stringa con un valore compreso tra 1 e 32767 caratteri di lunghezza con un carattere non di spazio vuoto all'inizio e alla fine.	No
uap11:Id	Identificatore dell'estensione. L'ID deve essere univoco per tutte le estensioni di un pacchetto.	Stringa facoltativa con un valore compreso tra 1 e 255 caratteri con un carattere non vuoto all'inizio e alla fine.	No
uap11:Subsystem	Questo attributo viene ereditato dalla sintassi dell'estensione di base e non è applicabile all'estensione com4. Oltre alla convalida sintattica, questo valore viene ignorato.	Stringa facoltativa che può avere uno dei valori seguenti: console o finestre.	No
uap11:SupportsMultipleInstances	Specifica se le istanze devono essere eseguite in processi diversi. Il valore predefinito è false.	Valore booleano facoltativo.	No
uap11:ResourceGroup	Tag che è possibile usare per raggruppare le attivazioni delle estensioni per scopi di gestione delle risorse, ad esempio CPU e memoria. Il valore che è possibile impostare ResourceGroup è in formato libero e flessibile. Vedere Application@ResourceGroup.	Stringa alfanumerica facoltativa con un valore compreso tra 1 e 255 caratteri. Deve iniziare con una lettera.	No
uap11:CurrentDirectoryPath	Specifica la directory iniziale all'avvio del processo dell'applicazione.	Stringa facoltativa che non può contenere questi caratteri: <, >, |, ?o *. >	No
uap11:Parameters	Questo attributo viene ereditato dalla sintassi dell'estensione di base e non è applicabile all'estensione com4. Oltre alla convalida sintattica, questo valore viene ignorato.	Stringa facoltativa con un valore compreso tra 1 e 32767 caratteri con un carattere non di spazio vuoto all'inizio e alla fine.	No
desktop7:CompatMode	Specifica se le informazioni di questa estensione vengono registrate con Windows in modi classici (ad esempio, le app non in pacchetto registrano tipi con COM tramite il Registro di sistema) o in nuovi modi più con ambito. Il valore predefinito è "modern". CompatMode="classic" richiede la funzionalità Microsoft.classicAppCompat_8wekyb3d8bbwe .	Una stringa facoltativa può avere uno dei valori seguenti: classico o moderno.	No
desktop7:Scope	Specifica se le registrazioni sono visibili solo ad altre applicazioni in esecuzione come utente che ha registrato il pacchetto (utente) o se sono visibili a tutti gli utenti e i servizi nel computer (computer). Il valore predefinito è "user". Scope="machine" richiede la funzionalità Microsoft.classicAppCompatElevated_8wekyb3d8bbwe .	Stringa facoltativa che può avere uno dei valori seguenti: computer o utente.	No

Elementi figlio

Elemento figlio	Descrizione
SharedFonts	Contiene i percorsi dei tipi di carattere condivisi da usare con l'app.
UserDataTaskDataProvider	Consente a un'app di diventare dataprovider per un'attività.
Mediacodec	Definisce un'estensione che consente a un'app di installare codec multimediali da Microsoft Store.
ContactPanel	Abilita il pannello dei contatti in un'app di Windows.
LoopbackAccessRules	Contiene regole per un filtro di loopback che consente la comunicazione tra un'app e un servizio.
DevicePortalProvider	Definisce un provider di Device Portal per la distribuzione.

Elementi padre

Elemento padre	Descrizione
Estensioni	Definisce uno o più punti di estendibilità per il pacchetto.

Commenti

windows.printWorkflowBackgroundTask e windows.printWorkflowForegroundTask sono dichiarazioni di estensione vuote che forniscono supporto per gli scenari di stampa. Il punto di ingresso dell'attività in background verrà inizialmente chiamato dal sistema di stampa per avviare la gestione dei dati di stampa e l'attività in primo piano verrà attivata quando si richiedono altre informazioni all'utente. Il punto di ingresso in background deve essere una classe che implementa IBackgroundTask.

Requisiti

Elemento	Valore
Namespace	http://schemas.microsoft.com/appx/manifest/uap/windows10/4
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 versione 1703 (Build 15063)