MAUI怎么访问平台原生API MAUI原生功能调用指南

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()）
• 页面或 ViewModel 中通过构造函数注入，调用时完全不用关心平台细节

用条件编译指令快速适配小差异

适合初始化配置、日志输出、开关控制等轻量级分支逻辑，不适合复杂原生交互。

• 利用内置符号：#if ANDROID、#elif IOS、#elif WINDOWS
• 代码写在共享项目里，编译期就剔除非目标平台代码，体积干净
• 不能用于跨平台 UI 组件内部直接调用原生对象（比如在 XAML 后台写 UIApplication.SharedApplication...），会编译失败
• 配合 DeviceInfo.Platform 运行时判断，可做兜底或调试分支

别漏掉关键收尾动作

很多调用失败不是逻辑错，而是环境没配齐。

• Android 需检查 AndroidManifest.xml 是否声明了对应权限（如相机、位置）
• iOS 需在 Info.plist 添加使用说明字段（如 NSCameraUsageDescription）
• 混淆工具（IL Trimmer）可能删掉未显式引用的平台实现，加 false 到对应 .csproj
• 确保平台项目已正确引用共享项目，且目标框架一致（如都为 net8.0-android）

基本上就这些。不复杂但容易忽略。