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__
:
手动为Android项目添加__ANDROID__
符号
实现一个Label显示平台系统版本信息的示例,iOS通过UIKit命名空间下的UIDevice类获取信息、Android通过Android.OS命名空间下的Build类获取信息(需要Xamarin.Android和Xamarin.IOS知识):
通过与处理命令判断引用不同命名空间(当前启动项目为iOS项目,所以Android项目代码为灰色)
获取系统信息实现代码:
#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
运行后效果图:
同名类调用
SAP是一个扩展共享项目,平台项目和SAP项目之间可以相互调用,将每个项目的实现代码放在一个同名类中,SAP调用该类即可。
IOS项目定义一个DeviceInfo类
再为Android项目添加DeviceInfo类
SAP添加对应命名空间,调用DeviceInfo类
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<IDeviceInfo>();
label.Text = deviceInfo.GetDeviceInfo();