Xamarin.Essentials：平台扩展

项目
07/13/2023

必须使用矩形、大小和点等平台类型时，Xamarin.Essentials 提供了几种平台扩展方法。这意味着可以针对其 iOS、Android 和 UWP 特定类型在这些类型的 System 版本之间进行转换。

入门

若要开始使用此 API，请阅读 Xamarin.Essentials 的入门指南，确保在项目中正确安装和设置库。

使用平台扩展

在类中添加对 Xamarin.Essentials 的引用：

using Xamarin.Essentials;

所有平台扩展只能从 iOS、Android 或 UWP 项目中调用。

Android 扩展

只能从 Android 项目访问这些扩展。

应用 Context 和 Activity

使用 Platform 类中的平台扩展，可以访问正在运行的应用的当前 Context 或 Activity。


var context = Platform.AppContext;

// Current Activity or null if not initialized or not started.
var activity = Platform.CurrentActivity;

如果需要 Activity，但应用尚未完全启动，应使用 WaitForActivityAsync 方法。

var activity = await Platform.WaitForActivityAsync();

活动生命周期

除了获取当前 Activity 之外，还可以注册生命周期事件。

protected override void OnCreate(Bundle bundle)
{
    base.OnCreate(bundle);

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

    Xamarin.Essentials.Platform.ActivityStateChanged += Platform_ActivityStateChanged;
}

protected override void OnDestroy()
{
    base.OnDestroy();
    Xamarin.Essentials.Platform.ActivityStateChanged -= Platform_ActivityStateChanged;
}

void Platform_ActivityStateChanged(object sender, Xamarin.Essentials.ActivityStateChangedEventArgs e) =>
    Toast.MakeText(this, e.State.ToString(), ToastLength.Short).Show();

Activity 状态如下所示：

创建时间
Resumed
已暂停
已破坏
SaveInstanceState
已开始
已停止

有关详细信息，请参阅 Activity 生命周期文档。

iOS 扩展

只能从 iOS 项目访问这些扩展。

当前 UIViewController

获取对当前可见 UIViewController 的访问权限：

var vc = Platform.GetCurrentUIViewController();

如果无法检测 UIViewController，此方法返回 null。

跨平台扩展

这些扩展存在于每个平台中。

点

var system = new System.Drawing.Point(x, y);

// Convert to CoreGraphics.CGPoint, Android.Graphics.Point, and Windows.Foundation.Point
var platform = system.ToPlatformPoint();

// Back to System.Drawing.Point
var system2 = platform.ToSystemPoint();

大小

var system = new System.Drawing.Size(width, height);

// Convert to CoreGraphics.CGSize, Android.Util.Size, and Windows.Foundation.Size
var platform = system.ToPlatformSize();

// Back to System.Drawing.Size
var system2 = platform.ToSystemSize();

矩形

var system = new System.Drawing.Rectangle(x, y, width, height);

// Convert to CoreGraphics.CGRect, Android.Graphics.Rect, and Windows.Foundation.Rect
var platform = system.ToPlatformRectangle();

// Back to System.Drawing.Rectangle
var system2 = platform.ToSystemRectangle();

通过