Identity (Windows 10)

  • 3 minutes to read
  • Contributors
    • Lauren Hughes
    • Mike Jacobs
    • Mark LeBLanc
    • Michael Satran

Defines a globally unique identifier for a package. A package identity is represented as a tuple of attributes of the package.

Element hierarchy

<Package>
<Identity>

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" | "arm64" | "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" where Major cannot be "0". 
          ResourceId?            = An ASCII string between 1 and 30 characters in length. />

Key

?   optional (zero or one)

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
Name

Describes the contents of the package. The Name attribute is case-sensitive.

Use the [DisplayName](https://msdn.microsoft.com/library/windows/apps/br211432) attribute to display a package name to users.

This string cannot end with a period and cannot be one of these strings: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", and "LPT9".

 A string between 3 and 50 characters in length that consists of alpha-numeric, period, and dash characters. Yes
ProcessorArchitecture

Describes the architecture of the code contained in the package. A package that includes executable code must include this attribute. Defaults to "neutral".

This attribute can have one of the following values:

  • x86
  • x64
  • arm
  • arm64
  • neutral
 No
Publisher

Describes the publisher information. The Publisher attribute must match the publisher subject information of the certificate used to sign a package. For more information see Packaging apps .

 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. Yes
ResourceId

Describes the type of UI resources contained in the package. The ResourceId is a publisher-specified string.

This string cannot end with a period and cannot be one of these strings: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", and "LPT9".

 An ASCII string between 1 and 30 characters in length. No
Version

The version number of the package.

 A version string in quad notation, "Major.Minor.Build.Revision" where Major cannot be "0". Yes

 

Child Elements

None.

Parent Elements

Parent Element Description
Package

Defines the root element of an app package manifest. The manifest describes the structure and capabilities of the software to the system.

Example

This example is from the app manifest file of the App package information sample on GitHub.

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

 

Requirements

Namespace

http://schemas.microsoft.com/appx/manifest/foundation/windows10