平台集成

.NET 多平台应用 UI (.NET MAUI) 支持的每个平台都提供可从 C# 访问的唯一操作系统和平台 API。 .NET MAUI 提供跨平台 API 来访问此平台的大部分功能,其中包括访问传感器、访问应用正在运行的设备的相关信息、检查网络连接、安全地存储数据以及启动基于浏览器的身份验证流。

.NET MAUI 将这些跨平台 API 分为不同的功能区域。

应用程序模型

.NET MAUI 在 Microsoft.Maui.ApplicationModel 命名空间中提供以下功能:

功能 说明
应用操作 AppActions 类使你能够创建和响应应用快捷方式,从而提供启动应用的其他方法。 有关详细信息,请参阅 应用操作
应用信息 AppInfo 类提供对基本应用信息的访问权限,其中包括应用名称和版本,以及设备的当前活动主题。 有关详细信息,请参阅 应用信息
浏览者 Browser 类使应用能够在应用内浏览器或系统浏览器中打开 Web 链接。 有关详细信息,请参阅 浏览器
启动器 Launcher 类使应用能够打开 URI,并且通常在深层链接到其他应用的自定义 URI 方案时使用。 有关详细信息,请参阅 Launcher
主线程 MainThread 使你可以在 UI 线程上运行代码。 有关详细信息,请参阅 主线程
地图 Map 使应用能够将系统映射应用打开到特定位置或地标。 有关详细信息,请参阅 “地图”。
权限 Permissions 使你可以在运行时检查和请求权限。 有关详细信息,请参阅 权限
版本跟踪 VersionTracking 类使你能够检查应用的版本号和内部版本号,并确定它是否是首次启动应用。 有关详细信息,请参阅 版本跟踪

通信

.NET MAUI 在 Microsoft.Maui.ApplicationModel.Communication 命名空间中提供以下功能:

功能 说明
联系人 Contacts 类使应用能够选择联系人并阅读有关该联系人的信息。 有关详细信息,请参阅 联系人
电子邮件 Email 类可用于打开默认电子邮件应用,并且可以使用指定的收件人、主题和正文创建新电子邮件。 有关详细信息,请参阅 电子邮件
网络 通过 Connectivity 命名空间中的 Microsoft.Maui.Networking 类,可以检查应用正在运行的设备的网络可访问性。 有关详细信息,请参阅 连接
电话拨号程序 PhoneDialer 使应用能够在拨号器中打开电话号码。 有关详细信息,请参阅 电话拨号程序
短信 (消息传送) Sms 类可用于打开默认 SMS 应用,并使用收件人和邮件预加载它。 有关详细信息,请参阅 SMS
Web 验证器 通过 WebAuthenticator 命名空间中的 Microsoft.Maui.Authentication 类,可以启动基于浏览器的身份验证流,该流侦听注册到应用的特定 URL 的回调。 有关详细信息,请参阅 Web 验证器

设备功能

.NET MAUI 在 Microsoft.Maui.Devices 命名空间中提供以下功能:

功能 说明
电池 Battery 使应用能够检查设备的电池信息,并监视电池的更改。 有关详细信息,请参阅 电池
设备显示 DeviceDisplay 使应用能够读取有关设备的屏幕指标的信息。 有关详细信息,请参阅 设备显示
设备信息 DeviceInfo 类使应用能够读取有关应用正在运行的设备的信息。 有关详细信息,请参阅 设备信息
设备传感器 命名空间中的 Microsoft.Maui.Devices.Sensors 类型提供对设备的加速计、晴雨表、指南针、陀螺仪、磁力计和方向传感器的访问。 有关详细信息,请参阅 设备传感器
手电筒 FlashLight 可以打开和关闭设备的相机闪光,以模拟手电筒。 有关详细信息,请参阅 手电筒
地理编码 Geocoding 类在 Microsoft.Maui.Devices.Sensors 命名空间中提供 API,用于将位置坐标的地号地理编码为位置坐标,并将坐标反向编码为位置标记。 有关详细信息,请参阅 Geocoding
地理位置 命名空间 Geolocation 中的 Microsoft.Maui.Devices.Sensors 类提供用于检索设备的当前地理位置坐标的 API。 有关详细信息,请参阅 地理位置
触觉反馈 HapticFeedback类控件在设备上的触觉反馈,通常显示为轻柔的振动感觉,以向用户提供响应。 有关详细信息,请参阅 触觉反馈
振动 Vibration 类使你可以启动和停止振动功能,以达到所需的时间。 有关详细信息,请参阅 振动

媒体

.NET MAUI 在 Microsoft.Maui.Media 命名空间中提供以下功能:

功能 说明
媒体选取器 通过 MediaPicker 此类,你可以提示用户选取或拍摄设备上的照片或视频。 有关详细信息,请参阅 媒体选取器
屏幕快照 Screenshot 类使你能够捕获应用的当前显示屏幕。 有关详细信息,请参阅 屏幕截图
文本转语音 TextToSpeech 类使应用能够利用内置的文本转语音引擎从设备朗讲文本。 有关详细信息,请参阅 文本转语音
单元转换器 UnitConverters 类提供单元转换器,帮助你从一个度量单位转换为另一个单位。 有关详细信息,请参阅 单元转换器

共享

.NET MAUI 在 Microsoft.Maui.ApplicationModel.DataTransfer 命名空间中提供以下功能:

功能 说明
剪贴板 Clipboard 类允许应用复制文本并从系统剪贴板粘贴文本。 有关详细信息,请参阅 剪贴板
共享文件和文本 Share 类提供一个 API,用于将数据(如文本或 Web 链接)发送到设备的共享函数。 有关详细信息,请参阅 “共享”。

存储

.NET MAUI 在 Microsoft.Maui.Storage 命名空间中提供以下功能:

功能 说明
文件选取器 FilePicker 使你可以提示用户从设备中选择一个或多个文件。 有关详细信息,请参阅 文件选取器
文件系统帮助程序 FileSystem 类提供访问应用的缓存和数据文件夹的帮助程序方法,并帮助访问存储在应用包中的文件。 有关详细信息,请参阅 文件系统帮助程序
首选项 Preferences 类有助于将应用首选项存储在键/值存储中。 有关详细信息,请参阅 首选项
保护存储 此类 SecureStorage 有助于安全地存储简单的键/值对。 有关详细信息,请参阅 安全存储

访问平台 API

.NET MAUI 平台特定功能允许你使用仅在特定平台上使用的特定功能。 有关详细信息,请参阅 Android 平台特定、iOS 平台特定Windows 平台特定。

如果 .NET MAUI 不提供任何用于访问特定平台 API 的 API,可以编写自己的代码来访问所需的平台 API。 有关详细信息,请参阅 调用平台代码