Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Application

Applies to Windows and Windows Phone

Represents an app that comprises part of or all of the functionality delivered in the package.

Element hierarchy

<Package>
<Applications>
<Application>

Syntax

<Application Id          = An ASCII string between 1 and 64 characters in length.
             Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElementsChoice
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Key

?   optional (zero or one)
&   interleave connector (may occur in any order)

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
EntryPoint

The activatable class ID, such as ""Office.Winword.Class".

If you specify this attribute, you must also specify the Executable attribute. If you specify this attribute you must not specify the StartPage attribute.

A string between 1 and 256 characters in length, representing the handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead. No
Executable

The default launch executable for the app. This file must be present in the package.

If you specify this attribute you must specify the EntryPoint attribute. If you specify this attribute you must not specify the StartPage attribute.

A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used. If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.No
Id

The unique identifier of the application within the package. This value is sometimes referred to as the package-relative app identifier (PRAID).

The ID is unique within the package but not globally. There may be another package on the system that uses the same ID. The same ID cannot be used more than once in the same package.

This string contains alpha-numeric fields separated by periods. Each field must begin with an ASCII alphabetic character. You cannot use these as field values: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", and "LPT9".

When using a Visual Studio template, the default value of this attribute is "App". Developers should manually change this in the manifest.

The app's identifier should not be changed after the app has been published to the Windows Store; doing so will disrupt the tile's position on the Start screen.

An ASCII string between 1 and 64 characters in length.Yes
StartPage

The default launch HTML page for the app. This file must be present in the package.

If you specify this attribute, you cannot specify either the EntryPoint attribute or the Executable attribute.

A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.No

 

Child Elements

Child ElementDescription
ApplicationContentUriRules

Specifies which pages in the web context have access to the system's geolocation devices (if the app has permission to access this capability) and access to the clipboard.

Extensions (type: CT_ApplicationExtensions)

Defines one or more extensibility points for the app.

VisualElementsChoice

The abstract visual elements choice element for the XSD substitution group. This can't be declared in the XML.

 

Parent Elements

Parent ElementDescription
Applications

Represents one or more apps that comprise the package.

 

Remarks

The Application element contains attributes that are common to the extensibility points that pertain to the app. This information is used by other extensibility points to get information about the app. Also, Application attributes are used in the start and management of an instance of the app.

If the StartPage attribute is specified, it is a Windows Store app using JavaScript. If StartPage is not specified, then both the Executable and EntryPoint attributes must be specified, and it is a Windows Store app using C# or VB and XAML.

Requirements

Namespace

http://schemas.microsoft.com/appx/2010/manifest

 

 

Show:
© 2014 Microsoft