此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

如何将应用项目升级到 Windows Phone 8

2014/6/18

您可以轻松地将面向 Windows Phone OS 7.1 的现有 Windows Phone 应用项目升级到面向 Windows Phone 8。

本主题包括以下部分。

 

在升级项目之前创建项目的备份副本,特别是如果您想要开发面向 Windows Phone 8 和 Windows Phone OS 7.1 的应用时。升级过程不会创建项目的副本;它将原地升级项目。在升级项目后,您不能将其转换回 Windows Phone OS 7.1。

确保项目文件和应用清单文件 (WMAppManifest.xml) 没有被标记为只读。升级过程需要对这些文件进行写访问。

您可以使用以下方法之一升级 Visual Studio 中的现有 Windows Phone 项目:

  • 在“解决方案资源管理器”中,使用项目上下文菜单中的“升级到 Windows Phone 8.0”命令。

  • 在项目设计器中,将“面向 Windows Phone OS 版本”属性值更改为“Windows Phone OS 8.0”

但您不能将 XNA Game Studio 4.0 项目升级到 Windows Phone 8。有关更多信息,请参见 XNA Framework 和 Windows Phone 8 的应用开发

在“解决方案资源管理器”中使用“升级到 Windows Phone 8.0”命令升级 Windows Phone OS 7.1 项目

  1. 在 Visual Studio 中,打开要升级的 Windows Phone OS 7.1 应用项目。

  2. 在“解决方案资源管理器”中,右键单击该项目,并在右键菜单中选择“升级到 Windows Phone 8.0”。项目将升级到面向 Windows Phone 8。

    下图所示为“解决方案资源管理器”项目上下文菜单上的“升级到 Windows Phone 8.0”命令。

    The Upgrade command on the context menu

在项目设计器中通过更改目标版本升级 Windows Phone OS 7.1 项目

  1. 在 Visual Studio 中,在“项目”菜单上单击“属性”以打开项目设计器。

  2. 在项目设计器的“应用程序”页面上的“面向 Windows Phone OS 版本”下拉列表中选择“Windows Phone OS 7.1”

  3. 保存更改。项目将升级到面向 Windows Phone 8。

    下图所示为项目设计器中的“应用程序”页面上的目标版本下拉列表。

    Target Windows Phone Version

如果您要升级的项目被面向 Windows Phone OS 7.1 的其他项目引用,那么您也要升级这些其他项目。否则您将得到引用 Windows Phone 8 项目的 Windows Phone OS 7.1 项目。不支持此方案。

如果您在升级之后将仅在 Windows Phone 8 中可用的功能添加到项目,则可能还需要执行以下更改。

  • 如果您使用在 Windows Phone 8 中尚未使用的 API,您可能需要为包含新 API 的程序集添加对项目的引用,并将命名空间导入到您的代码文件中。

  • 如果您在应用中添加新的 Windows Phone 8 功能,则可能需要在应用清单文件中编辑功能和硬件要求。

    然而,升级过程会自动删除弃用的 ID_CAP_MEDIALIB 功能,并根据需要替换为新的 ID_CAP_MEDIALIB_AUDIO、ID_CAP_MEDIALIB_PLAYBACK、ID_CAP_MEDIALIB_VIDEO 或 ID_CAP_MEDIALIB_PHOTO 功能。

有关面向 Windows Phone OS 7.1 的应用和面向 Windows Phone 8 的应用之间的兼容性问题的信息,请参见 Windows Phone 8 的应用平台兼容性。升级之后,这些兼容性问题可能会影响应用的行为。

有关重用代码并使应用保持同时面向 Windows Phone 8 和 Windows Phone OS 7.1 的信息,请参见如何面向多个版本开发 Windows Phone 8 应用

当您将面向 Windows Phone OS 7.1 的现有项目升级到面向 Windows Phone 8 时,升级过程在应用清单文件中进行了以下更改。

有关 Windows Phone 8 应用清单文件的更多信息,请参见 Windows Phone 8 的应用清单文件

说明注意:

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

功能

OS 版本

更改

命名空间

7.1

http://schemas.microsoft.com/windowsphone/2009/deployment

8.0

http://schemas.microsoft.com/windowsphone/2012/deployment

版本号

7.1

AppPlatformVersion=7.1

8.0

AppPlatformVersion=8.0

默认语言

7.1

8.0

<DefaultLanguage xmlns="" code="en-US"/>

PublisherID

7.1

8.0

<App … PublisherID="{new random GUID}" … >

功能

7.1

ID_HW_FRONTCAMERA

8.0

替换为 ID_REQ_FRONTCAMERA 硬件要求

功能

7.1

ID_MEDIALIB

8.0

替换为以下一个或多个项:

  • ID_CAP_MEDIALIB_AUDIO

  • ID_CAP_MEDIALIB_PLAYBACK

  • ID_CAP_MEDIALIB_PHOTO

磁贴支持

7.1

<Tokens>
  <PrimaryToken
      TokenID="EmptyNewWP71ProjectToken"
      TaskName="_default">
    <TemplateType5>
      <BackgroundImageURI IsRelative="true" IsResource="false">
        Background.png
      </BackgroundImageURI>
      <Count>0</Count>
      <Title>EmptyNewWP71Project</Title>
    </TemplateType5>
  </PrimaryToken>
</Tokens>

8.0

<Tokens>
  <PrimaryToken
      TokenID="EmptyNewWP80ProjectToken"
      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>EmptyNewWP80Project</Title>
      <BackContent></BackContent>
      <BackBackgroundImageURI></BackBackgroundImageURI>
      <BackTitle></BackTitle>
      <DeviceLockImageURI></DeviceLockImageURI>
      <HasLarge></HasLarge>
    </TemplateFlip>
  </PrimaryToken>
</Tokens>

屏幕分辨率

7.1

8.0

<ScreenResolutions>
  <ScreenResolution Name="ID_RESOLUTION_WVGA"/>
  <ScreenResolution Name="ID_RESOLUTION_WXGA"/>
  <ScreenResolution Name="ID_RESOLUTION_HD720P"/>
</ScreenResolutions>

如果您使用 Windows Phone SDK 8.0 工具打开面向 Windows Phone OS 7.0 的项目,那么 Visual Studio 会提示您升级项目以面向 Windows Phone OS 7.1。将项目升级为面向 Windows Phone OS 7.1 时,您可以将其升级为面向 Windows Phone 8。

从 Windows Phone OS 7.0 升级项目

  1. 在 Visual Studio 中,打开面向 Windows Phone OS 7.0 的项目。以下对话框提示您升级项目。

    Upgrade warning for Windows Phone 7.0 projects
  2. 单击“确定”。项目将升级到面向 Windows Phone OS 7.1。或者,您可以选择现在将项目升级到面向 Windows Phone 8。

该部分介绍一些可能出现升级失败的场景,帮助您理解和解决失败原因。

升级之后,构建您的应用项目失败,出现关于未解析引用的错误。

问题。现有项目引用 SDK 程序集。您卸载 Windows Phone SDK 7.1 然后安装 Windows Phone SDK 8.0。Windows Phone SDK 8.0 在相同路径下安装较新版本的同一 SDK 程序集。项目所引用的旧程序集将不再存在于计算机上。因此,在项目升级之前或之后,您都无法顺利地使用 Windows Phone SDK 8.0 构建项目。

示例。 Windows Phone SDK 7.1 安装 5.2 版本的 Microsoft Advertising SDK 程序集。Windows Phone SDK 8.0 为面向 Windows Phone OS 7.1 的应用在相同路径下安装 6.1 版本的该程序集 。如果您移除 Windows Phone SDK 7.1,则项目所引用的旧程序集将不再存在于计算机上。

症状。您可能会看到类似于以下情况之一的警告或错误。

The type or namespace name 'Advertising' does not exist in the namespace 'Microsoft' (are you missing an assembly reference?)

Could not resolve this reference. Could not locate the assembly "Microsoft.Advertising.Mobile, Version=5.2.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL". Check to make sure the assembly exists on disk. If this reference is required by your code, you may get compilation errors.

The referenced component 'Microsoft.Advertising.Mobile' could not be found.

解决方案。手动移除对旧版本的引用,添加对较新版本的 SDK 程序集的引用。

升级之后,构建您的应用项目失败,出现关于重复类型或不明确类型的错误。

问题。现有项目使用来自 Microsoft SDK 的程序集的 API,如 Windows Phone Toolkit。在 Windows Phone 8 中,该 API 已被移到 Windows Phone 8 引用程序集中的不同命名空间内。因此,编译器无法在 SDK 程序集中的定义和引用程序集中的定义之间作出选择。

示例。 在 Windows Phone Toolkit 中为 Windows Phone OS 7.1 定义了 System.Tuple 类型。在 Windows Phone OS 8.0 中,System.Tuple 类已被移到 mscorlib.dll 中。如果您升级后的项目仍具有对 Windows Phone OS 7.1 的 Windows Phone Toolkit 的引用和对 mscorlib.dll 的默认引用,那么您可能会看到关于重复或不明确类型的错误。

症状。 您可能会看到类似于以下情况的警告。

The predefined type 'System.Tuple' is defined in multiple assemblies in the global alias; using definition from 'c:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\WindowsPhone\v8.0\mscorlib.dll'

解决方案。手动更新您的代码以指向对于 Windows Phone 8 引用程序集中的类型来说正确的命名空间。或者,如果类型定义已被移至较新版本的相同 SDK 程序集,则手动移除对旧版本的引用,并添加对较新版本的 SDK 程序集的引用。

升级失败,出现关于项目导入的错误

症状。单击“升级到 Windows Phone 8.0”失败,出现错误,指示未发现项目导入。

解决方案。确保您没有为创建自定义条件导入而更改了项目文件中现有的导入声明。移除所有自定义项之后,重试升级。

更多信息。若要成功升级,您应保持创建在项目文件中的导入声明的完整。移除或编辑默认导入声明可能阻碍项目成功升级到 Windows Phone 8。如果您自定义了导入声明,那么在升级前您可能要撤销所执行的自定义。

因为缺少对 System.Core.dll 或 mscorlib.dll 的引用而造成升级失败

症状。单击“升级到 Windows Phone 8.0”失败,出现以下错误。

Upgrade error when reference is missing

解决方案。检查项目是否缺少一些默认引用。尤其应确保已经引用 System.Core.dll 和 mscorlib.dll。如果缺少这些引用,则从以下路径恢复对 Windows Phone OS 7.1 版本的这些程序集的引用:

Program Files (x86)\Reference Assemblies\Microsoft\Framework\Silverlight\v4.0\Profile\WindowsPhone71\

恢复缺少的引用之后,重试升级。

更多信息。 在面向 Windows Phone OS 7.1 的项目中,要求对 System.Core.dll 和 mscorlib.dll 的显式引用。首先保证这些引用存在,您才能将项目升级到 Windows Phone 8。

显示:
© 2015 Microsoft