将Win8.1/WP8.1应用迁移到Universal Windows Platform

在上一篇在VS2015 RC打开CTP中创建的工程，我们介绍了怎么在RC中打开CTP中创建的Universal 工程，这一篇我们来讲下怎么将Windows 8.1/WP8.1的应用迁移到Universal Windows Platform上。

2015RC中，我们可以将8.1的应用迁移到统一平台上，进而使用新的API进行开发，下面我们使用wp8.1的应用作为例子讲解下步骤。

1. 首先我们使用2015打开之前的工程。

2. 右键点击工程，选择“卸载项目”。

3. 右键点击工程，选择“编辑XXX.csproj”

4. 和上一篇一样，取得平台版本号，路径是“\Program Files (x86)\Windows Kits\10\Platforms\UAP”

下面就开始修改工程文件了

5. 找到个包含子节点TargetPlatformVersion、且值为8.1的PropertyGroup节点（其实一般第一个PropertyGroup就是了），进行下面的修改：

• 把Platform的值改成x86
• 添加TargetPlatformIdentifier节点，值为UAP
• 把TargetPlatformVersion的值改成4中取得的版本号
• 添加TargetPlatformMinVersion节点，值为4中的版本号
• 把MinimumVisualStudioVersion的值改成14
• 把ProjectTypeGuids的值改成{A5A43C5B-DE2A-4C0C-9213-0A381AF9435A};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}
• 添加EnableDotNetNativeCompatibleProfile节点，值为true

6. 把所有的vs版本从12.0替换成14.0，这一步直接替换即可（CTRL+H）

7. 删掉配置为AnyCPU的PropertyGroup节点

8. 查看剩下配置是Release的PropertyGroup节点，如果下面没有UseDotNetNativeToolchain子节点的话，就动手加一个，值一定要是true， 即：<UseDotNetNativeToolchain>true</UseDotNetNativeToolchain>

9. 如果是手机项目的话，还需要删除下面这个节点

10. 现在重新加载我们的工程，会发现工程类型变成了Windows Universal了！下面还是需要修改manifest。

11. 打开manifest文件，首先我们需要替换掉所有的schema，把Package节点用下面这段替换。

<Package
    xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
   IgnorableNamespaces= "uap mp">

对于Win8.1应用，还需要额外添加mp:PhoneIdentity的节点，如下，其中PhoneProductId就是Identity的Name, PhonePushedId目前是固定的值

    <Identity Name="fe8a6971-8349-489b-8941-83dd308e9b9b"
              Publisher="CN=xxxxxxx"
              Version="1.0.0.0" />

    <mp:PhoneIdentity PhoneProductId="fe8a6971-8349-489b-8941-83dd308e9b9b" PhonePublisherId="00000000-0000-0000-0000-000000000000"/>

12. 在Package下添加如下子节点，其中的版本号就是我们之前一直用的

<Dependencies>
<TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10069.0" MaxVersionTested="10.0.10069.0" />
</Dependencies>

13. 删除Prerequisites节点

14. 检查你的Resources节点，如果是用到了Scale和DXFeatureLevel的话，为他们加上uap命名空间，如下

    <Resources>
        <Resource Language="x-generate"/>
        <Resource uap:Scale="180"/>
        <Resource uap:DXFeatureLevel="dx11"/>
    </Resources>

15. 检查你的Capability节点，如果使用声明了下列这些权限，需要加上uap命名空间。

• documentsLibrary
• picturesLibrary
• videosLibrary
• musicLibrary
• enterpriseAuthentication
• sharedUserCertificates
• removableStorage
• appointments
• contacts

如：

<Capabilities>
  <uap:Capability Name="documentsLibrary"/>
  <uap:Capability Name="removableStorage"/>
</Capabilities>

16. 将VirsualElements节点及其子节点的命名空间改成uap

<uap:VisualElements
     DisplayName="App9"
     Square150x150Logo="Assets\Logo.png"
     Square44x44Logo="Assets\SmallLogo.png"
     Description="App9"
     BackgroundColor="transparent">
    <uap:DefaultTile Wide310x150Logo="Assets\WideLogo.png" Square71x71Logo="Assets\Square71x71Logo.png"/>
    <uap:SplashScreen Image="Assets\SplashScreen.png"/>
</uap:VisualElements>

对于Win8.1应用，这里需要注意的是，属性Square{SIZE}Logo中的size有了变化，70x70变成了71x71, 30x30变成44x44.

旧的：

<m2:VisualElements
    …
    Square30x30Logo="Assets\SmallLogo.png"
    …>
 <m2:DefaultTile
      …
      Square70x70Logo="images/70x70.png">
</m2:VisualElements>

新的：

<uap:VisualElements
    …
    Square44x44Logo="Assets\SmallLogo.png"
    …>
 <uap:DefaultTile
      …
      Square71x71Logo="images/70x70.png">
</uap:VisualElements>

17. 检查Extensions节点，为下列节点添加命名空间uap

• windows.accountPictureProvide
• windows.alarm
• windows.appointmentsProvider
• windows.autoPlayContent
• windows.autoPlayDevice
• windows.cachedFileUpdate
• windows.cameraSettings
• windows.fileOpenPicker
• windows.fileTypeAssociation
• windows.fileSavePicke
• windows.lockScreenCall
• windows.printTaskSettings
• windows.protocol
• windows.search
• windows.shareTarget

如：

<Extensions>
  <uap:Extension Category="windows.alarm"/>
  <uap:Extension Category="windows.search" EntryPoint="MyActivateableClassId.baz"/>
  <uap:Extension Category="windows.protocol">
    <uap:Protocol Name="mailto" DesiredView="useHalf">
     <uap:DisplayName>MailTo Protocol</uap:DisplayName>
    </uap:Protocol>
  </uap:Extension>
</Extensions>

18. 为类型为chatMessageNotification的后台任务加上uap命名空间

如：

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" Executable="MyBackground.exe">
 <BackgroundTasks ServerName="MyBackgroundTasks">
    <uap:Task Type="chatMessageNotification"/>
  </BackgroundTasks>
</Extension>

19. 修改PackageDependency，添加Publisher和MinVersion属性

<Dependencies>
 <PackageDependency
      Name="Microsoft.VCLibs.120.00"
      Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
      MinVersion="12.0.30113.0" />
</Dependencies>

20. 将类型为gattCharacteristicNotification 和rfcommConnection的后台任务替换为Bluetooth类型。

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" Executable="MyBackground.exe">
<BackgroundTasks ServerName="MyBackgroundTasks">
           <Task Type="bluetooth"/>
</BackgroundTasks>
</Extension>

21. 使用新的bluetooth capability替换bluetooth.rfcomm和bluetooth.genericAttributeProfile

旧的：

<Capabilities>
  <m2:DeviceCapability Name="bluetooth.rfcomm">
    <m2:Device Id="any">
     <m2:Function Type="serviceId:34B1CF4D-1069-4AD6-89B6-E161D79BE4D8"/>
    </m2:Device>
  </m2:DeviceCapability>
  <m2:DeviceCapability Name="bluetooth.genericAttributeProfile">
    <m2:Device Id="any">
     <m2:Function Type="name:heartRate"/>
    </m2:Device>
  </m2:DeviceCapability>
</Capabilities>

新的：

<Capabilities>
  <uap:DeviceCapability Name="bluetooth"/>
</Capabilities>

22. 删除Windows.contact和windows.contactPicker扩展

23. 删除VisualElements的ForgroundText和ToastCapable属性

24. 删除DefaultTitle的DefaultSize属性

25. 删除ApplicationView节点

26. 到此manifest文件就修改完了，保存吧！虽然看上去步骤有点多，其实17之后的很多步骤可能是用不到的

27. 下面我们需要删除一些额外的文件

• 检查解决方案目录下的子目录"\.vs\{project name}\v14"，如果存在".suo"文件，删掉它
• 删除掉工程目录下所有的后缀为.csproj.user文件

现在我们的工程就已经成功的迁移到了Universal Windows Platform了，但是对于很多应用来说，还是需要进一步修改code，因为Windows 10的很多API都有了变化。