Kernel - NKS0041

Use KernelPlatform.IsOnMacOs()

This analyzer provides the following strings:

Context
String

Error List

Caller uses RuntimeInformation.IsOSPlatform(OSPlatform.OSX) instead of KernelPlatform.IsOnMacOS()

Suggestion Box

Use KernelPlatform.IsOnMacOS() instead of RuntimeInformation.IsOSPlatform(OSPlatform.OSX)

Description

KernelPlatform.IsOnMacOS() is more readable and less verbose than RuntimeInformation.IsOSPlatform(OSPlatform.OSX).

Extended Description

This code analyzer detects the usage of IsOSPlatform from the RuntimeInformation class found in the System.Runtime.InteropServices namespace.

RuntimeInformation.IsOSPlatform is a modern way of determining the current operating system that Nitrocid is running on. However, this isn't live detection.

As a result, KernelPlatform implements a handful of platform detection functions to allow you to more accurately detect your platform. Also, it simplifies the complicated platform checking statements to its simpler equivalent.

Analysis Comparison

To get a brief insight about how this analyzer works, compare the two code blocks shown to you below:

Before the fix

Somewhere in your mod code...
public static void MyFunction()
{
    string value = RuntimeInformation.IsOSPlatform(OSPlatform.OSX);
}

After the fix

Somewhere in your mod code...
public static void MyFunction()
{
    string value = KernelPlatform.IsOnMacOS();
}

Suppression

You can suppress this suggestion by including it in the appropriate place, whichever is convenient.

For more information about how to suppress any warning issued by the Nitrocid analyzer, visit the below page:

Recommendation

We recommend that every caller which use this function use the recommended abovementioned method.

Last updated