从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就是一句非常简单的话就可以完成了
      
      运行生成效果
      
     话说回来，在Xamarin.Essential之前，其实Xamarin也推出了Xamarin.Mobile（点击查看）和Plugin(点击查看) 。我们先来看看这两位旧人所做的事，如果对比代码其实也差不多，通过PCL的方式对设备底层API进行访问。(ps : 图一是Xamarin.Mobile , 图二Xamarin.Plugins)
         
      看看上面的代码是比较有趣，可以预想到用原生方法写一个摄像头调用你可能需要更多的工作，而且这更接近.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

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

       

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

  

  

    

    netstandard1.0;netstandard2.0;Xamarin.iOS10;MonoAndroid71;
    $(AssemblyName)($(TargetFramework))
    false
    false
    $(TargetFramework)
  
   
    full
    true
  
  
    pdbonly
  
  

  
    bin\Debug\$(TargetFramework)
  
  
    bin\Release\$(TargetFramework)
  




  
    
    
  
  
    
    
    
  
  
    
    
    
    
    
    
  
  
    
    
    
  


  
  

      剩下的事情，就是针对不同平台作定义了
      如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 。找个项目调用一下，结果如下：

       

      赠送源码一份：(点击下载)
      最后Xamarin的第三方库在国外有不少，但国内还是相对较少，希望各位爱好者都贡献一下，为这个技术落地贡献一份力量。