Share via


uap17:Extension

Descrição

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>
<Extensões>
<uap17:Extension>

Syntax

<uap17:Extension     Category = "windows.packageExtensionHost" | "windows.packageExtension"
    desktop11:AppLifecycleBehavior = "systemManaged" | "unmanaged"
    Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.
    EntryPoint? = A string between 1 and 256 characters in length that cannot start or end with a whitespace character.
    RuntimeType? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.
    StartPage? = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.
    ResourceGroup? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
    uap10:TrustLevel? = "appContainer" | "mediumIL"
    uap10:RuntimeBehavior? = "windowsApp" | "packagedClassicApp" | "win32App"
    uap10:HostId? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
    uap10:Parameters? = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.
    uap11:Id? = A string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.
    uap11:Subsystem? = "console" | "windows"
    uap11:SupportsMultipleInstances? = Boolean.
    uap11:ResourceGroup? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
    uap11:CurrentDirectoryPath? = A string that cannot contain these characters: <, >, |, ?, or *. >
    uap11:Parameters? = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.
    desktop7:CompatMode? = "classic" | "modern"
    desktop7:Scope? = "machine" | "user"
>
<!-- Child elements -->
  PackageExtensionHost
  PackageExtension
</uap17:Extension>

Chave

? opcional (zero ou um)

Atributos

Atributo Descrição Tipo de dados Necessária
Categoria O tipo de ponto de extensibilidade do pacote. Um dos seguintes valores: "windows.packageExtensionHost", "windows.packageExtension" Yes
desktop11:AppLifecycleBehavior Permite que um aplicativo substitua o comportamento do ciclo de vida associado ao comportamento de runtime da extensão. Aplicativos ou extensões com um RuntimeBehavior de "windowsApp" implicitamente têm AppLifecycleBehavior de "systemManaged". Aplicativos ou extensões com RuntimeBehavior de "packagedClassicApp" ou "win32App" implicitamente têm AppLifecycleBehavior de "não gerenciado" Um dos seguintes valores: "systemManaged", "unmanaged". No
Executável O executável de inicialização padrão. Um dos seguintes valores: uma cadeia de caracteres entre 1 e 256 caracteres de comprimento que deve terminar com ".exe" e não pode conter esses caracteres: <, , >:, ", ,, ?, ou *. No
EntryPoint A ID da classe ativada. Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento que não pode iniciar ou terminar com um caractere de espaço em branco. No
RuntimeType O provedor de runtime. Um dos seguintes valores: uma cadeia de caracteres 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. Um dos seguintes valores: uma cadeia de caracteres 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). Uma cadeia de caracteres alfanumérica entre 1 e 255 caracteres de comprimento. Deve começar com um caractere alfabético. No
uap10:TrustLevel Especifica o nível de confiança da extensão. Um dos seguintes valores: "appContainer", "mediumIL" No
uap10:RuntimeBehavior Especifica o comportamento de runtime de uma extensão. Um dos seguintes valores: "windowsApp", "packagedClassicApp", "win32App" No
uap10:HostId Especifica a ID do runtime do host para a extensão. Uma cadeia de caracteres alfanumérica entre 1 e 255 caracteres de comprimento. Deve começar com um caractere alfabético. 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 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 entre 1 e 255 caracteres de comprimento com um caractere não em branco no início e no final. No
uap11:Subsistema Esse atributo é herdado da sintaxe da extensão base. Além da validação sintactica, esse valor é ignorado. Um dos seguintes valores: "console", "windows" No
uap11:SupportsMultipleInstances Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false. Booliano. 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. Uma cadeia de caracteres alfanumérica entre 1 e 255 caracteres de comprimento. Deve começar com um caractere alfabético. 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. Um dos seguintes valores: uma cadeia de caracteres que não pode conter esses caracteres: <, >, ,, ?, ou *. > No
uap11:Parameters Contém parâmetros de linha de comando para passar para a extensão. Só há suporte para aplicativos da área de trabalho. Esse atributo dá suporte a macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote. Uma cadeia de caracteres 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 . Um dos seguintes valores: "clássico", "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 . Um dos seguintes valores: "machine" , "user" No

Elementos filho

Elemento Descrição
PackageExtensionHost Declara um ponto de extensibilidade do aplicativo do tipo windows.appExtensionHost.
PackageExtension Declara um ponto de extensibilidade do aplicativo do tipo windows.appExtension.

Comentários

Requisitos

Prefixo Valor
uap17 http://schemas.microsoft.com/appx/manifest/uap/windows10/17
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