Aplicativo (esquema de pacote para Windows 8)

  • Artigo

Representa um aplicativo que compõe parte ou toda a funcionalidade fornecida no pacote.

Hierarquia de elementos

<Agrupa>
<Aplicativos>
<Aplicativo>

Syntax

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             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.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Chave

? opcional (zero ou um)

& conector de intercalação (pode ocorrer em qualquer ordem)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
EntryPoint

A ID da classe ativátable, como "" Office. Winword. class ".

Para aplicativos da área de trabalho, esse valor deve ser o ponto de entrada real do executável, como "Main", "WinMain" ou "wWinMain".

Se você especificar esse atributo, também deverá especificar o atributo executável . Se você especificar esse atributo, não deverá especificar o atributo Startpage .

 Uma cadeia de caracteres 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 em seu lugar. Não
Executável

O executável de inicialização padrão para o aplicativo. Esse arquivo deve estar presente no pacote.

Se você especificar esse atributo, deverá especificar o atributo EntryPoint . Se você especificar esse atributo, não deverá especificar o atributo Startpage .

 Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento que deve terminar com ".exe" e não pode conter estes 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 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
Id

O identificador exclusivo do aplicativo no pacote. Às vezes, esse valor é denominado PRAID (identificador do aplicativo relativo do pacote).

A ID é exclusiva no pacote, mas não globalmente. Pode haver outro pacote no sistema que usa a mesma ID. A mesma ID não pode ser usada mais de uma vez no mesmo pacote.

Essa cadeia de caracteres contém campos alfanuméricos separados por pontos. Cada campo precisa começar com um caractere alfabético ASCII. Você não pode usá-los como valores de campo: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" e "LPT9".

ao usar um modelo de Visual Studio, o valor padrão desse atributo é "aplicativo". Os desenvolvedores devem alterar isso manualmente no manifesto.

o identificador do aplicativo não deve ser alterado depois que o aplicativo tiver sido publicado no Microsoft Store; isso irá interromper a posição do bloco na tela inicial.

 Uma cadeia de caracteres ASCII entre 1 e 64 caracteres de comprimento. Sim
StartPage

A página HTML de inicialização padrão para o aplicativo. Esse arquivo deve estar presente no pacote.

Se você especificar esse atributo, não poderá especificar o atributo EntryPoint ou o atributo executável .

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

 

Elementos filho

Elemento filho Descrição
ApplicationContentUriRules

Especifica quais páginas no contexto da Web têm acesso aos dispositivos de geolocalização do sistema (se o aplicativo tiver permissão para acessar esse recurso) e o acesso à área de transferência.
Extensões (tipo: CT_ApplicationExtensions)

Define um ou mais pontos de extensibilidade para o aplicativo.
VisualElements

Descreve os aspectos visuais do aplicativo UWP: seu bloco padrão, imagens de logotipo, cores de texto e de plano de fundo, a orientação inicial da tela, a tela inicial e a aparência do bloco da tela de bloqueio.

 

Elementos pai

Elemento pai Descrição
Aplicativos

Representa um ou mais aplicativos que compõem o pacote.

 

Comentários

O elemento Application contém atributos que são comuns aos pontos de extensibilidade que pertencem ao aplicativo. Essas informações são usadas por outros pontos de extensibilidade para obter informações sobre o aplicativo. Além disso, os atributos de aplicativo são usados no início e no gerenciamento de uma instância do aplicativo.

se o atributo StartPage for especificado, ele será um aplicativo Windows usando JavaScript. Se Startpage não for especificado, os atributos Executable e EntryPoint deverão ser especificados, e ele será um aplicativo UWP usando C# ou VB e XAML.

Exemplos

O exemplo a seguir é extraído 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>

Requisitos

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