Identidade (esquema de extensões para Windows 8.1)
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:
|
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 |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de