.NET MAUI访问原生API首选Microsoft.Maui.Essentials封装库，其次用#if预处理器条件编译，中大型项目推荐Partial类+平台实现，深度集成才需直接调用JNI或Objective-C。
在 .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⚠️ 注意：这种写法会让共享代码变“重”，不利于维护，只建议用于临时调试或极简封装。
用 Partial 类 + 平台项目实现（推荐中大型项目）
这是最规范、可测试、易扩展的方式：把接口定义放在共享项目，具体实现放在各平台项目中，运行时由 MAUI 自动注入或手动解析。
- 步骤一：在共享项目定义接口，例如
INativeService.cs - 步骤二：在
Platforms/Android/下新建NativeService.android.cs，实现该接口 - 步骤三：在
MauiProgram.cs中注册服务（如services.AddSingleton）() - 步骤四：在页面或 ViewModel 中通过构造函数注入使用
好处是逻辑隔离清晰、便于单元测试、符合依赖注入原则，也方便未来替换实现（比如用 Mock 测试）。
直接调用原生 SDK（进阶：JNI / Objective-C 绑定）
极少数情况需深度集成第三方 SDK（如 Android 的某 AR 库、iOS 的 HealthKit），这时需：
- Android：通过
Java.Lang.Object子类或JniEnvironment调用 JNI 方法（需熟悉 Java 层签名） - iOS/macCatalyst：用
[Register]、[Export]标记 C# 类，或通过ObjCRuntime.Class反射调用原生类 - 更稳妥做法：为原生 SDK 封装一个独立的 .NET 绑定库（Binding Library），再引用到 MAUI 项目
⚠️ 此方式门槛高、调试难、易出崩溃，除非必要，不建议在业务层直接操作。
基本上就这些。日常开发优先走 Essentials → 条件编译 → Partial 注入路线，既安全又可控。原生调用不是越“底层”越好，而是以解决问题为先，保持共享层干净最重要。
