Partilhar via


uap10:Extension (em Pacotes/Extensão)

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>

      <Extensões>

            <\uap10:Extension>

Syntax

<uap10:Extension
  Category = 'A string that can have one of the following values: "windows.hostRuntime", "windows.mediaContentDecryptionModule", or "windows.installedLocationVirtualization".'
  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 -->
  uap10:HostRuntime?
  uap10:InstalledLocationVirtualization?
  uap10:MediaContentDecryptionModule
  
</uap10: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.hostRuntime, windows.mediaContentDecryptionModule ou windows.installedLocationVirtualization. Yes
EntryPoint A ID da classe ativada. Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento. Representa a tarefa que está tratando a extensão (normalmente o nome totalmente qualificado para 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 esses 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 misturadas 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 conter os 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 esses 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, ele 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 para passar para a extensão. Só há suporte 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 whitespace no início e no final. No

Elementos filho

Elemento filho Descrição
uap10:HostRuntime Define uma extensão em todo o pacote que define as informações de runtime a serem usadas ao ativar um aplicativo hospedado.
uap10:InstalledLocationVirtualization Define uma extensão para um aplicativo da área de trabalho em um pacote MSIX que redireciona todas as gravações no diretório de instalação do aplicativo para um local nos dados do aplicativo.
uap10:MediaContentDecryptionModule.md Define uma extensão para um aplicativo da área de trabalho em um pacote MSIX que define informações de descriptografia a serem usadas para acessar arquivos de mídia.

Elementos pai

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

Requisitos

Item Valor
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 versão 2004 (Build 19041)