Identity (Windows 10)
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 |
---|---|---|---|
Name | Describes the contents of the package. The Name attribute is case-sensitive. Use the DisplayName 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:
|
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
Value | |
---|---|
Namespace | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |
Feedback
Submit and view feedback for