uap:Extension (Windows 10)

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

                   <uap:Extension>

Syntax

<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

Elementos filho

Elementos pai

Comentários

Para a maioria dos tipos de extensões, Extension@ResourceGroup deve corresponder Application@ResourceGroup (se Application@ResourceGroup for omitido, Extension@ResourceGroup também deverá ser omitido).

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 tarefa em segundo plano têm permissão para especificar os mesmos valores que Application@ResourceGroup.

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

Por exemplo, se o manifesto tivesse essas 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 do backgroundtaskhost.exe se fossem ativadas simultaneamente. No entanto, uma instância separada de backgroundtaskhost.exe seria criada para a primeira entrada porque ela 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 do backgroundtaskhost.exe.

Além disso, se uma dessas extensões (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask ou windows.updateTask) especificar o mesmo valor do atributo ResourceGroup do elemento Application pai, eles serão ativados 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: registra o aplicativo como um provedor de pesquisa. O conteúdo indexado do aplicativo pode aparecer como resultados da pesquisa na experiência de pesquisa global iniciada por meio do botão Pesquisa. É permitida somente uma instância dessa declaração por aplicativo.
• CachedFileUpdater: registra o aplicativo como um atualizador de arquivo armazenado em cache, permitindo que o aplicativo faça atualizações para arquivos acessados por outros aplicativos da Microsoft Store. É permitida somente uma instância dessa declaração por aplicativo.
• Configurações da Câmera: permite que o aplicativo forneça painéis de controle personalizados para dispositivos de câmera da Web. É permitida somente uma instância dessa declaração 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. É permitida somente uma instância dessa declaração por aplicativo.
• PrintTaskSettings: permite que o aplicativo substitua a experiência básica de configurações de impressão. É permitida somente uma instância dessa declaração por aplicativo.
• LockScreen: se um telefone estiver bloqueado, haverá uma quantidade limitada de interação que o usuário pode executar. Em alguns casos, um usuário gostaria de poder atender a uma chamada VoIP sem desbloquear o telefone. Esse contrato torna isso possível. É permitida somente uma instância dessa declaração por aplicativo.
• Alarme: um aplicativo pode se declarar como o Aplicativo de Alarme do Sistema. Quando um usuário passa pela interface do usuário de seleção para definir o Alarme do Sistema, somente os aplicativos declarados como Aplicativos de Alarme do Sistema podem ser selecionados. É permitida somente uma instância dessa declaração por aplicativo.
• BackgroundTasks: tarefas em segundo plano permitem que os aplicativos se comuniquem entre si e habilitem um aplicativo para chamar outro. Para usar contratos para fornecer ou iniciar essas tarefas em segundo plano, um aplicativo precisa ser declarado como um serviço de aplicativo. São permitidas várias instâncias dessa declaração em cada aplicativo.
• Print3DWorkFlow: os fabricantes de impressoras 3D podem fornecer um aplicativo Universal do Windows para fornecer uma experiência exclusiva na caixa de diálogo de impressão 3D. Se não o fizerem, o Windows fornecerá uma experiência de impressão 3D padrão. É permitida somente uma instância dessa declaração por aplicativo.
• PersonalAssistantLaunch: permite que um aplicativo se integre à Cortana. É permitida somente uma instância dessa declaração por aplicativo.

Requisitos