uap4:Extension

  • Articolo

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 activatable. Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza. Rappresenta l'attività che gestisce l'estensione (normalmente 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 in lunghezza, 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 usata anche la proprietà EntryPoint. Se la proprietà EntryPoint non è specificata, viene usato EntryPoint definito per l'app. No
RuntimeType Provider di runtime. In genere usato quando sono presenti framework mescolati in un'app. Stringa con un valore compreso tra 1 e 255 caratteri in lunghezza che non possono 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 in lunghezza che non possono contenere questi caratteri: <":|>?, o .* No
ResourceGroup Tag facoltativo usato per raggruppare le attivazioni delle estensioni 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 di lunghezza. 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 di lunghezza. 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 in lunghezza con un carattere non di spazi vuoti all'inizio e alla fine. No
uap11:Id Identificatore per l'estensione. L'ID deve essere univoco per tutte le estensioni in un pacchetto. Stringa facoltativa con un valore compreso tra 1 e 255 caratteri in lunghezza con un carattere di spazio non vuoto all'inizio e alla fine. No
uap11:Sottosistema 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 è free-form e flessibile. Vedere Application@ResourceGroup. Stringa alfanumerica facoltativa con un valore compreso tra 1 e 255 caratteri di lunghezza. Deve iniziare con una lettera. No
uap11:CurrentDirectoryPath Specifica la directory iniziale al momento dell'avvio del processo dell'applicazione. Questo attributo supporta le macro. Per altre informazioni, vedere Macro nello schema del manifesto del pacchetto. 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. Questo attributo supporta le macro. Per altre informazioni, vedi Macro nello schema del manifesto del pacchetto. 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)