Extensão (em Aplicativo/Extensões) (Windows 10)
Declara um ponto de extensibilidade para o pacote.
Hierarquia de elementos
<Extensão>
Syntax
<Extension
Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
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.'
/>
<!-- Child elements -->
BackgroundTasks?
</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. | Pode ser um dos seguintes valores: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask ou windows.restrictedLaunch. | 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. Para obter mais informações e requisitos, consulte uap10:RuntimeBehavior no tópico do elemento Application (Windows 10). |
Um valor de cadeia de caracteres opcional. Se especificado, pode ser um dos seguintes valores: "packagedClassicApp", "win32App" ou "windowsApp". | 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 |
Elementos filho
| Elemento filho | Descrição |
|---|---|
| BackgroundTasks | Define um ponto de extensibilidade do aplicativo do tipo windows.backgroundTasks. Tarefas em segundo plano executadas em um host em segundo plano dedicado; ou seja, sem uma interface do usuário. |
Elementos pai
| Elemento pai | Descrição |
|---|---|
| Extensões (tipo: CT_ApplicationExtensions) | Define um ou mais pontos de extensibilidade para o aplicativo. |
Elementos relacionados
Os seguintes elementos têm o mesmo nome que este, mas conteúdo ou atributos diferentes:
Comentários
Se os atributos de informações de ativação não forem especificados na Extensão, eles serão herdados do aplicativo pai. Consulte a seção de comentários para o elemento Application .
Os pontos de extensibilidade são um mecanismo pelo qual um pacote pode adicionar funcionalidade de maneira definida pelo sistema operacional. Um ponto de extensibilidade é um local em que um aplicativo pode se registrar para executar código ou usar recursos do pacote atual. Para adicionar funcionalidade para um aplicativo específico, use o elemento filho Application do elemento Applications .
O ponto de extensibilidade windows.certificates não pode ser declarado várias vezes em um manifesto.
Observação
O atributo EntryPoint ou StartPage será necessário se o atributo Category for windows.UpdateTask ou windows.preInstalledConfigTask para versões do Windows 10 antes de Windows 10, versão 1607. A partir do Windows 10, versão 1607, você não precisa mais especificar um valor para EntryPoint ou StartPage quando Category for windows.Use, UpdateTask ou windows.preInstalledConfigTask para direcionar apenas dispositivos que executam Windows 10, versão 1607 ou posterior.
Confira também
Conceitos Contratosde aplicativo e extensões
Requisitos
| Item | Valor |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |