MAUI怎么访问平台原生API .NET MAUI平台特定代码调用方法

admin 百科 2025-12-22 14

.NET MAUI访问原生API首选Microsoft.Maui.Essentials封装库，其次用#if预处理器条件编译，中大型项目推荐Partial类+平台实现，深度集成才需直接调用JNI或Objective-C。

MAUI怎么访问平台原生API .NET MAUI平台特定代码调用方法-第1张图片-佛山资讯网

在 .NET MAUI 中访问平台原生 API，核心是通过 平台特定代码（Platform-Specific Code） 实现，而不是直接写 Java/Kotlin、Swift/Objective-C 或 C# 跨平台通用逻辑。MAUI 提供了两种主流方式：一种是使用内置的 Microsoft.Maui.Controls.Device.Platform 和 Microsoft.Maui.Essentials 封装好的能力；另一种是在共享项目中用 #if 预处理器指令或 Partial 类 + 平台实现来调用底层原生 API。

用 Essentials 调用常用原生功能（推荐优先）

Microsoft.Maui.Essentials 是官方推荐的轻量级跨平台 API 封装库，覆盖大部分高频原生能力，比如地理位置、传感器、剪贴板、通知、电池、网络状态等。它内部已自动处理各平台差异，你只需写一次 C# 代码。

安装 NuGet 包：Microsoft.Maui.Essentials（.NET 6+ 已默认包含，无需额外安装）
使用前加命名空间：using Microsoft.Maui.Essentials;
示例：获取当前定位

try
{
    var location = await Geolocation.GetLastKnownLocationAsync();
    if (location != null)
        Console.WriteLine($"纬度: {location.Latitude}, 经度: {location.Longitude}");
}
catch (FeatureNotSupportedException)
{
    // 设备不支持定位
}
catch (PermissionException)
{
    // 未授权定位权限（需手动申请）
}

登录后复制

注意：部分功能（如定位、相机）需要在各平台配置权限声明（AndroidManifest.xml、Info.plist、Entitlements.plist）并请求运行时权限。

用 #if 预处理器做条件编译（适合简单场景）

当 Essentials 不满足需求，又不想引入复杂架构时，可直接在共享项目中用 #if __ANDROID__、#if __IOS__、#if __MACCATALYST__、#if WINDOWS 等预处理器指令写平台专属逻辑。

确保项目文件中已启用对应符号（新建 MAUI 项目默认已启用）
示例：在 Android 上调用 Toast（仅演示，实际建议用 MainThread.InvokeOnMainThreadAsync + Toast.Make）

#if __ANDROID__
    Android.Widget.Toast.MakeText(Platform.CurrentActivity, "Hello from Android!", Android.Widget.ToastLength.Short).Show();
#elif __IOS__
    UIKit.UIApplication.SharedApplication.KeyWindow.RootViewController.PresentViewController(
        new UIKit.UIAlertController("提示", "Hello from iOS!", UIKit.UIAlertControllerStyle.Alert), true, null);
#endif

登录后复制

⚠️ 注意：这种写法会让共享代码变“重”，不利于维护，只建议用于临时调试或极简封装。