Partilhar via

Extensão (no tipo: CT_ApplicationExtensions)

  • Artigo

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>
<Aplicativos>
<Aplicativo>
<Extensões>
<Extensão>

Syntax

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string 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 isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string 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? = 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 *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | 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 aplicativo.

Esse atributo pode ter um dos seguintes valores:

  • windows.fileTypeAssociation
  • windows.protocol
  • windows.autoPlayContent
  • windows.autoPlayDevice
  • windows.shareTarget
  • windows.search
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
 Sim
EntryPoint

A ID da classe ativatable.

 Uma cadeia de caracteres entre 1 e 256 caracteres, representando a tarefa que está tratando 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. Não
Executável

O executável de lançamento padrão.

 Uma cadeia de caracteres entre 1 e 256 caracteres que deve terminar com ".exe" e 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 especificado, a propriedade EntryPoint também será usada. Se essa propriedade EntryPoint não for especificada, o EntryPoint definido para o aplicativo será usado. Não
Runtimetype

O provedor de runtime. Esse atributo é usado normalmente quando há estruturas mistas em um aplicativo.

 Uma cadeia de caracteres entre 1 e 255 caracteres de comprimento que não pode iniciar ou terminar com um ponto ou conter estes caracteres: <, >, :, %, ", /, \, |, ?ou *. Não
StartPage

A página da Web que manipula o ponto de extensibilidade.

 Uma cadeia de caracteres entre 1 e 256 caracteres que não pode conter estes caracteres: <, >, :, %, ", |, ?ou *. Não

 

Elementos filho

Elemento filho Descrição
AutoPlayContent

Declara um ponto de extensibilidade de aplicativo do tipo windows.autoPlayContent. O aplicativo fornece as ações de conteúdo autoPlay especificadas.
AutoPlayDevice

Declara um ponto de extensibilidade de aplicativo do tipo windows.autoPlayDevice. O aplicativo fornece as ações de dispositivo AutoPlay especificadas.
BackgroundTasks

Define um ponto de extensibilidade de aplicativo do tipo windows.backgroundTasks. As tarefas em segundo plano são executadas em um host em segundo plano dedicado; ou seja, sem uma interface do usuário.
FileOpenPicker

Declara um ponto de extensibilidade de aplicativo do tipo windows.fileOpenPicker. O aplicativo permite que o usuário escolha e abra os tipos de arquivos especificados.
FileSavePicker

Declara um ponto de extensibilidade de aplicativo do tipo windows.fileSavePicker. O aplicativo permite que o usuário escolha o nome do arquivo, a extensão e o local de armazenamento para os tipos de arquivos especificados.
FileTypeAssociation

Declara um ponto de extensibilidade de aplicativo do tipo windows.fileTypeAssociation. Uma associação de tipo de arquivo indica que o aplicativo está registrado para manipular arquivos dos tipos especificados.
Protocolo

Declara um ponto de extensibilidade de aplicativo do tipo windows.protocol. Uma associação de URI indica que o aplicativo está registrado para lidar com URIs com o esquema especificado.
ShareTarget

Declara um ponto de extensão de aplicativo do tipo windows.shareTarget. O aplicativo pode compartilhar os tipos de arquivos especificados.

 

Elementos pai

Elemento pai Descrição
Extensões (tipo: CT_ApplicationExtensions)

Define um ou mais pontos de extensibilidade para o aplicativo.

 

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

Comentários

Esses pontos de extensibilidade podem ser declarados apenas uma vez por aplicativo:

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

**Observação sobre regras semânticas para extensões: **Para qualquer elemento extension, as seguintes regras semânticas são impostas na API de manifesto:

Se /Application/@StartPage especificado, ele será um aplicativo Windows usando JavaScript e a Extensão de Aplicativo :

  • Pode estar vazio
  • Pode especificar apenas a StartPage
  • Pode especificar Executable e EntryPoint (RuntimeType opcional permitido), a menos que seja uma extensão BackgroundTask, caso em que ele pode omitir o executável e o padrão para o BackgroundTaskHost.exe executável.

Se /Application/@StartPage não for especificado, ele será um aplicativo UWP usando C# ou VB e XAML e a Extensão de Aplicativo :

  • Pode estar vazio
  • Pode especificar apenas a StartPage
  • Deve especificar EntryPoint se Executável ou RuntimeType for especificado.

Exemplos

O exemplo a seguir é retirado do manifesto do pacote de um dos exemplos do SDK.

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Confira também

ConceitosAplicativas e extensões

Requisitos

Valor
Namespace http://schemas.microsoft.com/appx/2010/manifest