wp7中应用程序清单(WMAppManifest.xml)详细说明

每个 Windows Phone 应用程序都有一个包含应用程序（如 App ID）的详细信息及该应用程序所使用功能的清单文件

下面是一个 Windows Phone 应用程序的清单文件示例

<?xml version="1.0" encoding="utf-8"?>

<Deployment xmlns="http://schemas.microsoft.com/windowsphone/2009/deployment" AppPlatformVersion="7.1">

  <App xmlns="" ProductID="{GUID}" Title="[Project Name]" RuntimeType="Silverlight" Version="1.0.0.0" Genre="apps.normal"  Author="[Project Name] author" Description="Sample description" Publisher="[Project Name]">
  
    <IconPath IsRelative="true" IsResource="false">ApplicationIcon.jpg</IconPath>

    <Capabilities>
      <Capability Name="ID_CAP_APPOINTMENTS"/>
      <Capability Name="ID_CAP_CAMERA"/>
      <Capability Name="ID_CAP_CONTACTS"/>
      <Capability Name="ID_CAP_GAMERSERVICES"/>
      <Capability Name="ID_CAP_IDENTITY_DEVICE"/>
      <Capability Name="ID_CAP_IDENTITY_USER"/>
      <Capability Name="ID_CAP_ISV_CAMERA"/>
      <Capability Name="ID_CAP_LOCATION"/>
      <Capability Name="ID_CAP_MEDIALIB"/>
      <Capability Name="ID_CAP_MICROPHONE"/>
      <Capability Name="ID_CAP_NETWORKING"/>
      <Capability Name="ID_CAP_PHONEDIALER"/>
      <Capability Name="ID_CAP_PUSH_NOTIFICATION"/>
      <Capability Name="ID_CAP_SENSORS"/>
      <Capability Name="ID_CAP_WEBBROWSERCOMPONENT"/>
      <Capability Name="ID_HW_FRONTCAMERA"/>
    </Capabilities>

    <Tasks>
      <DefaultTask  Name ="_default" NavigationPage="MainPage.xaml"/>

      <ExtendedTask Name="" NavigationPage="" >
        <BackgroundServiceAgent  Name="" Source="" Specifier="" Type=""/>
      </ExtendedTask>
    </Tasks>

    <Tokens>
      <PrimaryToken TokenID="[Project Name]Token" TaskName="_default">
        <TemplateType5>
          <BackgroundImageURI IsRelative="true" IsResource="false">Background.jpg</BackgroundImageURI>
          <Count>0</Count>
          <Title>[Project Name]</Title>
        </TemplateType5>
      </PrimaryToken>
    </Tokens>

    <Extensions>
      <Extension ConsumerID="" ExtensionName="" ExtraFile="" TaskID="" />
    </Extensions>

  </App>
</Deployment>

 

DEPLOYMENT元素

DEPLOYMENT 元素不是根元素。在部署 Windows Phone 的应用程序时，此元素提供清单文件中的应用程序和本地化信息。

属性	类型	定义
xmlns	字符串	XML 命名空间。默认值为 http://schemas.microsoft.com/windowsphone/2009/deployment。
AppPlatformVersion	字符串	Windows Phone SDK 的版本或平台的运行时二进制

 

DEPLOYMENT元素

APP 元素是 DEPLOYMENT 元素的子元素。该元素提供诸如产品 ID、版本和应用程序类型等信息。下表定义了 APP 元素的属性。

属性	类型	定义
作者	字符串	应用程序作者姓名。
BitsPerPixel	Integer	每个像素上使用 16 或 32 位信息。
说明	字符串	应用程序说明。
流派	字符串	默认值为 Apps.Normal 或 Apps.Game，具体取决于项目类型。 使用 Apps.Normal 的应用程序将出现在手机的应用程序列表中。使用 Apps.Games 的应用程序将出现在手机的游戏中心中。
HasSettings	布尔值	指示应用程序是否支持设置。
HubType	Integer	允许您的应用程序出现在音乐和视频中心的附加程序部分。它用于应用程序提交前的测试，必须在清单文件中手动输入。值为 1 表示启用此功能。
IsBeta	布尔值	指明应用程序是否为 Beta 应用程序。该值会对应用程序许可证产生影响。
ProductID	GUID	默认值是项目的 GUID（128 位）。在提交应用程序期间，新产品 ID 将插入到清单文件中。
发布者	字符串	应用程序发布者。该默认值是项目名称。某些类型的应用程序（例如，启用推送的应用程序）需要此属性。
RuntimeType	字符串	默认值为 Silverlight 或 XNA，具体取决于项目类型。
SingleInstanceHost	布尔值	指明应用程序是否使用单个实例主机。
标题	字符串	出现在应用程序列表或游戏中心中的应用程序标题。默认值是项目名称。
版本	版本字符串	默认值为 1.0.0.0。
xmlns	字符串	还可以将该值留空。

 

CAPABILITY 元素

CAPABILITY 元素是 CAPABILITIES 元素的子元素。CAPABILITY 元素有一个属性，即名称。下表列出了名称属性的可能值。

值	类型	说明
ID_CAP_APPOINTMENTS	字符串	访问约会数据的应用程序。
ID_CAP_CAMERA	字符串	使用相机功能的应用程序。该值仅供移动运营商和原始设备制造者使用。应用程序开发人员使用 ID_CAP_ISV_CAMERA。
ID_CAP_CONTACTS	字符串	访问联系人数据的应用程序。
ID_CAP_GAMERSERVICES	字符串	可以与 Xbox LIVE API 交互的应用程序。由于数据与 Xbox 共享，鉴于隐私问题，必须公开此信息。
ID_CAP_IDENTITY_DEVICE	字符串	使用设备特定信息（如唯一设备 ID、制造商名称或模型名称）的应用程序。
ID_CAP_IDENTITY_USER	字符串	使用匿名 LiveID 以匿名方式唯一识别用户的应用程序。
ID_CAP_ISV_CAMERA	字符串	使用相机功能的应用程序。
ID_CAP_LOCATION	字符串	可访问本地服务的应用程序。
ID_CAP_MEDIALIB	字符串	可访问媒体库的应用程序。
ID_CAP_MICROPHONE	字符串	使用麦克风的应用程序。可以在未显示正在记录的情况下进行记录的应用程序。
ID_CAP_NETWORKING	字符串	可访问网络服务的应用程序。由于在手机漫游时服务可能会产生费用，因此必须公开此信息。
ID_CAP_PHONEDIALER	字符串	可发出电话呼叫的应用程序。此操作可在未向最终用户显示信息的情况下完成。
ID_CAP_PUSH_NOTIFICATION	字符串	可从 Internet 服务接收推送通知的应用程序。由于在使用时会产生漫游费用，因此必须公开此消息。
ID_CAP_SENSORS	字符串	使用 Windows Phone 传感器的应用程序。
ID_CAP_WEBBROWSERCOMPONENT	字符串	使用 Web 浏览器组件的应用程序。存在涉及脚本的安全风险。
ID_HW_FRONTCAMERA	字符串	使用硬件正面相机的应用程序。如果需要，您必须手动添加这一功能，此功能必须与 ID_CAP_ISV_CAMERA 功能一起使用。有关更多信息，请参阅 Windows Phone 的相机和照片概述。

TASKS 元素

属性	类型	说明
名称	字符串	任务名称。默认值为 _default。
NavigationPage	字符串	任务在启动时导航到的目标应用程序的页面。

 

 

BACKGROUNDSERVICEAGENT 元素

属性	类型	说明
名称	字符串	程序集名称。
Source	字符串	程序集源文件。
说明符	字符串	AudioPlayerAgent、AudioStreamingAgent 或 ScheduledTaskAgent。
类型	字符串	程序集入口点的完整类名。

TOKENS 元素

TOKENS 元素是 APP 元素的子元素。每个应用程序都有一个用户可固定至“开始”屏幕的磁贴。以下各节提供相关名称并在清单文件中描述磁贴的元素和属性。有关更多信息，请参阅 Windows Phone 的图块概述。http://msdn.microsoft.com/zh-cn/library/windowsphone/develop/hh202948(v=vs.92).aspx

 

TEMPLATETYPE5 元素

元素	类型	说明
BACKGROUNDIMAGEURI	字符串	包含磁贴背景图像的本地或远程资源名称。
COUNT	Integer	磁贴可以包含显示介于 0 到 99 之间的值的计数器。若值为 0，则不在磁贴中显示计数器。
标题	字符串	磁贴中出现的标题。默认值是项目名称。

 

EXTENSION 元素

属性	类型	说明
ConsumerID	GUID	利用指定的 ProductID 限制对使用者扩展名的访问。所有搜索扩展名均要求使用同一个值，5B04B775-356B-4AA0-AAF8-6491FFEA5661。
ExtensionName	字符串	扩展支持类型的标识符。
ExtraFile	字符串	指定 Extras.xml 文件的位置。文件必须位于名为 Extensions 的文件夹中，并且必须命名为 Extras.xml。
TaskID	字符串	将调用路由到指定的 TaskID。若未指定此属性，则调用将路由至默认任务。