MAUI调用原生API需通过桥接机制，推荐分部类（轻量简单）、依赖服务（解耦复用）和条件编译（小差异适配）三种方式，并注意权限配置、清单声明及混淆保护。
MAUI 本身不直接暴露原生 API，必须通过明确的桥接机制才能安全、可靠地调用。核心不是“能不能”，而是“怎么组织 + 怎么绑定”。只要结构对、注册对、调用对，Android 的 Vibrator、iOS 的 HealthKit、Windows 的 WinRT 都能稳稳接入。
用 partial class 分部实现是最轻量、最推荐的方式
适合功能边界清晰、逻辑较简单、不需频繁复用的原生调用（比如获取设备型号、控制状态栏）。
- 在共享项目中定义分部类和分部方法，只声明，不实现
- 在
Platforms/Android或Platforms/iOS目录下新建同名分部类文件，补全具体实现 - 编译时 MAUI 自动合并，运行时自动路由到对应平台版本
- 注意：两个分部类必须在同一命名空间、同名、且都标记
public partial class
用依赖服务（DependencyService）解耦更灵活
适合需要注入、测试、或多个地方复用的原生能力（比如统一的振动服务、通知权限管理）。
- 先定义接口（如
IDeviceVibrator），放在共享项目里 - 各平台项目中实现该接口，并用
[Dependency]特性标记 - 在
MauiProgram.cs中注册服务（如AddSingleton<IDeviceVibrator>()） - 页面或 ViewModel 中通过构造函数注入，调用时完全不用关心平台细节
用条件编译指令快速适配小差异
适合初始化配置、日志输出、开关控制等轻量级分支逻辑，不适合复杂原生交互。
- 利用内置符号：
#if ANDROID、#elif IOS、#elif WINDOWS - 代码写在共享项目里，编译期就剔除非目标平台代码，体积干净
- 不能用于跨平台 UI 组件内部直接调用原生对象（比如在 XAML 后台写
UIApplication.SharedApplication...），会编译失败 - 配合
DeviceInfo.Platform运行时判断，可做兜底或调试分支
别漏掉关键收尾动作
很多调用失败不是逻辑错，而是环境没配齐。
- Android 需检查
AndroidManifest.xml是否声明了对应权限（如相机、位置） - iOS 需在
Info.plist添加使用说明字段（如NSCameraUsageDescription） - 混淆工具（IL Trimmer）可能删掉未显式引用的平台实现，加
<IsTrimmable>false</IsTrimmable>到对应 .csproj - 确保平台项目已正确引用共享项目，且目标框架一致（如都为 net8.0-android）
基本上就这些。不复杂但容易忽略。
