uap4:Extension

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

                   <uap4:Extension>

Syntax

<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>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de Dados	Obrigatório	Valor padrão
Categoria	O tipo de ponto de extensibilidade do pacote.	Uma cadeia de caracteres que pode ter um dos seguintes valores: windows.sharedFonts, windows.userDataTaskDataProvider, windows.mediaCodec, windows.contactPanel, windows.loopbackAccessRules, windows.devicePortalProvider, windows.printWorkflowBackgroundTask ou windows.printWorkflowForegroundTask.	Yes
EntryPoint	A ID da classe ativável.	Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento. Representa a tarefa que manipula a extensão (normalmente, o nome totalmente qualificado do namespace de um tipo de Windows Runtime). Se EntryPoint não for especificado, o EntryPoint definido para o aplicativo será usado.	No
Executável	O executável de inicialização padrão.	Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento, que deve terminar com .exee não pode conter estes caracteres: <, >, :, ", |, ?ou *. Especifica o executável padrão para a extensão. Se não for especificado, o executável definido para o aplicativo será usado. Se especificada, a propriedade EntryPoint também será usada. Se essa propriedade EntryPoint não for especificada, o EntryPoint definido para o aplicativo será usado.	No
Runtimetype	O provedor de runtime. Normalmente usado quando há estruturas mistas em um aplicativo.	Uma cadeia de caracteres com um valor entre 1 e 255 caracteres de comprimento que não pode iniciar ou terminar com um . ou contêm caracteres: <, >, , :", |, ?ou *.	No
StartPage	A página da Web que manipula o ponto de extensibilidade.	Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que não pode conter estes caracteres: <, >, :, ", |, ?ou *.	No
ResourceGroup	Uma marca opcional usada para agrupar ativações de extensão para fins de gerenciamento de recursos (por exemplo, CPU e memória). Consulte a seção Comentários em Application@ResourceGroup.	Uma cadeia de caracteres alfanumérica entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	No
uap10:TrustLevel	Especifica o nível de confiança da extensão.	Um valor de cadeia de caracteres opcional. Se especificado, pode ser um dos seguintes valores: appContainer ou mediumIL.	No
uap10:RuntimeBehavior	Especifica o comportamento de runtime de uma extensão.	Um valor de cadeia de caracteres opcional. Se especificado, pode ser um dos seguintes valores: windowsApp, packagedClassicApp ou win32App.	No
uap10:HostId	Especifica a ID do runtime do host para a extensão.	Uma cadeia de caracteres alfanumérica com um valor opcional entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	No
uap10:Parameters	Contém parâmetros de linha de comando a serem passados para a extensão. Há suporte apenas para aplicativos da área de trabalho.	Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não em branco no início e no final.	No
uap11:Id	Um identificador para a extensão. A ID deve ser exclusiva para todas as extensões em um pacote.	Uma cadeia de caracteres opcional com um valor entre 1 e 255 caracteres de comprimento com um caractere não em branco no início e no final.	No
uap11:Subsystem	Esse atributo é herdado da sintaxe de extensão base e não é aplicável à extensão com4. Além da validação sintática, esse valor é ignorado.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: console ou janelas.	No
uap11:SupportsMultipleInstances	Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false.	Um valor booliano opcional.	No
uap11:ResourceGroup	Uma marca que você pode usar para agrupar ativações de extensão para fins de gerenciamento de recursos (por exemplo, CPU e memória). O valor que você pode definir ResourceGroup é de forma livre e flexível. Confira Application@ResourceGroup.	Uma cadeia de caracteres alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	No
uap11:CurrentDirectoryPath	Especifica o diretório inicial quando o processo do aplicativo é iniciado.	Uma cadeia de caracteres opcional que não pode conter estes caracteres: <, >, |, ?ou *. >	No
uap11:Parameters	Esse atributo é herdado da sintaxe da extensão base e não é aplicável à extensão com4. Além da validação sintactica, esse valor é ignorado.	Uma cadeia de caracteres opcional com um valor entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final.	No
desktop7:CompatMode	Especifica se as informações dessa extensão são registradas com o Windows de maneiras clássicas (por exemplo, aplicativos não empacotados registram tipos com COM por meio do registro) ou de novas maneiras mais com escopo. O valor padrão é "moderno". CompatMode="classic" requer a funcionalidade de Microsoft.classicAppCompat_8wekyb3d8bbwe .	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: clássico ou moderno.	No
desktop7:Escopo	Especifica se os registros só são visíveis para outros aplicativos em execução como um usuário que tem esse pacote registrado (usuário) ou se estão visíveis para todos os usuários e serviços no computador (computador). O valor padrão é "user". Scope="machine" requer a funcionalidade Microsoft.classicAppCompatElevated_8wekyb3d8bbwe .	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: computador ou usuário.	No

Elementos filho

Elemento filho	Descrição
SharedFonts	Contém os locais das fontes compartilhadas a serem usadas com o aplicativo.
UserDataTaskDataProvider	Permite que um aplicativo se torne um DataProvider para uma tarefa.
MediaCodec	Define uma extensão que permite que um aplicativo instale codecs de mídia da Microsoft Store.
ContactPanel	Habilita o painel de contatos em um aplicativo do Windows.
LoopbackAccessRules	Contém regras para um filtro de loopback que permite a comunicação entre um aplicativo e um serviço.
DevicePortalProvider	Define um provedor do Portal de Dispositivos para implantação.

Elementos pai

Elemento pai	Descrição
Extensões	Define um ou mais pontos de extensibilidade para o pacote.

Comentários

windows.printWorkflowBackgroundTask e windows.printWorkflowForegroundTask são declarações de extensão vazias que fornecem suporte para cenários de impressão. O ponto de entrada da tarefa em segundo plano será inicialmente chamado pelo sistema de impressão para começar a manipular dados de impressão e a tarefa em primeiro plano será ativada ao solicitar mais informações do usuário. O ponto de entrada em segundo plano deve ser uma classe que implementa IBackgroundTask.

Requisitos

Item	Valor
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 versão 1703 (Build 15063)