（翻译）Xamarin.Essentials: 移动应用的跨平台 API

原文地址：https://blog.xamarin.com/xamarin-essentials-cross-platform-apis-mobile-apps/

 

当使用 Xamarin 开发 IOS 和 Android 应用的时候，开发人员经过 C# 能够访问每个原平生台 API。这些绑定不只使 C# 平台 API 暴露出来，也添加了强大的 C# 特性，例如 async/await，event，delegate 等。这对开发人员来讲是一个巨大的优点，由于他们不须要离开 C# ，不管是写共享业务逻辑，用户界面或者访问原生特性。一个关键的特性是当使用 Xamarin 开发跨平台应用时，开发者从共享代码中常常寻找一种访问共享的原生特性，无需编写他们本身的抽象或者找一个社区建立的开源插件。

一个单一的 API 访问诸如地理定位、传感器、安全存储和更多功能的梦想如今对于用 Xamarin 与 Xamarin.Essentials 建立的任何应用程序来讲成为了现实。

 

Xamarin.Essentials API

在可用的第一个预览版中，Xamarin.Essentials API 提供了从单一跨平台 API 库访问超过25个原生特性的功能，不管用户界面是如何建立的均可以从共享代码中访问。这意味着你能够在一个单一的 Xamarin.Android 应用或者目标为 IOS，Android 和 UWP 的 。Xamarin.Forms 应用中使用 Xamarin.Essentials API。即便它包括了这些特性，仍然充分优化了性能和应用大小最小的影响，由于这个库充分利用了链接器安全的优点。这意味着只有你使用的 API 和特性会包含在你的应用程序中，其他的将在你便宜你的应用程序时被删除。

这个初始跨平台 API 集的预览版本，能够经过 NuGet 安装到你的应用中：

• Accelerometer: 在三维空间中检索设备的加速度数据。
• App Information: 查找有关应用程序的信息。
• Battery: 容易的检测电池的电压，电量和状态。
• Clipboard: 快速而且容易的设置或读取剪贴板上的文本
• Compass: 监视罗盘的变化。
• Connectivity: 检查链接状态并检测更改。
• Data Transfer: 向其余应用程序发送文本和网站URI。
• Device Display Information: 获取设备的屏幕指标和方向。
• Device Information: 轻松的找出设备信息。
• Email: 轻松的发送电子邮件。
• File System Helpers: 轻松的保存文件到应用程序数据。
• Flashlight: 一个简单的方法来打开手电筒/关闭手电筒。
• Geocoding: 轻松的获取地理编码和反向地理编码。
• Geolocation: 检索设备的GPS位置。
• Gyroscope: 检索设备的三轴陀螺仪的旋转。
• Magnetometer: 检测设备相对于地球磁场的方向。
• Open Browser: 快速和方便地打开浏览器到一个特定的网站。
• Phone Dialer: 打开电话拨号器。
• Preferences: 快速且容易地添加持久的参数选择。
• Screen Lock: 保持设备屏幕唤醒。
• Secure Storage: 安全地存储数据。
• SMS: 轻松发送 SMS 短信。
• Text-to-Speech: 在设备上转换文本成声音
• Version Tracking: 跟踪应用程序版本和生成号码。
• Vibrate: 使设备振动。

这个初始 API 集是基于 Xamarin 开发人员的反馈，包括他们但愿从跨平台 API 库中看到的。随着时间的推移，咱们会继续添加更多特性。

入门

在新的或者已经存在的应用程序中开始使用 Xamarin.Essentials API 是很容易的，只需几个简单的步骤：

1. 打开一个存在的项目或者经过 Visual Studio C# 下的空白应用模板建立一个新的项目（Android，iPhone&iPad 或者 跨平台）。
2. 添加 Xamarin.Essentials NuGet 包到项目中：
   1. Visual Studio：在解决方案面板中，在解决方案名字上右键并选择管理 NuGet。搜索 Xamarin.Essentials 并安装包到全部项目中，包括 iOS，Android，UWP 和 .NET Standard 库。
   2. Visual Studio for Mac：在解决方案面板中，在解决方案名字上右键并选择 添加 -> 添加 NuGet 包.... 搜索 Xamarin.Essentials 并安装包到全部项目中，包括 iOS，Android，UWP 和 .NET Standard 库。
3. 在任意 C# 类中添加 Xamarin.Essentials 的引用来引用 API。
   

   using Xamarin.Essentials;

4. Xamarin.Essentials 须要在 Android 项目上添加小的附加平台特定的设置来访问特定的特性：
   在 Android 项目 MainLauncher 或者 Activity 启动 Xamarin.Essentials 必须在 OnCreate 方法中初始化：
   

   Xamarin.Essentials.Platform.Init(this, bundle);

　　　  在 Android Xamarin.Essentials 操做运行时权限必须接受任何 `OnRequestPermissionsResult`。添加下边代码到全部 Activity 类中：
　　　

public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults) { Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults); base.OnRequestPermissionsResult(requestCode, permissions, grantResults); }

就是这样！如今你能够在你的应用中开始使用 Xamarin.Essentials API 了。每一个API都有完整的文档，代码段能够复制到您的应用程序中。

更多细节请确认务必阅读咱们的完整入门向导。

建立一个指南针

在 Microsoft Build 2018 个人一个会议中，我展现了如何结合 Xamarin.Forms 和 Xamarin.Essentials API 在 10分钟内构建一个跨平台指南针。它就像在应用中添加几张指南针图片和少许用户界面同样简单：

<Grid> <Grid.RowDefinitions> <RowDefinition Height="*"/> <RowDefinition Height="Auto"/> </Grid.RowDefinitions> <Image HorizontalOptions="FillAndExpand" VerticalOptions="FillAndExpand" Source="compass.png"/> <Image HorizontalOptions="Center" VerticalOptions="Center" Source="arrow.png" x:Name="ImageArrow"/> <Label Grid.Row="1" x:Name="LabelInfo" VerticalOptions="Center" HorizontalOptions="Center" /> </Grid>

我能够在这个页面的后置代码中使用 Xamarin.Essentials 中的 Compass API 来注册一些事件，当指南针改变而且更新标签文本和图像旋转时只须要几行代码。

using Xamarin.Forms; using Xamarin.Essentials; namespace MyCompass { public partial class MainPage : ContentPage { public MainPage() { InitializeComponent(); // Register for reading changes Compass.ReadingChanged += Compass_ReadingChanged; } void Compass_ReadingChanged(CompassChangedEventArgs e) { LabelInfo.Text = $"Heading: {e.Reading.HeadingMagneticNorth}"; ImageArrow.Rotation = e.Reading.HeadingMagneticNorth; } protected override void OnAppearing() { base.OnAppearing(); Compass.Start(SensorSpeed.Ui); } protected override void OnDisappearing() { base.OnDisappearing(); Compass.Stop(); } } }

就像这样，一个指南针应用建立完了！你能够在个人 GitHub 上找到完整的源代码和图片。

下一步是什么

Xamarin.Essentials 已经通过了严格的测试，可是咱们请求你在这个尖端的预览周期内提供反馈。请在你的应用中试用这个库，你在运行中遇到的任何问题请报告到 Xamarin.Essentials 的 GitHub 仓库。

咱们将此库做为 Xamarin 平台的核心基础部分，并知道它是全部开发人员和应用程序的基础构建模块。所以，咱们将会整合 Xamarin.Essentials NuGet 包到 Visual Studio 和 Visual Studio for Mac 内置的每个 iOS，Android 和 Xamarin.Forms 模板中，因此开发人员能够从项目开始时就访问这些 API。

在线观看

你能够观看到来自 Microsoft Build 2018 我用 Visual Studio 构建移动应用和 Xamarin 会议关于 Xamarin，Xamarin.Forms 和 Xamarin.Essentials 的全面概述。

 ——这里是个 youtube 视频，反正国内看不了，就伪装有吧