Compartilhar via

Extensão (em Pacote/Extensões) (Windows 10)

  • Artigo

Declara um ponto de extensibilidade para o pacote.

Hierarquia de elementos

do pacote

    extensões de <>

          de Extensão

Sintaxe

<Extension
  Category = 'A string that can have one of the following values: "windows.activatableClass.inProcessServer", "windows.activatableClass.outOfProcessServer", "windows.activatableClass.proxyStub", "windows.certificates", "windows.publisherCacheFolders", "windows.comInterface", or "windows.loaderSearchPathOverride".'
  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 -->
  InProcessServer
  OutOfProcessServer
  ProxyStub
  Certificates
  PublisherCacheFolders
  com:ComInterface
  uap6:LoaderSearchPathOverride

</Extension>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dado Necessário Valor padrão
de Categoria O tipo de ponto de extensibilidade do pacote. Uma cadeia de caracteres que pode ter um dos seguintes valores: windows.activatableClass.inProcessServer, windows.activatableClass.outOfProcessServer, windows.activatableClass.proxyde windows.certificates, windows.publisherCacheFolders, windows.comInterface ou windows.loaderSearchPathOverride Sim
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. Não
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, packagedClassicAppou win32App. Não
uap10:HostId Esse valor 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.
uap10:Parameters Contém parâmetros de linha de comando para a extensão. Uma cadeia de caracteres entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final. Não
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. Não
uap11:Subsistema Esse atributo é herdado da sintaxe de 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. Não
uap11:SupportsMultipleInstances Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false. Um valor booliano opcional. Não
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. Não
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 *. > Não
uap11:Parameters Esse atributo é herdado da sintaxe de 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. Não
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="clássico" requer a funcionalidade 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ó 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 de Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: de computador ou usuário. Não

Elementos filho

Elemento filho Descrição
de Certificados Declara um ponto de extensibilidade de pacote do tipo windows.certificates. O aplicativo requer um ou mais certificados dos repositórios de certificados especificados.
InProcessServer Declara um ponto de extensibilidade de pacote do tipo windows.activatableClass.inProcessServer. O aplicativo usa uma biblioteca de vínculos dinâmicos (.dll) que expõe uma ou mais classes ativadas.
OutOfProcessServer Declara um ponto de extensão de pacote do tipo windows.activatableClass.outOfProcessServer. O aplicativo usa um executável (.exe) que expõe uma ou mais classes ativas.
ProxyStub Declara um ponto de extensibilidade de pacote do tipo windows.activatableClass.proxyStub. Um proxy pode ser composto por uma ou mais interfaces.
PublisherCacheFolders Declara um ponto de extensibilidade de pacote do tipo windows.publisherCacheFolders. Isso especifica uma ou mais pastas que o pacote compartilha com outros pacotes do mesmo editor.
com:ComInterface Declara um ponto de extensão de pacote do tipo windows.comInterface.
uap6:LoaderSearchPathOverride Declara um ponto de extensão de pacote do tipo windows.loaderSearchPathOverride.

Elementos pai

Elemento pai Descrição
extensões de (tipo: CT_PackageExtensions) Define um ou mais pontos de extensibilidade para o pacote.

Os seguintes elementos têm o mesmo nome que este, mas conteúdo ou atributos diferentes:

  • de Extensão (global)

Observações

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 onde um aplicativo pode se registrar para executar o código ou usar recursos do pacote atual. Para adicionar funcionalidade para um aplicativo específico, use o elemento filho Application do elemento aplicativos .

O windows.certificates ponto de extensibilidade não pode ser declarado várias vezes em um manifesto.

Consulte também

Requisitos

Item Valor
namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10
com http://schemas.microsoft.com/appx/manifest/com/windows10
uap6 http://schemas.microsoft.com/appx/manifest/uap/windows10/10