平台集成
.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。 有关详细信息,请参阅 调用平台代码。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈