导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

Windows Phone 8 的应用清单文件

2014/6/18

每个 Windows Phone 应用都有一个包含应用详细信息(如应用 ID)及该应用所使用功能的清单文件。本主题定义了应用清单文件中的元素、标记和特性。清单文件名为 WMAppManifest.xml。该文件位于您的项目“属性”文件夹的 Visual Studio“解决方案资源管理器”窗口中,或者您也可以使用 Windows 资源管理器找到它。

说明注意:

除了以下各节中所述的一些特性值差异外,Windows Phone 应用和 XNA Framework 应用的清单文件相同。修改清单文件时,您应该确保保持元素的正确顺序,否则应用可能会无法进行编译。

清单文件的主要用途如下:

  • 当您将应用提交到 Windows Phone 应用商店 时,清单文件中的信息将用于认证过程,以在 商店 中正确筛选您的应用,并在设备上部署和运行这些应用。

  • 清单文件中的信息在应用数据库中存储为元数据。

本主题包括以下部分。

应用清单文件在 Visual Studio 中生成,通常情况下,您不应手动编辑该文件。大多数情况下,应该使用清单编辑器工具修改清单文件。有关清单编辑器的更多信息,请参见如何修改 Windows Phone 8 的应用清单文件

例如,当您确定应用使用的功能时,您应该使用清单编辑器修改清单。您必须在清单文件中标记正确的功能值。有关详细信息,请参见如何确定 Windows Phone 8 应用功能

有一些要求您直接编辑清单文件的元素,例如扩展部分。有关如何执行此操作的更多信息,请参见如何修改 Windows Phone 8 的应用清单文件

在您将应用提交到 商店 之后,清单文件中的某些值将自动更新。示例包含 Author、Publisher 和 ProductID 特性。

警告说明警告:

一旦修改了应用清单文件,可能会导致您的应用变得不稳定或无法使用。

下面是一个 Windows Phone 8 应用的默认清单文件示例。

突出显示的项目是 Windows Phone 8 中新增或已更改的元素和属性。有关升级应用时对应用清单文件所作更改的详细信息,请参见如何将应用项目升级到 Windows Phone 8

警告说明警告:

在以下 XML 示例中,已添加换行符以提高可读性。如果您手动修改应用清单文件,请勿添加换行符或额外的空白。

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

<Deployment
   xmlns="http://schemas.microsoft.com/windowsphone/2012/deployment"
   AppPlatformVersion="8.0">
  <DefaultLanguage
     xmlns=""
     code="en-US"/>
  <App
     xmlns=""
     ProductID="{31a2f61a-4083-4250-9c0a-2d68740285b3}"
     Title="NewPhoneAppWP8"
     RuntimeType="Silverlight"
     Version="1.0.0.0"
     Genre="apps.normal"
     Author="NewPhoneAppWP8 author"
     Description="Sample description"
     Publisher="NewPhoneAppWP8"
     PublisherID="{73c86a8f-20c1-4e53-a01e-bfc5aee75273}">
    <IconPath
       IsRelative="true"
       IsResource="false">
         Assets\ApplicationIcon.png
    </IconPath>
    <Capabilities>
      <Capability Name="ID_CAP_NETWORKING"/>
      <Capability Name="ID_CAP_MEDIALIB_AUDIO"/>
      <Capability Name="ID_CAP_MEDIALIB_PLAYBACK"/>
      <Capability Name="ID_CAP_SENSORS"/>
      <Capability Name="ID_CAP_WEBBROWSERCOMPONENT"/>
    </Capabilities>
    <Tasks>
      <DefaultTask
         Name ="_default"
         NavigationPage="MainPage.xaml"/>
    </Tasks>
    <Tokens>
      <PrimaryToken
           TokenID="NewPhoneAppWP8Token"
           TaskName="_default">
        <TemplateFlip>
          <SmallImageURI
             IsRelative="true"
             IsResource="false">
               Assets\Tiles\FlipCycleTileSmall.png
          </SmallImageURI>
          <Count>0</Count>
          <BackgroundImageURI
             IsRelative="true"
             IsResource="false">
               Assets\Tiles\FlipCycleTileMedium.png
          </BackgroundImageURI>
          <Title>NewPhoneAppWP8</Title>
          <BackContent></BackContent>
          <BackBackgroundImageURI></BackBackgroundImageURI>
          <BackTitle></BackTitle>
          <DeviceLockImageURI></DeviceLockImageURI>
          <HasLarge></HasLarge>
        </TemplateFlip>
      </PrimaryToken>
    </Tokens>
    <ScreenResolutions>
      <ScreenResolution Name="ID_RESOLUTION_WVGA"/>
      <ScreenResolution Name="ID_RESOLUTION_WXGA"/>
      <ScreenResolution Name="ID_RESOLUTION_HD720P"/>
    </ScreenResolutions>
  </App>
</Deployment>
说明注意:

上面示例中的 Capabilities 列表可能无法与应用清单文件中的列表匹配。有关详细信息,请参见本主题后面的“Capabilities 元素”部分。

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

属性

类型

定义

xmlns

字符串

XML 命名空间。对于 Windows Phone 8,默认值为 http://schemas.microsoft.com/windowsphone/2012/deployment;而对于 Windows Phone OS 7.1,默认值为 http://schemas.microsoft.com/windowsphone/2009/deployment

AppPlatformVersion

字符串

Windows Phone SDK 的版本或平台的运行时二进制文件。对于 Windows Phone 8,默认值为 8.0;而对于 Windows Phone OS 7.1,默认值为 7.1

DefaultLanguage 和 Languages 元素识别应用所支持的语言。您在这些元素中指定的语言与您的应用在 Windows Phone 应用商店 中列出。

DefaultLanguage 元素是必需的。如果您指定的是 商店 不支持的语言,那么提交应用时会被拒绝。

应用清单文件中的 DefaultLanguage 元素对应于您在项目设计器的“应用程序”页面上的“程序集信息”对话框中指定的“非特定语言”设置。当您关闭“程序集信息”对话框时,对“非特定语言”的设置或更改将更新 DefaultLanguage 的值。但是,此同步只是单向的,而且如果您之后手动更改 DefaultLanguage 的值,则不会执行此同步。

如果您的应用的非特定语言在 商店 中不受支持,则指定您的应用支持的另一种语言作为 DefaultLanguage 的值。

Languages 元素是可选的。在清单设计器的“打包”页面上,该元素被标为“支持的语言”。如果您指定的是 商店 目前不支持的语言,那么提交应用时会被忽略。

应用清单文件中的 Languages 元素对应于项目设计器的“应用程序”页面上的“支持的区域性”列表。

  • 当您保存项目属性时,将项目添加到项目属性中的“支持的区域性”列表将更新应用清单文件中的“语言”列表。但是,此同步只是单向的,而且如果您之后直接在应用清单文件中更改“语言”列表,则不会执行此同步。请在发布您的应用之前确保这两个列表都包含相同的项目。

  • 从项目属性的“支持的区域性”列表中删除项目不会从应用清单文件的“语言”列表中删除它们。请从应用清单文件的“语言”列表中手动删除相同的项目。

有关更多信息,请参见 Windows Phone 8 的全球化和本地化

DefaultLanguage 和 Languages 元素均具有以下特性:

属性

类型

定义

xmlns

字符串

XML 命名空间。对于 Windows Phone 8,默认值为 http://schemas.microsoft.com/windowsphone/2012/deployment;而对于 Windows Phone OS 7.1,默认值为 http://schemas.microsoft.com/windowsphone/2009/deployment

代码

字符串

特定语言的代码。例如,英语用 en,斯洛伐克语(斯洛伐克)用 sk-SK

AppExtra 元素是面向 Windows Phone 7.8 的应用的 Deployment 元素的一个可选子元素。AppExtra 元素具有以下语法。

<AppExtra xmlns="" AppPlatformVersion="8.0">
    <Extra Name="Tiles"/>
</AppExtra>

下表定义了 App 元素的特性。

属性

类型

定义

xmlns

字符串

空白。

AppPlatformVersion

字符串

始终为 8.0。

Extra 元素

Extra 元素是 AppExtra 元素的子元素。Extra 元素有一个特性,即名称。名称指定您想要为应用启用的额外功能。“名称”的唯一值是磁贴。有关详细信息,请参见将 Windows Phone 8 和 Windows Phone 7.8 磁贴功能添加到 Windows Phone OS 7.1 应用

APP 元素是 Deployment 元素的子元素。它提供诸如产品 ID、版本和应用类型等信息。下表定义了 App 元素的特性。

属性

类型

定义

Author

字符串

应用作者的姓名。

BitsPerPixel

Integer

每个像素上使用 16 或 32 位信息。

描述

字符串

有关此应用的描述。

Genre

字符串

默认值为 Apps.NormalApps.Games,具体取决于项目类型。

使用 Apps.Normal 的应用将出现在手机的应用列表中。使用 Apps.Games 的应用将出现在手机的游戏中心中。

HasSettings

Boolean

指示应用是否支持设置。

HubType

Integer

允许您的应用出现在音乐和视频中心的附加程序部分。它用于应用提交前的测试,必须在清单文件中手动输入。值为 1 表示启用此功能。

IsBeta

Boolean

指明应用是否为 Beta 应用。该值会对应用许可证产生影响。

ProductID

GUID

默认值是项目的 GUID(128 位)。在提交应用期间,新产品 ID 将插入到清单文件中。

发布者

字符串

有关此发行者的描述。该默认值是项目名称。某些类型的应用(例如,启用推送的应用)需要此特性。

RuntimeType

字符串

对于 Windows Phone 8 应用,默认值为 SilverlightModern Native,对于 Windows Phone OS 7.1 应用,默认值为 SilverlightXNA,具体取决于项目类型。

SingleInstanceHost

Boolean

指明应用是否使用单个实例主机。

标题

字符串

出现在应用列表或游戏中心中的应用标题。默认值是项目名称。

版本

版本字符串

默认值为 1.0.0.0

xmlns

字符串

还可以将该值留空。

IconPath 元素是 App 元素的子元素。该元素提供应用列表中可见的应用图标的位置。在具有 Windows Phone 8 Update 3 的设备上,应用图标还显示在任务切换器中。该特性仅供内部使用。

应用的默认图像为 ApplicationIcon.png。XNA Framework 游戏的默认图像为 PhoneGameThumb.png。

Capabilities 元素是 App 元素的子元素。Windows Phone 提供了一个由功能驱动的安全模型,在该模型中用户必须选择应用中的特定功能。例如,使用基于网络的服务,其中用户在使用应用中未公开的服务或使用推送通知时都会产生额外的漫游费用。该功能模型的主要目标如下:

  • 确保正确公开信息 - 当应用的功能会带来安全风险时,必须通知用户。他们必须进行选择才能允许激活功能。

  • 减少攻击面 - 功能用来创建可在其中执行应用的安全空间。此空间一旦在安装时创建,往后就一直供应用使用。

当您在开发应用时,您可以成功地在 Windows Phone 模拟器 中部署和运行您的应用,而无需指定正确的功能,但在将应用部署到手机时,您必须指定正确的功能。如果您未在需要时使用功能,应用将引发 UnauthorizedAccessException 异常。当您尝试在应用中使用该功能时,将显示 Access denied 消息,并且如果未处理该异常,将意外退出。您可以使用 Windows Phone 应用商店测试工具包 确定应用使用哪些功能,并使用清单编辑器标记应用使用的功能。有关更多信息,请参见如何确定 Windows Phone 8 应用功能如何修改 Windows Phone 8 的应用清单文件

Capability 元素

Capability 元素是 Capabilities 元素的子元素。Capability 元素有一个特性,即名称。名称指定您想要为应用启用的功能。有关您可以为名称属性指定的功能值的详细信息,请参见 Windows Phone 8 应用功能和硬件要求

Tasks 元素是 App 元素的子元素。此元素仅在内部使用。

DefaultTask 元素

DefaultTask 元素由 Visual Studio 在开发过程中定义。

属性

类型

描述

名称

字符串

任务名称。默认值为 _default

NavigationPage

字符串

任务在启动时导航到的目标应用的页面。

ImagePath

以 .exe 后缀结束的字符串

应用可执行文件的名称。

可选项。

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

ImageParams

字符串

图像参数。

可选项。

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

BackgroundExecution

字符串

只有位置跟踪是有效值。

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

ExtendedTasks 元素

ExtendedTasks 元素是 Tasks 元素的子元素,它包含 BackgroundServiceAgent 元素。此元素定义一个应用使用多个任务。开发人员命名的扩展任务。目前,您只能使用 ExtendedTasks 元素来定义后台任务。

属性

类型

描述

名称

字符串

任务名称。

NavigationPage

字符串

任务在启动时导航到的目标应用的页面。

BackgroundServiceAgent 元素

BackgroundServiceAgent 元素是 ExtendedTasks 元素的子元素,它包含应用所使用的后台服务代理的详细信息。

属性

类型

描述

名称

字符串

程序集名称。

Source

字符串

程序集源文件。

说明符

字符串

AudioPlayerAgent、AudioStreamingAgent 或 ScheduledTaskAgent。

类型

字符串

程序集入口点的完整类名。

Tokens 元素是 App 元素的子元素。每个应用都有一个用户可固定至“开始”屏幕的磁贴。以下各节提供相关名称并在清单文件中描述磁贴的元素和特性。有关更多信息,请参见 Windows Phone 8 的磁贴

PrimaryToken 元素

PrimaryToken 元素是 Tokens 元素的子元素。它描述与应用相关的磁贴。

属性

类型

描述

TokenID

字符串

磁贴名称。默认值为项目名称。

警告说明警告:
如果更改主要标记的 TokenID,则其不应与任何一个次要磁贴的 TokenID 匹配。如果出现那种情况,用户可能无法安装应用更新。

TaskName

字符串

用户点按磁贴时磁贴所调用任务名称。默认值为 _default

TemplateType5 元素

适用于:Windows Phone OS 7.1

TemplateType5 元素是 PrimaryToken 元素的子元素。它是控制 Windows Phone OS 7.1 的应用磁贴的默认模板。下表介绍了 TemplateType5 元素的子元素。

元素

类型

描述

BackgroundImageURI

字符串

包含磁贴背景图像的本地或远程资源名称。

计数

Integer

磁贴可以包含显示介于 0 到 99 之间的值的计数器。如果值为 0,计数器不会显示在磁贴上。

标题

字符串

磁贴中出现的标题。默认值是项目名称。

TemplateFlip 元素

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

TemplateFlip 元素是 PrimaryToken 元素的子元素。它是控制 Windows Phone 8 的应用磁贴的默认模板。下表描述 TemplateFlip 元素的子元素。有关翻转磁贴的更多信息,请参见 Windows Phone 8 翻转磁贴模板

元素

类型

描述

SmallImageURI

字符串

包含磁贴背景图像的本地或远程资源的名称和路径。

计数

Integer

显示在磁贴上的 0 和 99 之间的值。如果值为 0,计数器不会显示在磁贴上。

BackgroundImageURI

字符串

包含磁贴背景图像的本地或远程资源的名称和路径。

标题

字符串

磁贴中出现的标题。默认值是项目名称。

BackContent

字符串

要在磁贴背面显示的文本(位于标题上面)。

BackBackgroundImageURI

字符串

包含用于磁贴背面的背景图像的本地或远程资源的名称和路径。

BackTitle

字符串

在磁贴背面上出现的标题。

LargeBackgroundImageURI

字符串

包含大型磁贴背景图像的本地或远程资源的名称和路径。

LargeBackContent

字符串

要在大型磁贴背面显示的文本(位于标题上面)。

LargeBackBackgroundImageURI

字符串

包含用于大型磁贴背面的背景图像的本地或远程资源的名称和路径。

DeviceLockImageURI

字符串

包含应用锁定图像的本地或远程资源的名称和路径。

HasLarge

TrueFalse

一个指示应用是否支持大型磁贴的值。没有值指示不支持大型磁贴。

Extensions 元素是 App 元素的子元素,紧跟在 Tokens 元素后面。此元素用于指定您的应用支持的扩展名。有关更多信息,请参见 Windows Phone 8 的搜索可扩展性。有关编辑此节的更多信息,请参见如何修改 Windows Phone 8 的应用清单文件

重要说明重要说明:

Extensions 元素中的元素顺序非常重要。所有 Extension 元素都应先列出,后面是所有 FileTypeAssociation 元素,接下来是所有 Protocol 元素。

Extension 元素

所有 Extension 元素都应先在 Extensions 元素下面列出。每个 Extension 元素都介绍了一项应用连接扩展。

属性

类型

描述

ConsumerID

GUID

利用指定的 ProductID 限制对使用者扩展名的访问。所有搜索扩展名均要求使用同一个值,5B04B775-356B-4AA0-AAF8-6491FFEA5661

ExtensionName

字符串

扩展支持类型的标识符。

ExtraFile

字符串

指定 Extras.xml 文件的位置。文件必须位于名为 Extensions 的文件夹中,并且必须命名为 Extras.xml。

TaskID

字符串

将调用路由到指定的 TaskID。若未指定此特性,则调用将路由至默认任务。

FileTypeAssociation 元素

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

FileTypeAssociation 元素是 Extensions 元素的子元素,始终应该跟在 Extension 元素后面。FileTypeAssociation 元素介绍了应用与某些文件类型之间的文件关联。该项让您可以将您的应用与一些文件类型关联,让用户可以选择启动您的应用来查看这些文件类型。您最多可以注册 20 个文件关联。有关详细信息,请参见使用 Windows Phone 8 的文件和 URI 关联自动启动应用

属性

类型

描述

名称

字符串

文件关联的友好名称。

NavUriFragment

字符串

始终设置为 fileToken=%s

TaskID

字符串

始终设置为 _default

Protocol 元素

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

Protocol 元素是 Extensions 元素的子元素,应该始终跟在所有 FileTypeAssociation 元素后面。Protocol 元素介绍了应用注册的 URI 方案名称,使其可以在另一个应用启动某个特定 URI 时启动。有关详细信息,请参见使用 Windows Phone 8 的文件和 URI 关联自动启动应用

属性

类型

描述

名称

字符串

自定义的 URI 方案的前缀。包含数字、小写字母、句点 (‘.’) 或连字符 (‘-’) 且长度介于 2 和 39 个字符之间的字符串。不包含冒号 (‘:’) 或任何在 URI 中的前缀后面的内容。

NavUriFragment

字符串

始终设置为 encodedLaunchUri=%s

TaskID

字符串

始终设置为 _default

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

ScreenResolutions 元素是 App 元素的子元素。此元素用于指定您的应用支持的分辨率。有关更多信息,请参见 Windows Phone 8 的多分辨率应用

ScreenResolution 元素

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

ScreenResolution 元素是 ScreenResolutions 元素的子元素,用于指定应用支持的分辨率。

属性

类型

描述

名称

字符串

Windows Phone 8 应用支持的屏幕分辨率。这些包括 ID_RESOLUTION_WVGA、ID_RESOLUTION_WXGA 和 ID_RESOLUTION_HD720P。

Requirements 元素是 App 元素的子元素,应该紧跟在 Windows Phone 8 的 ScreenResolutions 元素以及 Windows Phone OS 7.1 的 Capabilities 元素后面。从 Windows Phone SDK 7.1.1 更新 开始,使用此元素来指示应用是否要求特定硬件。例如,如果应用无法在 低内存设备 上运行,您应在本节中指出该应用。此元素的主要目标是阻止用户购买或安装无法在他们的手机上运行的应用。如果应用能够在所有 Windows Phone 上运行,并且应用没有其他特殊的硬件要求,则您的清单文件不需要包含 Requirements 元素。

Requirement 元素

Requirements 元素是 Requirements 元素的子元素。Requirement 元素拥有一个特性,即名称,它接受一个字符串值。您可以使用清单编辑器为您的应用标记硬件要求。有关详细信息,请参见如何修改 Windows Phone 8 的应用清单文件。有关您可以为 Requirement 名称值指定的值的详细信息,请参见 Windows Phone 8 应用功能和硬件要求

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

FunctionalRequirements 元素是 App 元素的可选子元素,并且应紧跟在清单文件中 Requirements 部分之后。使用 FunctionalRequirements 元素指示应用是否需要特定的硬件功能,如增加的内存限制。例如,如果应用无法在 低内存设备 上运行,您应在本节中指出该应用。

FunctionalRequirement 元素

FunctionalRequirement 元素是 FunctionalRequirements 元素的子元素。FunctionalRequirement 元素拥有一个特性,即名称,它接受字符串值。有关您可以为 FunctionalRequirement 名称值指定的值的详细信息,请参见 Windows Phone 8 应用功能和硬件要求

显示:
© 2014 Microsoft