Partilhar via

Identidade (esquema de extensões para Windows 8.1)

  • Artigo

Define um identificador global exclusivo para um pacote. Uma identidade de pacote é representada como uma tupla de atributos do pacote.

Hierarquia de elementos

<Pacote>
<Identidade>

Syntax

<Identity Name                   = A string between 3 and 50 characters in length that consists of alpha-numeric, period, and dash characters.
          ProcessorArchitecture? = "x86" | "x64" | "arm" | "neutral"
          Publisher              = A string between 1 and 8192 characters in length that fits the regular expression  of a distinguished name : "(CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")(, ((CN|L|O|OU|E|C|S|STREET|T|G|I|SN|DC|SERIALNUMBER|Description|PostalCode|POBox|Phone|X21Address|dnQualifier|(OID\.(0|[1-9][0-9]*)(\.(0|[1-9][0-9]*))+))=(([^,+="<>#;])+|".*")))*". Further, semantic validation ensures that the string is compliant with CertNameToStr Windows API implementation of X.500 rules.

          Version                = A version string in quad notation, "Major.Minor.Build.Revision".
          ResourceId?            = A string between 1 and 30 characters in length that consists of alpha-numeric, period, and dash characters. />

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

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

Descreve o conteúdo do pacote. O atributo Name não faz maiúsculas de minúsculas.

Use o [DisplayName](.. Atributo /appxmanifestschema/element-displayname.md) para exibir um nome de pacote aos usuários.

Essa cadeia de caracteres não pode terminar com um ponto e não pode ser uma dessas cadeias de caracteres: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" e "LPT9".

 Uma cadeia de caracteres entre 3 e 50 caracteres de comprimento que consiste em caracteres alfanuméricos, de ponto e de traço. Sim
Processorarchitecture

Descreve a arquitetura do código contido no pacote. Um pacote que inclui código executável deve incluir esse atributo.

Esse atributo pode ter um dos seguintes valores:

  • x86
  • x64
  • arm
  • neutro
 Não
Publisher

Descreve as informações do editor. O Publisher atributo deve corresponder às informações de assunto do editor do certificado usado para assinar um pacote. Para obter mais informações, consulte Empacotando aplicativos .

 Uma cadeia de caracteres entre 1 e 8192 caracteres que se ajusta à expressão regular de um nome diferenciado: "(CN| L|O| UO| E| C|S| STREET| T| G| I|SN| DC|SERIALNUMBER| Descrição| PostalCode| POBox| Telefone| X21Address|dnQualifier| (OID\. (0| [1-9] [0-9]*)(\.( 0| [1-9] [0-9]*))+))=(([^,+="<>#;]) +|". *")(, ((CN| L|O| UO| E| C|S| STREET| T| G| I|SN| DC|SERIALNUMBER| Descrição| PostalCode| POBox| Telefone| X21Address|dnQualifier| (OID\. (0| [1-9] [0-9]*)(\.( 0| [1-9] [0-9]*))+))=(([^,+="<>#;]) +|". *")))*". Além disso, a validação semântica garante que a cadeia de caracteres seja compatível com CertNameToStr Windows api de regras X.500. Sim
ResourceId

Descreve o tipo de recursos de interface do usuário contidos no pacote. O ResourceId é uma cadeia de caracteres especificada pelo editor.

Essa cadeia de caracteres não pode terminar com um ponto e não pode ser uma dessas cadeias de caracteres: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" e "LPT9".

 Uma cadeia de caracteres entre 1 e 30 caracteres de comprimento que consiste em caracteres alfanuméricos, de ponto e de traço. Não
Versão

O número de versão do pacote.

 Uma cadeia de caracteres de versão na notação quad, "Major.Minor.Build.Revision". Sim

 

Elementos filho

Nenhum.

Elementos pai

Elemento pai Descrição
Pacote

Define o elemento raiz de um manifesto do pacote de aplicativos. O manifesto descreve a estrutura e os recursos do software para o sistema.

 

Comentários

O atributo Name é usado pelo sistema operacional e pelos desenvolvedores para identificar pacotes. O atributo Name não se destina a ser exibido aos usuários finais.

Quando um aplicativo é baseado em pacotes de recursos diferentes, o atributo ResourceId deve ser exclusivo na conta de usuário para um determinado nome de pacote. Variantes de pacote principais baseadas em IDs de recurso não têm permissão para serem instaladas simultaneamente. No entanto, várias variantes simultâneas de um pacote somente recurso são permitidas. Exemplos de possíveis atributos ResoureId incluem:

  • América do Norte
  • Ásia
  • Idiomas europeus

O Publisher atributo é validado em relação ao nome da assunto do certificado de assinatura quando pacotes assinados são abertos. Se o Publisher atributo não corresponder exatamente ao nome da assunto, o pacote será inválido. Você pode construir várias representações de cadeia de caracteres semanticamente equivalentes do nome da assunto armazenado no certificado. Use estas regras de canonicalização para corresponder o valor Publisher atributo com esse nome de assunto:

  • Os valores Unicode podem ser codificados em UTF-8.

  • Se o nome contiver o componente de email herdado, o IDN (Nome de Domínio Internacionalizado) será representado no formato Unicode.

  • Os OIDs (identificadores de objeto) com nomes de chave X.500 devem usar o nome da chave X.500 (por exemplo, CN, não 2.5.4.3).

  • Os OIDs sem nomes de chave X.500 são identificados com o prefixo "OID". (por exemplo, OID.2.5.4.34).

  • Os nomes de chave OID são separados de seus valores por um sinal de igual sem espaços extras (por exemplo, CN=JohnSmith).

  • Várias entradas RDN ( nome diferenciado relativo) são separadas por uma vírgula seguida por um espaço (por exemplo, CN=JohnSmith, O=Contoso).

  • O valor RDN terá aspas em torno dele somente se contiver espaço em branco à frente ou à parte final ou um dos seguintes caracteres (por exemplo, CN=" JohnSmith", O="C++ Inc."):

    • Vírgula (,)
    • Sinal de adição (+)
    • Sinal de igual (=)
    • Marca de polegada (")
    • Faixa invertida seguida pela letra n (\n)
    • Sinal menor que (<)
    • Sinal maior que (>)
    • Sinal de número (#)
    • Ponto-e-vírgula (;)

  • O caractere de aspas é uma marca de polegada ("). Se o valor RDN contiver uma marca de polegada, a marca de polegada deverá ter aspas duplas ("") além de estar entre aspas (por exemplo, CN="Paulo ""Bill"" Smith").

  • RDN com vários valores não são permitidos (por exemplo, CN=JohnSmith + O=Contoso).

Essas regras seguem o comportamento da função CertNameToStr, que pode ser usada para determinar o valor Publisher atributo esperado de um certificado.

Exemplos

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

<Identity Name="Microsoft.SDKSamples.ApplicationDataSample" 
          Version="1.0.0.0" 
          Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" />

Requisitos

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