【Win 10应用开发】认识一下UAP项目

时间:2020-12-06 03:12:18

Windows 10 SDK预览版需要10030以上版本号的Win 10预览版系统才能使用。之前我安装的9926的系统,然后安装VS 2015 CTP 6,再装Win 10 SDK,但是在新建项目后,打开XAML文件时,XAML设计器无法正常注册。

后来,我在SDK目录下的描述API协定的xml文件中看到,对系统的版本要求是在10030以上。所以,应该安装3月份的预览版,即10041以上的版本就能正常使用XAML设计器了。

在VS的使用过程,如果出现错误,不要急着发狂,因为那样做除了伤身之外别无好处。

1、可以网上搜搜,看看有没有现成的解决方法。

2、应该关注在出错时提示的错误信息,在其中总能找到一些提示的,至少也能推断造成问题的来源。

3、可以多试几次,看看错误是在你进行什么操作的时候发生,缩小排查范围。

4、查看日志。

5、检查系统是否被动过手脚。用于开发的机器,平时还是少装一些不三不四的软件;也少用一些不干不净的系统镜像。

做到以上各点,至少会减少一些灵异事件的发生。从Vista开始,系统自身功能比较完善,也不需要所谓的第三方优化工具,任何的非系统的优化工具只会破坏系统,污染环境。更何况,少装这些软件,性能也会提升好几倍,这些所谓的优化工具本身就是个流氓。

---------------------------------------------------------------

刚才提到了在SDK的安装目录下有个描述API协定的xml文件,路径就在C:\Program Files (x86)\Windows Kits\10,这是默认路径,我一向安装开发工具都是放在默认路径下的,这样可以大大降低灵异事件的发生率。所以在系统盘分区时,给多大空间大家看着办吧。我分的C盘是92GB,其实也用不完,只是宁可大一点也不要少了。我的盘子是500G,但我知道,现在的电脑的盘子都是用T来计算了,所以,大家别吝啬你的空间,用不完也是白糟踏。

那个xml文件名为SDKManifest.xml,我们看看它里面有啥。

<FileList
DisplayName = "Universal App Platform"
PlatformIdentity = "UAP, Version=10.0.10030.0"
TargetFramework = ".NETCore,version=v4.5.3;.NETFramework,version=v4.5.3"
MinVSVersion = "14.0"
MinOSVersion = "6.1"
MaxOSVersionTested = "10.0"
UnsupportedDowntarget = "Windows, version=8.1"> <File Reference = "Windows">
<ToolboxItems VSCategory = "Toolbox.Default"/>
</File>
</FileList>

这个文件不复杂,我们也没有必要非得把里面的所有XML都弄明白,只要知道是怎么回事就可以了。在上面的XML中,重点看以下几项:

1、DisplayName = "Universal App Platform",这说明,Windows 10 app是UAP类型(通用应用)。

2、PlatformIdentity = "UAP, Version=10.0.10030.0",支持的平台标识,看到了吧,版本是10030以上。

3、MinVSVersion = "14.0",只有VS 2015才支持,目前是CTP6。

4、UnsupportedDowntarget = "Windows, version=8.1",不兼容8.1的应用。大家都知道,在8.1时的UAP是分成三个项目的,而10中的UAP是合并为一个的,这样很好,我只管写一个项目就行了,也不用去考虑哪些代码该放在共享项目下,也不必为各个平台都弄一个项目了。这里说的是项目不兼容,但你要明白,在Win 10中,8.1的应用依然可以运行。如果你不需用到Win10的新功能,那你用8.1的项目也行

5、<File Reference = "Windows">表示项目默认引用面向Windows所有平台的UAP库。

我这里不是叫大家去记上面的内容,一定要注意,这种东西只供了解,你明天忘了也无所谓,你只需明白UAP是什么就行了。其实我是在向大家分享如何自学的方法,当你拿到一个新玩意儿的时候,不要急着去写程序,先花间去弄明白它是个啥东西也不迟,千万不要被现在社会上流行的浮躁思潮所毒害。

看了上面那个xml,至少我们知道:

1、开发10的应用需要系统版本在10030以上。

2、要用新的VS。

3、项目向下不兼容。UAP已经从三个项目变为一个项目,三分天下最终为司马氏的晋朝统一。

接下来我们需要知道UAP项目是怎么引用各个API集的。

和以前的store app一样,有一个API子集肯定有的,500%是少不了的,就是.NET for Windows Store apps,这个我就不多说了,都知道的,就可以用于Runtime App的.NET API集。

除了.net子集外,当你新建一个面向Win 10的 UAP 项目后,还会引用三个API子集,这三个API集也是在一个XML文件中指定的,文件位于C:\Program Files (x86)\Windows Kits\10\Platforms\UAP\10.0.10030.0目录下,名字为Platform.xml。

不妨打开看看。

<ApplicationPlatform name="UAP" friendlyName="Universal Application Platform" version="10.0.10030.0">
<MinimumVisualStudioVersion>14.0.22213.01</MinimumVisualStudioVersion>
<ContainedApiContracts>
<ApiContract name="Windows.Foundation.FoundationContract" version="1.0.0.0" />
<ApiContract name="Windows.Foundation.UniversalApiContract" version="1.0.0.0" />
<ApiContract name="Windows.Networking.Connectivity.WwanContract" version="1.0.0.0" />
</ContainedApiContracts>
</ApplicationPlatform>

在UAP应用中,所有API都以子集的形存在,名字都有Contract结尾,它们位于C:\Program Files (x86)\Windows Kits\10\References目录下,请看截图:
【Win 10应用开发】认识一下UAP项目

是吧,都是以Contract结尾的吧。这样使得每个API子集都有相对的独立性,而且都放在一个目录下,现在1.0.0,以后如果有2.0.0,那直接在目录下建一个2.0.0的子目录,再把*.wimd放进去就行了,方便以后更新,最后再通过一个SDKManifest.xml文件来罗列一些某类型的项目需要XXXXContract、YYYYContract的API就行了。

扯远了,咱们回到Platform.xml文件,从上面的XML中可以看到,一个标准的UAP将默认引用以下三个RT API子集:

Windows.Foundation.FoundationContract,

Windows.Foundation.UniversalApiContract,

Windows.Networking.Connectivity.WwanContract

你不信的话,建一个UAP项目,然后打开对象浏览器窗口,然后过滤条件选择 我的解决方案 ,然后你看看是不是有这三个子集。

【Win 10应用开发】认识一下UAP项目

说不定,以后API升级了,有了2.0.0的UAP项目了,或许把这个XML弄成这样就可以了:

version="10.0.10030.0">
<MinimumVisualStudioVersion>14.0.22213.01</MinimumVisualStudioVersion>
<ContainedApiContracts>
<ApiContract name="Windows.Foundation.FoundationContract" version="2.0.0.0" />
<ApiContract name="Windows.Foundation.UniversalApiContract" version="2.0.0.0" />
<ApiContract name="Windows.Networking.Connectivity.WwanContract" version="2.0.0.0" />
</ContainedApiContracts>
</ApplicationPlatform>

-------------------------------------------------------------------------

好,现在你大概知道UAP的API是怎么分布了,现在,再来动手写代码就有头绪了。

在新建UAP项目时,要选择Windows 10的,然后看窗口中间部分,不多,就那么几个。看图

【Win 10应用开发】认识一下UAP项目

看到没,这些项目模板名字的后面都有UAP标识。分别为标准应用程序(空白应用程序)、类库(*.dll)、Windows运行时组件(*.winmd)、单元测试。

要建一个可以执行的应用程序,当然要选标准应用程序了。

新建项目后,在解决方案资源管理器中看到很熟悉的文件结构,是吧,我没骗你吧,只要你懂Win8.1/WP 8.1的应用开发,这个10的UAP也可以无需学习任何知识就能刷刷刷地写了。

【Win 10应用开发】认识一下UAP项目

App就是表示当前应用程序的类,从Application派生,MainPage当然是主页面类了,这都和以前一样,一切都是很熟悉了。

现在,大家打开MainPage.xaml,看看这个新的XAML设计器。如图

【Win 10应用开发】认识一下UAP项目

如何,还是很熟悉吧。

因为现在的UAP已经合并到一个项目中了,而这个UAP项目是可以直接在PC桌面、Windows平板、WP手机、xBox游戏机等设备上运行的,因此请你注意观察XAML设计器窗口的左上角,看到那下拉菜单了吗?试试看,不用我介绍了,你一定会用。

【Win 10应用开发】认识一下UAP项目

是啊,这个菜单就让你选择不同尺寸的设备,然后可以预览一下界面效果。

而在调试运行按钮的下拉菜单中,已经有本地计算机,远程计算机(平板电脑的真机可以用这项),以及WP 10的模拟器。如果想在WP 10真实手机上调试就选Device。

【Win 10应用开发】认识一下UAP项目

-----------------------------------------------------------------------

代码写着写着,不免又发现一个问题了,既然UAP是一个应用项目通杀各种设备,但是,我们知道,PC、平板上是不用“回退”键的,只有WP手机上才有“回退”键,所以在8.1的时候,只有面向WP的应用才能调用Windows.Phone.UI.Input.HardwareButtons类,然后为BackPressed事件添加处理代码,实现侦听“回退”键行为。

于是,我们会在Win 10 UAP项目中也处理该事件,以便当应用在手机上运行时进行处理,当然手机以外其他平台不需要了。可是,当我在代码中使用时,却发现无法引入Windows.Phone.UI.Input命名空间,而且在编译时报错。但是查看对象浏览器时,在UAP Platform的API下又显示支持HardwareButtons类的,怎么会这样呢?是SDK的开发团队搞错了吗?

开发团队当然没弄错了。既然UAP是通用于各个设备的,自然在UAP项目中默认只引用可以在所有平台上都能用的API了,即前面我给大家看的Platform.xml中列出的那三条引用。

现在,大家可以回到SDK的安装目录C:\Program Files (x86)\Windows Kits\10\,有没有看到一个叫Extension SDKs的目录?然后你打开看看,你马上就会明白了。

【Win 10应用开发】认识一下UAP项目

Windows Desktop表示支持在桌面系统上运行的API子集,其实和UAP子集是一样的,差别在于我们常说的桌面平台是指面向x86、x64架构的CPU的应用,而RT应用还有一个ARM平台的支持。你如果想知道这个Desktop子集有哪些API,可以到里面找到SDKManifest.xml,打开这个XML就看到了。

<FileList TargetPlatform="UAP" TargetPlatformMinVersion="10.0.0.1" TargetPlatformVersion="10.0.10030.0" SDKType="Platform" DisplayName="Windows Desktop Extension SDK" AppliesTo="WindowsAppContainer" MinVSVersion="14.0" ProductFamilyName="Windows.Desktop" SupportsMultipleVersion="Error" TargetFramework=".NETCore, version=v4.5.3;" SupportPrefer32Bit="True" MoreInfo="http://go.microsoft.com/fwlink/?LinkId=517639">
<ContainedApiContracts>
<ApiContract name="Windows.ApplicationModel.Activation.ActivatedEventsContract" version="1.0.0.0"/>
<ApiContract name="Windows.ApplicationModel.Activation.WebUISearchActivatedEventsContract" version="1.0.0.0"/>
<ApiContract name="Windows.ApplicationModel.Calls.LockScreenCallContract" version="1.0.0.0"/>
<ApiContract name="Windows.ApplicationModel.Resources.Management.ResourceIndexerContract" version="1.0.0.0"/>
<ApiContract name="Windows.ApplicationModel.Search.SearchContract" version="1.0.0.0"/> ……

同理,还有一个目录叫Windows Mobile的目录,用于WP手机特定的API就放在这里面了,一样的方法,你进去里面找到SDKManifest.xml,打开它,就能看到有哪些API了。

<FileList TargetPlatform="UAP" TargetPlatformMinVersion="10.0.0.1" TargetPlatformVersion="10.0.0.1" SDKType="Platform" DisplayName="Windows Mobile Extension SDK" AppliesTo="WindowsAppContainer" MinVSVersion="14.0" ProductFamilyName="Windows.Mobile" SupportsMultipleVersion="Error" TargetFramework=".NETCore, version=v4.5.3;" SupportPrefer32Bit="True" MoreInfo="http://go.microsoft.com/fwlink/?LinkId=517396">
<ContainedApiContracts>
<ApiContract name="Windows.ApplicationModel.Activation.WebUISearchActivatedEventsContract" version="1.0.0.0"/>
<ApiContract name="Windows.ApplicationModel.Wallet.WalletContract" version="1.0.0.0"/>
<ApiContract name="Windows.Devices.SmartCards.SmartCardBackgroundTriggerContract" version="1.0.0.0"/>
<ApiContract name="Windows.Devices.SmartCards.SmartCardDeviceContract" version="1.0.0.0"/>
<ApiContract name="Windows.Devices.SmartCards.SmartCardEmulatorContract" version="1.0.0.0"/>
……

现在你终于明白这些API子集为啥都以Contract结尾,它就是一套协定,而哪些API通过,哪些API只有特定平台才能用,都通过一些XML文件来配置,管理方便,在更新时也不容易出错。当然,这种协定方案还有一个用途,后面会告诉大家。

好了,知道这个道理就好办了,在VS中添加面向手机的API集引用就行了。在添加时,选择UAP Platform节点,然后找到Extension SDKs。勾选Windows Mobile Extension SDK就行了。

【Win 10应用开发】认识一下UAP项目

这时候,就可以处理“回退”键了。

Windows.Phone.UI.Input.HardwareButtons.BackPressed += OnBack;

但是,问题还没有得到解决,你想啊,UAP是运行在所有设备上的,虽然我们刚才引用了面向手机的API子集,可是如果我这个应用在平板上运行,这行代码照样会被执行,而平板是不支持“回退”按键的,不仅是平板,PC上也没有这个,是吧,一旦在非手机平台运行也会出错啊。

是的,是的,因此在使用一些需要特定平台才能用的API时,要先进行一些验证,如果该API在当前运行的平台上支持就执行,不支持就跳过代码不执行。

所以,把上面代码改为:

            if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.Phone.UI.Input.HardwareButtons"))
{
Windows.Phone.UI.Input.HardwareButtons.BackPressed += OnBack;
}

刚才在说到API协定时,我说过它还有一个用途的,答案就在这里了。ApiInformation类就是用来验证API的,IsTypePresent方法检测某个类在当前平台上是否支持。支持就返回true,不支持就返回false。注意在指定参数时要写上类型的全路径,包括命名空间的名字。ApiInformation类提供一些静态方法用来检测API的有效性,除了上面用到的检查类型的,也可以用IsMethodPresent方法来检查某个类中某个方法是否可用,等等。

不要觉得这个很麻烦,其实比8.1的UAP通过定义WINDOWS_PHONE_APP这样的条件编译的方法简单多了。再说了,不是说所有API在使用时都这样,只需要验证某个平台特定的API即可,UAP通用的API不用验证。说简单一点,就是在用到Extension SDKs的API子集时才会考虑检查可用性。如果我们不需要用到这些特定API,就不必去引用它们,也不必去进行验证了。记住:只有在用的时候才亮剑。

好了,老周这篇语无伦次的文章,向大家介绍了Windows 10 UAP项目的基本情况。以后,老周会继续写烂文向大家分享Windows开发相关的内容。