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

时间:2023-12-19 22:00:20

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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节点,如果是用到了ScaleDXFeatureLevel的话,为他们加上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"文件,删掉它将Win8.1/WP8.1应用迁移到Universal Windows Platform
  • 删除掉工程目录下所有的后缀为.csproj.user文件

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

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