deployment:Extension (em Pacote/Extensões)
Declara um ponto de extensibilidade para o aplicativo que especifica um DEH (manipulador de extensão de implantação) desencaixado.
Hierarquia de elementos
<deployment:Extension>
Syntax
<deployment:Extension
Category = 'A string that can have one of the following values: "windows.deploymentExtensionHandler".'
Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It 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 that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the task handling the extension. This is 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
uap10:Parameters = 'An optional string with a 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 -->
deployment:DeploymentExtensionHandler?
</deployment:Extension>
Chave
? opcional (zero ou um)
Atributos e elementos
Atributos
| Atributo | Descrição | Tipo de dados | Obrigatório | Valor padrão |
|---|---|---|---|---|
| Categoria | A categoria da extensão. | Uma cadeia de caracteres que pode ter um dos seguintes valores: windows.fileExplorerClassicContextMenuHandler ou windows.fileExplorerClassicDragDropContextMenuHandler. | Yes | |
| Executável | O executável de inicialização padrão. | Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento que deve terminar com .exe e não pode conter esses caracteres: <, , :>, , "|, ?ou *. Ele 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 | |
| EntryPoint | A ID da classe ativada. | Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento, representando a tarefa que manipula a extensão. Normalmente é o nome totalmente qualificado do namespace de um tipo do Windows Runtime. Se EntryPoint não for especificado, o EntryPoint definido para o aplicativo será usado. | No | |
| Runtimetype | O provedor de runtime. Esse atributo é usado normalmente quando há estruturas mistas em um aplicativo. | Uma cadeia de caracteres opcional com um valor entre 1 e 255 caracteres de comprimento que não pode iniciar ou terminar com um período ou conter esses caracteres: <, >, , :, ", \/, |, ?ou *. |
No | |
| StartPage | A página da Web que manipula o ponto de extensibilidade. | Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento que não pode conter esses caracteres: <, >, , :, ", |?ou *. |
No | |
| uap10:TrustLevel | Especifica o nível de confiança da extensão. | Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: appContainer ou mediumIL. | No | |
| uap10:RuntimeBehavior | Especifica o comportamento de tempo de execução da extensão. | Uma cadeia de caracteres opcional que pode ter 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 entre 1 e 255 caracteres de comprimento. Deve começar com uma letra. | No | |
| uap10:Parameters | Contém parâmetros de linha de comando para passar para a extensão. Há suporte apenas para aplicativos da área de trabalho que têm identidade de pacote. | 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 | |
| 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 whitespace no início e no final. | No | |
| uap11:Subsistema | 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 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. Consulte 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 de aplicativo é iniciado. Esse atributo dá suporte a macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote. | Uma cadeia de caracteres opcional que não pode conter esses 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. Esse atributo dá suporte a 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 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 |
|---|---|
| DeploymentExtensionHandler | Permite que um aplicativo especifique um ou mais arquivos DLL que fornecem funcionalidade DEH que é enviada para fora de uma versão do sistema operacional. |
Elementos pai
| Elemento pai | Descrição |
|---|---|
| Extensões | Define um ou mais pontos de extensibilidade para o aplicativo. |
Comentários
Um DEH permite que os aplicativos acessem pontos de extensibilidade no sistema operacional. Um DEH desencaixado é aquele que é enviado para fora de uma versão do sistema operacional. Essa extensão não se destina a ser usada por desenvolvedores de terceiros.
Exemplos
O exemplo a seguir mostra o uso do elemento DeploymentExtensionHandler em um arquivo de manifesto de pacote para registrar um DEH desencaixado.
<Extension Category=”windows.deploymentExtensionHandler”>
<DeploymentExtensionHandler>
<Files>
<File>path/to/UndockedDEH.dll </File>
<File>path/to/UndockedDEH2.dll </File>
</Files>
</DeploymentExtensionHandler>
</Extension>
Requisitos
| Item | Valor |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/deployment/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 |
| Minimum OS Version | Windows 10 (Build 20348) |