当前位置：首页 > C# > 正文

.NET MAUI平台特定代码详解（C#实现跨平台差异化功能的完整指南）

主机测评网
C#
2025-12-10
554

在使用 .NET MAUI 进行跨平台应用开发时，我们经常会遇到需要针对不同操作系统（如 Android、iOS、Windows、macOS）执行不同逻辑的情况。例如：调用平台特有的 API、适配 UI 差异、访问特定硬件功能等。这时就需要用到 .NET MAUI 平台特定代码 技术。

本文将手把手教你如何在 C# 中编写平台特定代码，即使是编程小白也能轻松掌握！我们将重点讲解两种主流方式：条件编译指令 和 运行时平台检测。

.NET MAUI平台特定代码详解（C#实现跨平台差异化功能的完整指南） NET MAUI平台特定代码 MAUI条件编译 MAUI多平台开发 C#平台差异化处理第1张

一、什么是平台特定代码？

平台特定代码指的是仅在某个目标平台（如 Android 或 iOS）上编译或执行的 C# 代码。通过这种方式，开发者可以在一个统一的项目中，为不同平台提供定制化功能，同时保持代码结构清晰。

二、方法一：使用条件编译指令（推荐）

.NET MAUI 提供了预定义的编译符号，用于标识当前构建的目标平台。你可以在 C# 代码中使用 #if、#elif、#else 和 #endif 来包裹平台专属逻辑。

// 示例：根据平台显示不同的提示信息string GetMessage(){#if ANDROID    return "您正在使用 Android 设备";#elif IOS    return "您正在使用 iOS 设备";#elif WINDOWS    return "您正在使用 Windows 系统";#elif MACCATALYST    return "您正在使用 macOS 应用";#else    return "未知平台";#endif}

上面这段代码展示了如何使用 .NET MAUI 条件编译 实现平台差异化处理。注意：这些符号是 .NET MAUI 自动定义的，无需手动配置。

三、方法二：运行时平台检测

除了编译期判断，你也可以在程序运行时动态检测当前平台。这在某些无法使用条件编译的场景（如依赖注入、动态加载）中非常有用。

using Microsoft.Maui.Devices;void HandlePlatformSpecificLogic(){    var platform = DeviceInfo.Platform;    switch (platform)    {        case DevicePlatform.Android:            // 执行 Android 专属逻辑            Console.WriteLine("Android 特定代码");            break;        case DevicePlatform.iOS:            // 执行 iOS 专属逻辑            Console.WriteLine("iOS 特定代码");            break;        case DevicePlatform.WinUI:            // 执行 Windows 专属逻辑            Console.WriteLine("Windows 特定代码");            break;        case DevicePlatform.MacCatalyst:            // 执行 macOS 专属逻辑            Console.WriteLine("macOS 特定代码");            break;        default:            Console.WriteLine("其他平台");            break;    }}

这种方法依赖于 Microsoft.Maui.Devices 命名空间中的 DeviceInfo.Platform 属性，适合在运行时做轻量级判断。

四、何时使用哪种方法？

条件编译：适用于平台间 API 完全不同、引用不同命名空间、或需要避免编译错误的场景。编译后，非目标平台的代码不会被打包进最终应用，更安全高效。
运行时检测：适用于逻辑差异较小、共享大部分代码、且所有平台都能编译通过的情况。灵活性高，但所有平台代码都会包含在最终应用中。

五、实战小例子：设置状态栏颜色

假设你想在 Android 上设置状态栏为蓝色，在 iOS 上隐藏状态栏。可以这样写：

public partial class MainPage : ContentPage{    public MainPage()    {        InitializeComponent();        ConfigureStatusBar();    }    void ConfigureStatusBar()    {#if ANDROID        var window = Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.Window;        window.SetStatusBarColor(Android.Graphics.Color.Blue);#elif IOS        UIKit.UIApplication.SharedApplication.SetStatusBarHidden(true, UIKit.UIStatusBarAnimation.Slide);#endif    }}

这个例子完美体现了 MAUI 多平台开发 的优势——一套代码，多端适配。