每个 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。若未指定此属性,则调用将路由至默认任务。 |