适用于： Windows Phone 8 | Windows Phone OS 7.1
您可以轻松地将面向 Windows Phone OS 7.1 的现有 Windows Phone 应用项目升级到面向 Windows Phone 8。
如果您使用 Windows Phone SDK 8.0 工具打开面向 Windows Phone OS 7.0 的项目，那么 Visual Studio 会提示您升级项目以面向 Windows Phone OS 7.1。
但您不能将 XNA Game Studio 4.0 项目升级到 Windows Phone 8。有关更多信息，请参见 XNA Framework 和 Windows Phone 8 开发。
有关面向 Windows Phone OS 7.1 的应用和面向 Windows Phone 8 的应用之间的兼容性问题的信息，请参见 Windows Phone 应用平台兼容性。
本主题包含以下各节。
我们强烈建议您在升级项目之前创建该项目的备份副本，特别是如果您想要开发面向 Windows Phone 8 和 Windows Phone OS 7.1 的应用。在升级项目后，您不能将其转换回 Windows Phone OS 7.1。有关更多信息，请参见如何面向多个版本开发 Windows Phone 应用。
在 Visual Studio 中，您可以使用以下方式之一升级现有 Windows Phone 项目：
-
在“解决方案资源管理器”中，使用“升级到 Windows Phone 8.0”命令。
-
在项目设计器中，将“面向 Windows Phone OS 版本”值改为“Windows Phone OS 8.0”。
使用“升级到 Windows Phone 8.0”命令升级 Windows Phone OS 7.1 项目的步骤
-
在 Visual Studio 中，打开要升级的 Windows Phone OS 7.1 应用项目。
-
在“解决方案资源管理器”中，右键单击该项目，并在右键菜单中选择“升级到 Windows Phone 8.0”。
项目将升级到面向 Windows Phone 8。
下图所示为右键菜单上的“升级到 Windows Phone 8.0”命令。
通过更改面向的版本升级 Windows Phone OS 7.1 项目的步骤
-
在 Visual Studio 中，在“项目”菜单上单击“属性”以打开项目设计器。
-
在“应用程序”页面上，在“面向 Windows Phone OS 版本”列表中选择“Windows Phone OS 7.1”。
项目将升级到目标 Windows Phone 8。
下图显示了面向的版本下拉列表。
如果您将仅在 Windows Phone 8 可用的功能添加到您升级的项目，则您可能还需要执行以下更改。
-
如果您使用在 Windows Phone 8 中尚未使用的 API，您可能需要为包含新 API 的程序集添加对项目的引用，并将命名空间导入您的代码文件。
-
如果将新的 Windows Phone 8 功能添加到引用，您可能需要编辑清单文件，或在 Windows Phone 商店测试工具包 中运行功能验证测试。然而，升级过程会自动删除弃用的 ID_CAP_MEDIALIB 功能，并酌情使用新的 ID_CAP_MEDIALIB_AUDIO、ID_CAP_MEDIALIB_VIDEO 或 ID_CAP_MEDIALIB_PHOTO 功能替代它。
当您将面向 Windows Phone OS 7.1 的现有 Windows Phone 应用项目升级到面向 Windows Phone 8 时，升级过程在应用清单文件中进行了以下更改：
|
功能 |
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 |
替换为以下一个或多个项：
|
|
|
图块支持 |
7.1 |
<标记> <PrimaryToken TokenID="appnameToken" TaskName="_default"> <TemplateType5> <BackgroundImageURI IsRelative="true" IsResource="false">Background.png</BackgroundImageURI> <Count>0</Count> <Title>app name</Title> </TemplateType5> </PrimaryToken> </Tokens> |
|
8.0 |
<标记> <PrimaryToken TokenID="app name" 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>app name</Title> <BackContent></BackContent> <BackBackgroundImageURI></BackBackgroundImageURI> <BackTitle></BackTitle> <LargeBackgroundImageURI></LargeBackgroundImageURI> <LargeBackContent></LargeBackContent> <LargeBackBackgroundImageURI></LargeBackBackgroundImageURI> <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> |
该部分介绍一些可能出现升级失败的场景，帮助您理解和解决失败原因。
升级之后，构建您的应用项目失败，出现关于未解析引用的错误。
问题。现有项目引用 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 程序集中的定义和引用程序集中的定义之间作出选择。
示例。System.Tuple 类型定义在 Windows Phone OS 7.1 的 Windows Phone Toolkit 中。在 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”失败，出现以下错误。
分辨率。检查项目是否缺失一些默认引用。尤其应确保已经引用 System.Core.dll 和 mscorlib.dll。如果缺失这些引用，则从以下路径恢复对 Windows Phone OS 7.1 版本的这些程序集的引用：
<%ProgramFiles>\Reference Assemblies\Microsoft\Framework\Silverlight\v4.0\Profile\WindowsPhone71\
恢复缺失的引用之后，重试升级。
更多信息。在面向 Windows Phone OS 7.1 的项目中，要求对 System.Core.dll 和 mscorlib.ll 的显式引用。首先保证这些引用的存在，您才能将项目升级到 Windows Phone 8。
关于成功升级的其他提示
-
如果您要升级的项目被面向 Windows Phone OS 7.1 的其他项目引用，那么您也要升级这些其他项目。否则您将得到引用 Windows Phone 8 项目的 Windows Phone OS 7.1 项目。不支持此方案。
-
在升级之前，请确保项目文件和应用清单文件 (WMAppManifest.xml) 没有被标记为只读。升级过程需要对这些文件进行写访问。