Application descriptor of native C# API application for Windows Phone 8

The application descriptor is a metadata file used to define various aspects of the native C# API application for Windows Phone 8.

The application-descriptor.xml file, in the application root directory, is a metadata file used to define various aspects of the application.

The following example shows the format of the application descriptor file of native C# API applications for Windows Phone 8:

<?xml version="1.0" encoding="UTF-8"?>
<nativeWindowsPhone8App 
  xmlns="http://www.worklight.com/native-windowsphone8-descriptor">
  id="WP8"
  platformVersion="6.2.0"
  version="1.0"
  <displayName>application display name</displayName>
  <description>application description</description>
  <pushSender>
    <authenticatedPush serviceName="MPNS Service name" keyAlias="certificate alias" keyAliasPassword="certificate password"/>
  </pushSender>
</nativeWindowsPhone8App>

The <nativeWindowsPhone8App> element is the root element of the descriptor. This element has three mandatory attributes:

id

This attribute specifies the identifier of the application. The identifier must be identical to the application folder name. It must be an alphanumeric string that starts with a letter. It can contain underscore ("_") characters. It must not be a reserved word in C# or JavaScript.

platformVersion

This attribute contains the version of MPF on which the app was developed.

version

This attribute specifies the version of the application. This version is a string of the form x.y, where x and y are numbers. It is visible to users who download the app from the app store or market.

<displayName>

This element contains the application name. This name is visible in the operations console and is copied to the descriptor files of various web and desktop environments.

<displayName>application display name</displayName>

<description>

This element contains the application description. This description is visible in the operations console and is copied to the descriptor files of various web and desktop environments.

<description>application description</description>

<pushSender>

This element indicates to the MobileFirst Server that the app is designed to receive push notifications. It also contains information necessary to provide to MPNS for sending authenticated push notifications.

<pushSender>

<authenticatedPush>

<authenticatedPush serviceName="MPNS Service name" keyAlias="certificate alias" keyAliasPassword="certificate password"/>

This element has three attributes:

serviceName

The common name (CN) found in the subject value of the MPNS certificate.

keyAlias

The alias used to access the keystore as specified by the following properties in worklight.properties:

• ssl.keystore.path

• ssl.keystore.type

• ssl.keystore.password

keyAliasPassword

Password for the key alias.

</nativeWindowsPhone8App>

This tag closes the content of the application descriptor file.

</nativeWindowsPhone8App>

Parent topic: Develop native C# applications for Windows Phone 8