uap:Extensão (Windows 10)

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>

     <Aplicações>

          <Aplicação>

               <Extensões>

                    <uap:Extensão>

Sintaxe

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  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 -->
  uap:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Necessá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.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider , windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunchou windows.voipCall.	Sim
EntryPoint	O ID de 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 para namespace de um tipo do Tempo de Execução do Windows). Se EntryPoint não for especificado, o EntryPoint definido para o aplicativo será usado.	Não
executáveis	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 especificado, a propriedade EntryPoint também é usada. Se essa propriedade EntryPoint não for especificada, o EntryPoint definido para o aplicativo será usado.	Não
RuntimeType	O provedor de tempo de execução. 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 começar ou terminar com um . ou conter caracteres: <, >, :, ", |, ?ou *.	Não
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 *.	Não
ResourceGroup	Uma tag opcional usada para agrupar ativações de extensão para fins de gerenciamento de recursos (por exemplo, CPU e memória). Consulte a secção Observações em Application@ResourceGroup.	Uma cadeia alfanumérica entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	Não
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.	Não
uap10:RuntimeBehavior	Especifica o comportamento de tempo de execução de uma extensão.	Um valor de cadeia de caracteres opcional. Se especificado, pode ser um dos seguintes valores: windowsApp, packagedClassicAppou win32App.	Não
uap10:HostId	Especifica a ID do tempo de execução do host para a extensão.	Uma cadeia alfanumérica com um valor opcional entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	Não
uap10:Parâmetros	Contém parâmetros de linha de comando para passar para a extensão. Suportado apenas para aplicações de ambiente de trabalho.	Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim.	Não
uap11:Id	Um identificador para a extensão. O ID deve ser exclusivo 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 sem espaço em branco no início e no fim.	Não
uap11:Subsistema	Este atributo é herdado da sintaxe da 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 windows.	Não
uap11:SupportsMultipleInstances	Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false.	Um valor booleano opcional.	Não
uap11:ResourceGroup	Uma tag 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. Ver Application@ResourceGroup.	Uma cadeia alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	Não
uap11:CurrentDirectoryPath	Especifica o diretório inicial quando o processo do aplicativo é iniciado. Este atributo suporta macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote.	Uma cadeia de caracteres opcional que não pode conter estes caracteres: <, >, |, ?ou *. >	Não
uap11:Parâmetros	Este atributo é herdado da sintaxe da extensão base e não é aplicável à extensão com4. Além da validação sintática, esse valor é ignorado. Este atributo suporta macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote.	Uma cadeia de caracteres opcional com um valor entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim.	Não
desktop7:CompatMode	Especifica se as informações dessa extensão são registradas no Windows de maneiras clássicas (por exemplo, aplicativos não empacotados, tipos de registro com COM por meio do Registro) ou de maneiras novas e com mais escopo. O valor padrão é "moderno". CompatMode="classic" requer a capacidade de Microsoft.classicAppCompat_8wekyb3d8bbwe.	Uma cadeia de caracteres opcional pode ter um dos seguintes valores: clássico ou moderno.	Não
desktop7:Escopo	Especifica se os registros são visíveis apenas para outros aplicativos em execução como um usuário que tem esse pacote registrado (usuário) ou se eles são visíveis para todos os usuários e serviços na máquina (máquina). O valor padrão é "user". Scope="machine" requer a capacidade Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: máquina ou usuário.	Não

Elementos filho

Elemento filho	Descrição
uap:AppService	Declara um ponto de extensibilidade de aplicativo do tipo windows.appService. Os Contratos de Aplicação são uma forma de uma aplicação invocar uma tarefa em segundo plano pertencente a outra aplicação; ou para uma tarefa em segundo plano invocada para atender um contrato de aplicativo, uma maneira de se comunicar com seu chamador.
uap:AppointmentsProvider	Declara um ponto de extensibilidade de aplicativo do tipo windows.appointmentsProvider.
uap:AutoPlayContent	Declara um ponto de extensibilidade de aplicativo do tipo windows.autoPlayContent. O aplicativo fornece as ações de conteúdo de Reprodução Automática especificadas.
uap:AutoPlayDevice	Declara um ponto de extensibilidade de aplicativo do tipo *windows.autoPlayDevice. O aplicativo fornece as ações especificadas do dispositivo de Reprodução Automática.
uap:DialProtocol	Declara um ponto de extensibilidade de aplicativo do tipo windows.dialProtocol*.
uap:FileOpenPicker	Declara um ponto de extensibilidade de aplicativo do tipo windows.fileOpenPicker. O aplicativo permite que o usuário escolha e abra os tipos especificados de arquivos.
uap:FileSavePicker	Declara um ponto de extensibilidade de aplicativo do tipo windows.fileSavePicker. O aplicativo permite que o usuário escolha o nome do arquivo, a extensão e o local de armazenamento para os tipos especificados de arquivos.
uap:FileTypeAssociation	Declara um ponto de extensibilidade de aplicativo do tipo windows.fileTypeAssociation. Uma associação de tipo de arquivo indica que o aplicativo está registrado para manipular arquivos dos tipos especificados.
uap:MediaPlayback	Declara um ponto de extensibilidade do aplicativo do tipo mediaPlayback para que seu aplicativo possa declarar que executa transcodificação de vídeo.
uap:Protocolo	Declara um ponto de extensibilidade de aplicativo do tipo windows.protocol. Uma associação de URI indica que o aplicativo está registrado para manipular URIs com o esquema especificado.
uap:ShareTarget	Declara um ponto de extensão de aplicativo do tipo windows.shareTarget. O aplicativo pode compartilhar os tipos especificados de arquivos.
uap:VoipCall	Declara um ponto de extensibilidade de aplicativo do tipo windows.voipCall para que seu aplicativo possa declarar que pode executar uma atualização de uma chamada de celular para uma chamada de vídeo VoIP e/ou se é um aplicativo VoIP que suporta a discagem direta de números de telefone.
uap:WebAccountProvider	Declara um ponto de extensibilidade de aplicativo do tipo windows.webAccountProvider.

Elementos pai

Elemento pai	Descrição
Extensões (tipo:CT_ApplicationExtensions)	Define um ou mais pontos de extensibilidade para o aplicativo.

Comentários

Para a maioria dos tipos de extensões, Extension@ResourceGroup deve corresponder Application@ResourceGroup (se Application@ResourceGroup for omitida, então Extension@ResourceGroup também deve ser omitida).

Para um contrato baseado em interface do usuário: se Extension@ResourceGroup não for especificado, ele será implicitamente agrupado com o Aplicativo; Se Extension@ResourceGroup não corresponder Application@ResourceGroup o manifesto falhará na validação do esquema.

Se Extension@ResourceGroup não for especificado para uma tarefa em segundo plano ou para um contrato baseado em uma tarefa em segundo plano, ele será associado a um grupo padrão para todas as tarefas em segundo plano. Os contratos de tarefas em segundo plano podem especificar os mesmos valores que Application@ResourceGroup.

Para as seguintes Extensões, Extension@ResourceGroup permite que a tarefa em segundo plano executada seja agrupada em diferentes processos que serão gerenciados por recursos e ciclo de vida independentemente de outros grupos: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTaske windows.updateTask.

Por exemplo, se o manifesto tinha estas três entradas.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

Em seguida, as duas últimas tarefas em segundo plano seriam ativadas na mesma instância de backgroundtaskhost.exe se fossem ativadas simultaneamente. No entanto, uma instância separada de backgroundtaskhost.exe seria girada para a primeira entrada porque tem um ResourceGroup diferente.

Se nenhum ResourceGroup for especificado para uma extensão, todas as tarefas em segundo plano serão ativadas na mesma instância de backgroundtaskhost.exe.

Além disso, se uma dessas extensões(windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTaskou windows.updateTask) especificar o mesmo valor do atributo ResourceGroup do elemento Application pai, elas serão ativadas no mesmo processo que a interface do usuário.

As seguintes extensões podem ser encontradas na guia declarações da interface do usuário do designer de pacotes - consulte as descrições de cada um desses elementos:

• Pesquisa: Regista a aplicação como fornecedor de pesquisa. O conteúdo indexado da aplicação pode aparecer como resultados de pesquisa na experiência de pesquisa global iniciada através do atalho Procurar. Apenas uma instância dessa declaração é permitida por aplicativo.
• CachedFileUpdater: registra o aplicativo como um atualizador de arquivos em cache, permitindo que o aplicativo forneça atualizações para arquivos acessados por outros aplicativos da Microsoft Store. Apenas uma instância dessa declaração é permitida por aplicativo.
• Configurações da câmera: Permite que o aplicativo forneça painéis de controle personalizados para dispositivos de câmera web. Apenas uma instância dessa declaração é permitida por aplicativo.
• AccountPictureProvider: registra o aplicativo como um provedor de imagens de conta, permitindo que ele seja iniciado em um modo de imagem de conta e defina a imagem do usuário sem solicitação adicional. Apenas uma instância dessa declaração é permitida por aplicativo.
• PrintTaskSettings: Permite que o aplicativo substitua a experiência básica de configurações de impressão. Apenas uma instância dessa declaração é permitida por aplicativo.
• LockScreen: Se um telefone estiver bloqueado, há uma quantidade limitada de interação que o usuário pode realizar. Em alguns casos, um usuário gostaria de ser capaz de atender uma chamada VoIP sem desbloquear o telefone. Este contrato torna isso possível. Apenas uma instância dessa declaração é permitida por aplicativo.
• Alarm: Um aplicativo pode se declarar como o System Alarm App. Quando um usuário passa pela interface do usuário de seleção para definir seu Alarme do Sistema, somente os aplicativos declarados como Aplicativos de Alarme do Sistema podem ser selecionados. Apenas uma instância dessa declaração é permitida por aplicativo.
• BackgroundTasks: As tarefas em segundo plano permitem que os aplicativos se comuniquem entre si e permitem que um aplicativo chame outro. Para usar contratos para fornecer ou iniciar essas tarefas em segundo plano, um aplicativo precisa ser declarado como um serviço de aplicativo. Várias instâncias dessa declaração são permitidas em cada aplicativo.
• Print3DWorkFlow: Os fabricantes de impressoras 3D podem fornecer um aplicativo Universal do Windows para fornecer uma experiência única na caixa de diálogo de impressão 3D. Caso contrário, o Windows fornece uma experiência de impressão 3D padrão. Apenas uma instância dessa declaração é permitida por aplicativo.
• PersonalAssistantLaunch: Permite que um aplicativo se integre à Cortana. Apenas uma instância dessa declaração é permitida por aplicativo.

Requerimentos

Número	Valor
Espaço de nomes	http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11	http://schemas.microsoft.com/appx/manifest/uap/windows10/11
desktop7	http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
Versão mínima do SO	Windows 10 versão 1511 (Build 10586)