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

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

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

标签： android windows app 工具 ios 路由 win red elif