Edit

Capabilities

Declares the access to protected user resources that the package requires.

Element hierarchy

<Package>
   └─ <Capabilities>

Syntax

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10">
  ...
  <Capabilities>

    <!-- Child elements -->
    CapabilityChoice{0,100}
    CustomCapabilityChoice{0,1000}
    DeviceCapability{0,1000}

  </Capabilities>
</Package>

Key

{} specific range of occurrences

Attributes

None.

Child elements

Child element Description
DeviceCapability Declares a device capability required by a package. On Windows 10.0.10240.0, can contain up to 100 Device elements. On Windows 10.0.10586.0, can contain up to 1000 (for syntax and examples, see Examples).

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.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10
Minimum OS Version

Remarks

If you don't explicitly declare the capabilities required for your app to access user resources, your app can't access that resource. However, even if you declare a capability, your app still won't have access to the user resource if it doesn't exist on the system or there are other security policies in place that limit access to the resource.

Examples

Here's an example of the Capabilities node.

<Capabilities>
    <Capability Name="internetClient"/>
    <Capability Name="internetClientServer"/>
    <Capability Name="privateNetworkClientServer"/>
    <Capability Name="allJoyn"/>
    <uap:Capability Name="documentsLibrary"/>
    <uap:Capability Name="picturesLibrary"/>
    <uap:Capability Name="videosLibrary"/>
    <uap:Capability Name="musicLibrary"/>
    <uap:Capability Name="enterpriseAuthentication"/>
    <uap:Capability Name="sharedUserCertificates"/>
    <uap:Capability Name="userAccountInformation"/>
    <uap:Capability Name="removableStorage"/>
    <uap:Capability Name="appointments"/>
    <uap:Capability Name="contacts"/>
    <uap:Capability Name="phoneCall"/>
    <uap:Capability Name="blockedChatMessages"/>
    <uap:Capability Name="objects3D"/>
</Capabilities>

See also

App capability declarations