在.NET MAUI中确保Android平台特定代码仅在支持版本执行并消除CA1416警告

你已经通过partial class DeviceServices实现了Android平台的系统控件隐藏/显示功能，目标API级别33.0、最低21.0，也加了#if ANDROID30_0_OR_GREATER编译指令和Build.VERSION.SdkInt运行时版本判断，但还是收到CA1416警告，不想抑制警告又担心早期版本兼容，这里给你几个可行的解决办法：

方法1：用[SupportedOSPlatform]特性标记高版本API调用 #

CA1416警告是代码分析工具在检查API兼容性时触发的，单纯的编译指令和运行时判断可能没被分析工具完全识别。你可以把高版本API的调用封装到单独方法中，并用[SupportedOSPlatform("android30.0")]特性标记，明确告知分析工具这段代码仅支持Android 30.0及以上版本：

修改后的代码示例：

static partial class DeviceServices
{
    private static Activity _activity;

    public static void SetActivity(Activity activity)
    {
        _activity = activity;
    }

    [SupportedOSPlatform("android30.0")]
    private static void HideSystemControlsForR()
    {
        _activity?.Window?.InsetsController?.Hide(WindowInsets.Type.SystemBars());
    }

    public static partial void HideSystemControls()
    {
        if (Build.VERSION.SdkInt >= BuildVersionCodes.R)
        {
            HideSystemControlsForR();
        }
    }

    [SupportedOSPlatform("android30.0")]
    private static void ShowSystemControlsForR()
    {
        _activity?.Window?.InsetsController?.Show(WindowInsets.Type.SystemBars());
    }

    public static partial void ShowSystemControls()
    {
        if (Build.VERSION.SdkInt >= BuildVersionCodes.R)
        {
            ShowSystemControlsForR();
        }
    }
}

这种封装方式既能让代码分析工具识别到高版本API的支持范围，消除警告，又能通过运行时版本判断保证早期Android版本不会执行到不兼容的代码，测试和运行逻辑不受影响。

方法2：内联方法加特性简化写法 #

如果不想额外封装方法，也可以在运行时判断内部定义内联方法并添加特性，同样能让分析工具识别版本限制：

public static partial void HideSystemControls()
{
    if (Build.VERSION.SdkInt >= BuildVersionCodes.R)
    {
        [SupportedOSPlatform("android30.0")]
        void Impl() => _activity?.Window?.InsetsController?.Hide(WindowInsets.Type.SystemBars());
        Impl();
    }
}

public static partial void ShowSystemControls()
{
    if (Build.VERSION.SdkInt >= BuildVersionCodes.R)
    {
        [SupportedOSPlatform("android30.0")]
        void Impl() => _activity?.Window?.InsetsController?.Show(WindowInsets.Type.SystemBars());
        Impl();
    }
}

原理说明 #

CA1416警告的核心是代码分析工具无法通过#if指令或简单的运行时判断自动关联API的最低支持版本，而[SupportedOSPlatform]是.NET为跨平台API兼容性提供的官方标记，能精准告知分析工具代码的版本支持范围，既不影响运行时逻辑，又能消除不必要的警告。

内容的提问来源于stack exchange，提问作者Julian