从Xamarin.Essentials谈Xamarin库的封装

编者语：Xamarin在国内的推广还需要努力，其实这真的是移动端开发的一大福音，毕竟用一份代码的时间可以生成iOS/Android/Windows/Linux/macOS/Tizen多个平台，而且是原生的性能。Xamarin在Build 2018发布的新功能有Xamarin.Essentials(点击查看) , Hyper-V for Xamarin Android Emulator ,还有Xamarin.Forms 3.0。Xamarin.Forms 3.0 和 Xamarin.Essentials 都会是一个质的飞跃。Xamarin.Forms 有全新的布局FlexLayout ，更好地和原生控件对接，还新增支持GTK+/Tizen。而Xamarin.Essentials的发布则大大提升开发的效率，把因为平台差异造成的代码不一致的底层接口重新做了归一，这样做提升了编码效率。

在Build2018前的两周左右，我拿到了Xamarin.Essentials的测试版本(基于nda我只能等到现在才能发布)，这是一个为访问一些设备硬件和底层给iOS/Android/UWP三个平台做的统一接口，适配了.NET Standard 2.0(当然也包含.NET Standard 1.0 / iOS / Android)。通过Xamarin.Essentails你可以非常快捷地访问不同平台的摄像头，地理位置，网络检测，更能调用如打电话，相册，通讯录等相当方便实用。如我需要了解设备信息的时候，通过Xamarin.Essentails就是一句非常简单的话就可以完成了

640?wx_fmt=png&wxfrom=5&wx_lazy=1

运行生成效果

640?wx_fmt=png

话说回来，在Xamarin.Essential之前，其实Xamarin也推出了Xamarin.Mobile（点击查看）和Plugin(点击查看) 。我们先来看看这两位旧人所做的事，如果对比代码其实也差不多，通过PCL的方式对设备底层API进行访问。(ps : 图一是Xamarin.Mobile , 图二Xamarin.Plugins)
640?wx_fmt=png
看看上面的代码是比较有趣，可以预想到用原生方法写一个摄像头调用你可能需要更多的工作，而且这更接近.NET程序员的使用习惯。假若你希望为Xamarin打造一个跨平台的，也能针对不同平台底层操作，又有一个通用接口的库，这三个通用组件的源码就是很好的教程。
在Xamarin中实现跨平台访问，方法有几种：
1. 通过检测平台的方式，最常用的是宏定义

#if __IOS__

// iOS-specific code

#endif

#if __TVOS__

// tv-specific stuff

#endif

#if __WATCHOS__

// watch-specific stuff

#endif

#if __ANDROID__

// Android-specific code

#endif

2. 或者通过代码的方式, Xamarin.Forms.Device.Idiom去完成

if (Xamarin.Forms.Device.Idiom == TargetIdiom.Phone)

{

MainPage = new NavigationPage(new MyPage());

}

else if(Xamarin.Forms.Device.Idiom == TargetIdiom.Tablet)

{

// etc

}

else if(Xamarin.Forms.Device.Idiom == TargetIdiom.Desktop)

{

// etc

}

else if (Xamarin.Forms.Device.Idiom == TargetIdiom.Unsupported)

{

// etc

}

else

{

// etc

}

这个方式除了在代码也可以在XAML

<OnIdiom.Phone>

<Grid>

</Grid>

</OnIdiom.Phone>

<OnIdiom.Tablet>

<Grid>

</Grid>

</OnIdiom.Tablet>

</OnIdiom>

3. 用DependencyService，在通过公用层生成接口，再在不同平台上实现。这是在Xamarin中最常用的方法，
640?wx_fmt=png
回到封装库，首先要定下一个目标就是做个.NET Standard的库，而不再是做PCL. 还有做这种通用库更应该考虑兼容多平台，如iOS/Android/UWP等。以往的做法你可能需要搭建很多的目录，然后去继承一个公共接口去完成。现在通过MSBuild.Sdk.Extras(点击查看), 通过MSBuild可以对不同平台进行快速编译,生成跨平台的库。参考Xamarin.Essentials(点击进入)，我自己开始编写一个简单的库。先看看实现原理(如图)

640?wx_fmt=png

在.NET Standard 项目中你可以针对不同平台进行编译，利用第三方的MSBuild.Sdk.Extras进行不同平台库的生成工作，在这种方法上你不再需要上面提到的宏定义或Dependency Service，只需要针对预先设置好的文件进行跨平台编译，这大大方便了代码的管理和维护。xx.standard.cs是一个公用的文件，相当于为不同平台定义了一个接口，而具体实现放到各自平台上如xx.ios.cs , xx.android.cs ..... 最后通过shared封装公共方法暴露给不同项目访问。

<TargetFrameworks>netstandard1.0;netstandard2.0;Xamarin.iOS10;MonoAndroid71;</TargetFrameworks>

<Product>$(AssemblyName)($(TargetFramework))</Product>

<EnableDefaultCompileItems>false</EnableDefaultCompileItems>

<EnableDefaultItems>false</EnableDefaultItems>

<BuildOutputTargetFolder>$(TargetFramework)</BuildOutputTargetFolder>

</PropertyGroup>

</PropertyGroup>

<DebugType>pdbonly</DebugType>

</PropertyGroup>

<OutputPath>bin\Debug\$(TargetFramework)</OutputPath>

</PropertyGroup>

<OutputPath>bin\Release\$(TargetFramework)</OutputPath>

</PropertyGroup>

</ItemGroup>

</ItemGroup>

</ItemGroup>

</ItemGroup>

</Project>

剩下的事情，就是针对不同平台作定义了
如Kinfey.ios.cs

using System;

namespace DNDemo.Lib

{

public static partial class Kinfey

{

internal static string Check(){

return "iOS";

}

如Kinfey.android.cs

using System;

namespace DNDemo.Lib

{

public static partial class Kinfey

{

internal static string Check()

{

return "Android";

}

而Kinfey.netstandard.cs

using System;

namespace DNDemo.Lib

{

public static partial class Kinfey

{

internal static string Check() => throw new NotImplementedException();

}

最后暴露的接口在Kinfey.shared.cs

using System;

namespace DNDemo.Lib

{

public static partial class Kinfey

{

public static string CheckInfo(){

return Check();

}

这样你就可以进行编译了，在Windows上你直接用Visual Studio 编译即可，在macOS上你需要编译就需要用命令行了（请高人指点下，我不知道为啥VS for mac不能build跨平台的.NET Stanard......），首先你得restore , 接着执行
msbuild DNDemo.Lib.csproj /p:Configuration=Debug
这个时候，你就会得到四个库.net standard 1.0 / .net standard 2.0 / ios / android 。找个项目调用一下，结果如下：

640?wx_fmt=png