Package (Windows 10)
Defines the root element of an app package manifest. The manifest describes the structure and capabilities of the software to the system.
Element hierarchy
<Package>
Syntax
<Package
IgnorableNamespaces = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >
<!-- Child elements -->
Identity
& mp:PhoneIdentity?
& Properties
& Resources
& Dependencies
& Capabilities?
& Extensions?
& Applications?
& uap15:Capabilities?
</Package>
Key
?
optional (zero or one)
&
interleave connector (may occur in any order)
Attributes and elements
Attributes
Attribute | Description | Data type | Required | Default value |
---|---|---|---|---|
IgnorableNamespaces | Declares namespaces used in the manifest that should be ignored. Ignored namespace elements are not validated and should be considered untrusted. Multiple namespaces are specified with a space between each namespace. | A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. | No |
Child elements
Child element | Description |
---|---|
Applications | Represents one or more apps that comprise the package. |
Capabilities | Declares the access to protected user resources that the package requires. |
Dependencies | Declares other packages that a package depends on to complete its software. |
Extensions (type: CT_PackageExtensions) | Defines one or more extensibility points for the package. |
Identity | Defines a globally unique identifier for a package. A package identity is represented as a tuple of attributes of the package. |
Properties | Defines additional metadata about the package including attributes that describe how the package appears to users. |
Resources | Declares languages for the resources that the package contains. Every package must declare at least one language for resources. The scale and DirectX feature level attributes are common for all resources in the package. |
mp:PhoneIdentity | If your app is an update to an app previously made available on Windows Phone, ensure that this element matches what is in the app manifest of your previous app. Use the same GUIDs that were assigned to the app by the Store. This ensures that users of your app who are upgrading to Windows 10 will receive your new app as an update, and not as a duplicate. |
uap15:Capabilities | Declares the access to protected user resources that the package requires. This element can be used by non-main packages. This element can only be used by framework packages. |
Note
You may get an error if the manifest elements DisplayName or Description contain characters disallowed by the Windows firewall; namely |
and all
, due to which Windows fails to create the AppContainer profile for the package. Use this reference for troubleshooting if you get an error.
Parent elements
This is the outermost element in a document. It cannot be contained by any other element.
Requirements
Item | Value |
---|---|
Namespace | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |