Aplicativos para Windows 8.1 da Windows Store: conteúdo do manifesto de pacote

Artigo
05/29/2017

Aplica-se a Windows e Windows Phone

Quando você compila um projeto de aplicativo, o Visual Studio gera um manifesto de pacote que contém informações obrigatórias para registrar o aplicativo com o Store. Este tópico descreve o conteúdo do pacote.

Dica

Se essas seções não mencionarem o campo que você está procurando, ele terá sido gerado a partir de dados configurados separadamente ou de um valor padrão do esquema de manifesto.

Identidade

A seção Identity do manifesto de aplicativo contém os campos a seguir.

Campo	Descrição
`Name`	O nome do pacote, preenchido de maneira diferente nos seguintes cenários: -Por padrão, o valor desse campo é um GUID gerado. -Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e, em seguida, entre com uma conta de desenvolvedor, o valor desse campo é recuperado do aplicativo associado no Store. -Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor da Microsoft, o valor do campo será removido do manifesto de origem.
`ProcessorArchitecture`	Um valor gerado com base na configuração de build especificada para o projeto. A tabela a seguir resume o mapeamento entre os valores Plataforma no Gerenciador de Configurações e o valor inserido no manifesto de aplicativo: x86 ou Win32: x86 x64: x64 Qualquer CPU: neutro ARM: ARM Se as referências do projeto ou do arquivo no projeto se destinarem a uma arquitetura específica diferente (ou seja, não é um componente Neutro) da arquitetura do pacote do aplicativo, um erro de build será lançado, e você deverá alterar a arquitetura de destino do pacote do aplicativo para que ela funcione para todas as referências.
`Publisher`	O nome do editor. O nome é preenchido de maneira diferente nos seguintes cenários: -Por padrão, o valor desse campo é o nome de usuário. -Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e, em seguida, entre com sua conta de desenvolvedor, o valor desse campo é a cadeia de caracteres do Editor associada a essa conta. -Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor, o valor desse campo corresponda ao campo de assunto do certificado de teste com o qual você assinou o pacote de aplicativo. Para obter mais informações, consulte gerenciar os certificados que o Visual Studio usa para assinar seu aplicativo Observação: Visual Studio oferece suporte apenas à forma comum de nome (CN) para o publicador e adicionará o prefixo CN = ao nome no manifesto.

Aqui está um exemplo do XML de saída:

<Identity  
    Name="Microsoft.CoolWindowsStoreApp"  
ProcessorArchitecture="x86"  
Publisher="CN=Microsoft Corporation"  
/>

Propriedades

A seção Propriedades do manifesto de aplicativo contém os campos na tabela a seguir.

Campo Descrição

PublisherDisplayName A cadeia de caracteres é preenchida de maneira diferente nos seguintes cenários:

-Por padrão, o valor desse campo é o nome de usuário.

-Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e entrar usando uma conta de desenvolvedor, o valor do campo corresponderá a cadeia de caracteres PublisherDisplayName associada à sua conta de desenvolvedor.

-Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor, o valor desse campo é o nome de usuário, a menos que você especifique o contrário.

DisplayName A cadeia de caracteres é preenchida de maneira diferente nos seguintes cenários:

-Por padrão, o valor desse campo é o nome do projeto.

-Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e entre com uma conta de desenvolvedor, o valor desse campo é preenchido de acordo com as regras a seguir:

-Se você especificar esse valor no manifesto de origem e o valor começa com @ (que indica que você deseja localizar esse valor), o valor do campo corresponderá especificado por você.

-Se o aplicativo selecionado tiver apenas um nome, o valor será esse nome.

-Se o aplicativo selecionado tiver vários nomes, mas o manifesto de origem não for localizado:

-Caso contrário, o valor é definido como o primeiro nome reservado.

-Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor, o valor desse campo é removido do manifesto de origem.

Campo	Descrição
`PublisherDisplayName`	A cadeia de caracteres é preenchida de maneira diferente nos seguintes cenários: -Por padrão, o valor desse campo é o nome de usuário. -Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e entrar usando uma conta de desenvolvedor, o valor do campo corresponderá a cadeia de caracteres PublisherDisplayName associada à sua conta de desenvolvedor. -Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor, o valor desse campo é o nome de usuário, a menos que você especifique o contrário.
`DisplayName`	A cadeia de caracteres é preenchida de maneira diferente nos seguintes cenários: -Por padrão, o valor desse campo é o nome do projeto. -Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e entre com uma conta de desenvolvedor, o valor desse campo é preenchido de acordo com as regras a seguir: -Se você especificar esse valor no manifesto de origem e o valor começa com @ (que indica que você deseja localizar esse valor), o valor do campo corresponderá especificado por você. -Se o aplicativo selecionado tiver apenas um nome, o valor será esse nome. -Se o aplicativo selecionado tiver vários nomes, mas o manifesto de origem não for localizado: -Caso contrário, o valor é definido como o primeiro nome reservado. -Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor, o valor desse campo é removido do manifesto de origem.

Aplicativo

Um manifesto de aplicativo pode conter vários < aplicativo> elementos, cada um deles tem um nome de exibição que aparece no bloco do cliente. A seção Aplicativo do manifesto de aplicativo contém os campos na tabela a seguir.

Campo	Descrição
`DisplayName`	A cadeia de caracteres é preenchida de maneira diferente nos seguintes cenários: -Por padrão, o valor desse campo é o nome do projeto. -Se você associar o aplicativo com o Store ou invocar o criar pacote do aplicativo comando e entre com uma conta de desenvolvedor, o valor desse campo é o nome do aplicativo para o aplicativo selecionado se a /Properties [@DisplayName] e/aplicativos/aplicativo [@DisplayName] na correspondência de manifesto de origem. Do contrário, o valor permanecerá o mesmo do manifesto de origem. -Se você invocar o criar pacote do aplicativo de comando, mas não entrar usando uma conta de desenvolvedor, o valor desse campo é o mesmo do manifesto de origem.
`Executable`	O valor desse campo é o nome de saída do assembly do projeto. O token executável $targetnametoken$.exe que é usado no arquivo de manifesto de origem (package.appxmanifest) é substituído pelo nome de arquivo real quando o manifesto é criado.

PackageDependencies

A seção PackageDependencies contém todas as dependências da biblioteca de componentes do Windows para esse pacote. Por exemplo, se o projeto tiver uma referência para o WinJS, o Visual Studio para irá recuperar as informações de identidade do pacote das dependências quando o manifesto for gerado. Em seguida, o Visual Studio preenche essa seção com os campos Nome e MinVersion para cada pacote dependente.

Extensões de Registro do Tempo de Execução do Windows

É possível implementar componentes do Tempo de Execução do Windows para os aplicativos, mas você deve registrar esses componentes com o sistema operacional para que sejam executados corretamente. Para registrar um componente do Tempo de Execução do Windows, você deve colocar as informações de registro nos arquivos WinMD e no manifesto de aplicativo. Se um projeto implementar um componente do Tempo de Execução do Windows, a saída de compilação do projeto conterá um arquivo WinMD. O Visual Studio extrai as informações de registro do Tempo de Execução do Windows a partir do arquivo WinMD e gera os elementos de Extensões apropriados no manifesto de aplicativo.

O sistema dá suporte a duas formas de servidores: servidores .dll (em processo) e servidores .exe (fora de processo). Esses servidores exigem informações de registro semelhantes, mas diferentes, que devem ser copiadas para o manifesto de aplicativo. O Visual Studio dá suporte à geração de manifesto apenas para servidores .dll, e a extensão DLLServer é obrigatória para registrar servidores .dll. Os seguintes valores no manifesto de aplicativo são utilizados dos arquivos WinMD para construir a Extensão DLLServer:

DllPath
ActivatableClassId
ThreadingModel
ActivatableClass (atributo ActivatableClassId)

Aqui está um exemplo do XML de saída:

<extension category=”Microsoft.Windows.ActivatableClass”>  
    <dllServer>  
        <dllPath>Fabrikam.dll</dllPath>  
        <activatableClass activatableClassId="Fabrikam.MyClass" threadingModel="sta" />  
    </dllServer>  
</extension>

Recursos

A seção Resources contém uma entrada para cada idioma compatível com o aplicativo. Você deve ter pelo menos um idioma de Recurso especificado no manifesto de aplicativo. O Visual Studio gera automaticamente a lista de idiomas compatíveis com base nas informações de localização no projeto. O token Idioma de Recurso "x-generate", que é usado no arquivo de manifesto de origem (package.appxmanifest), é substituído pelo código de idioma real quando o manifesto é criado. Aqui está um exemplo do XML de saída:

<Resources>  
<Resource Language=”en-us”>  
<Resource Language=”fr-fr”>  
</Resources>

A primeira entrada na lista é o idioma padrão para o aplicativo.

Pré-requisitos

A seção Pré-requisitos contém os seguintes valores:

OSMinVersion
OSMaxVersionTested

Ambos os elementos são preenchidos a partir de propriedades MSBuild (AppxOSMinVersion e AppxOSMaxVersionTested, respectivamente). O valor padrão para ambos os elementos é 6.3.0.

Consulte também

Empacotando aplicativos universais do Windows