你的位置:首页 > 操作系统

[操作系统]将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  ="http://schemas.microsoft.com/appx/manifest/foundation/windows10"  ="http://schemas.microsoft.com/appx/manifest/uap/windows10"  ="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"文件,删掉它
  • 删除掉工程目录下所有的后缀为.csproj.user文件

 

 

 

 

 

 

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