Xamarin.Forms Platform-Specific API

Xamarin.Forms 并不能支持每个平台的所用功能,如声音、视频播放和文件读写等功能需要我们单独为每个平台编码,也可以添加第三方组件扩展实现我们需要的功能,第三方组件可以在 https://components.xamarin.com 搜索或者通过Github搜索,本文主要记录编码调用平台特有API。代码实现又分Use Portable Class Library(PCL)和Use Shared Library(SAP)两种方式。Use Portable Class Library以可移植库方式创建项目所有代码会编译成一个独立的DLL,Use Shared Library方式创建项目是一个共享项目,项目中的代码会被每个平台共享使用。

Shared Library 方式编码

新建项目,选择Use Shared Library方式创建项目。

预处理命令使用

SAP可以使用C#提供的#if、#elif、 #else 和#endif等C#与处理命令。
为每个平台定义符号,IOS项目默认定义了__IOS__

Xamarin.Forms Platform-Specific API_第1张图片

手动为Android项目添加__ANDROID__符号

Xamarin.Forms Platform-Specific API_第2张图片

实现一个Label显示平台系统版本信息的示例,iOS通过UIKit命名空间下的UIDevice类获取信息、Android通过Android.OS命名空间下的Build类获取信息(需要Xamarin.Android和Xamarin.IOS知识):

通过与处理命令判断引用不同命名空间(当前启动项目为iOS项目,所以Android项目代码为灰色)

Xamarin.Forms Platform-Specific API_第3张图片

获取系统信息实现代码:

#if __IOS__

            UIDevice device = new UIDevice();
            label1.Text = String.Format("{0} {1}", device.SystemName,
                                                         device.SystemVersion);
#elif __ANDROID__

            label1.Text = String.Format("{0} {1}", Build.Model,Build.VERSION.Release);

#endif

运行后效果图:

Xamarin.Forms Platform-Specific API_第4张图片

同名类调用

SAP是一个扩展共享项目,平台项目和SAP项目之间可以相互调用,将每个项目的实现代码放在一个同名类中,SAP调用该类即可。

IOS项目定义一个DeviceInfo类

Xamarin.Forms Platform-Specific API_第5张图片

再为Android项目添加DeviceInfo类

Xamarin.Forms Platform-Specific API_第6张图片

SAP添加对应命名空间,调用DeviceInfo类

Xamarin.Forms Platform-Specific API_第7张图片

Portable Class Library 方式编码

PCL项目会编译成一个独立的DLL,所以不能直接调用平台项目提供的代码,但是可以通过.NET的反射机制在PCL项目中调用平台项目代码。Xamarin.Forms已经提供了DependencyService类帮助我们实现反射调用。

在PCL的项目中使用DependencyService类要先定义一个接口,声明要实现的方法签名。

新建Forms项目选中Use Portable Class Library,在PCL项目中添加IDeviceInfo接口:

public interface IDeviceInfo
{
    string GetDeviceInfo();
}

在平台项目中定义一个类实现IDeviceInfo接口,该类所在命名空间和类名无特殊要求,且为该类添加一个Dependency特性,DependencyAttribute类由Xamarin.Forms提供与DependencyService结合使用,该特性应该标注在namespace外。

[assembly: Dependency(typeof(specific.iOS.DeviceInfo))]
namespace specific.iOS
{

    public class DeviceInfo : IDeviceInfo
    {

        public string GetDeviceInfo()
        {
            UIDevice device = new UIDevice();
            return String.Format("{0} {1}", device.SystemName,
                                                         device.SystemVersion);
        }
    }
}

Dependency接受的参数是Type类型,表示定义在平台项目中由PCL项目访问的类。如示例代码typeof接收的参数应该是类的完全限定名。

Android项目下DeviceInfo类代码不贴出。
接下来在PCL项目中通过DependencyService访问特定平台的IDeviceInfo实现:

IDeviceInfo deviceInfo = DependencyService.Get();
label.Text = deviceInfo.GetDeviceInfo();

你可能感兴趣的:(Xamarin.Forms Platform-Specific API)