Csomagok ellenőrzése különböző futtatókörnyezeteken

A NuGet-csomag különböző futtatókörnyezeteihez különböző implementációs szerelvényeket választhat. Ebben az esetben meg kell győződnie arról, hogy ezek a szerelvények kompatibilisek egymással és a fordítási idő szerelvényekkel.

Vegyük például a következő forgatókönyvet: Olyan kódtáron dolgozik, amely a Unix és a Windows API-k egyes interop-hívásait foglalja magában. A következő kódot írta:

#if Unix
    public static void Open(string path, bool securityDescriptor)
    {
        // Call Unix specific stuff.
    }
#else
    public static void Open(string path)
    {
        // Call Windows specific stuff.
    }
#endif

Az eredményként kapott csomagstruktúra a következőképpen néz ki.

lib/net6.0/A.dll
runtimes/unix/lib/net6.0/A.dll

lib\net6.0\A.dll a rendszer mindig fordításkor használja, függetlenül a mögöttes operációs rendszertől. lib\net6.0\A.dll nem Unix-rendszerek esetén is használható futásidőben. runtimes\unix\lib\net6.0\A.dll A Unix-rendszerek esetében azonban futásidőben használatos.

Amikor megpróbálja becsomagolni ezt a projektet, a következő hibaüzenet jelenik meg:

D:\demo>dotnet pack
Microsoft (R) Build Engine version 17.0.0-preview-21460-01+8f208e609 for .NET
Copyright (C) Microsoft Corporation. All rights reserved.

  Determining projects to restore...
  All projects are up-to-date for restore.
  You are using a preview version of .NET. See: https://aka.ms/dotnet-core-preview
  PackageValidationThrough -> D:\demo\bin\Debug\net6.0\PackageValidationThrough.dll
  Successfully created package 'D:\demo\bin\Debug\PackageValidationThrough.1.0.0.nupkg'.
C:\Program Files\dotnet\sdk\6.0.100-rc.1.21463.6\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Compatibility.Common.targets(32,5): error CP0002: Member 'A.B.Open(string)' exists on lib/net6.0/PackageValidationThrough.dll but not on runtimes/unix/lib/net6.0/PackageValidationThrough.dll [D:\demo\PackageValidationThrough.csproj]
C:\Program Files\dotnet\sdk\6.0.100-rc.1.21463.6\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Compatibility.Common.targets(32,5): error CP0002: Member 'A.B.Open(string, bool)' exists on runtimes/unix/lib/net6.0/PackageValidationThrough.dll but not on lib/net6.0/PackageValidationThrough.dll [D:\demo\PackageValidationThrough.csproj]

Felismeri a hibát, és hozzáadja A.B.Open(string) a Unix-futtatókörnyezetet is.

#if Unix
    public static void Open(string path, bool securityDescriptor)
    {
        // Call Unix specific stuff.
    }

    public static void Open(string path)
    {
        throw new PlatformNotSupportedException();
    }
#else
    public static void Open(string path)
    {
        // Call Windows specific stuff.
    }

    public static void Open(string path, bool securityDescriptor)
    {
        throw new PlatformNotSupportedException();
    }
#endif

Próbálja meg újra becsomagolni a projektet, és sikeres lesz.

Szigorú mód

Ennek az érvényesítőnek a szigorú módját a projektfájlban lévő tulajdonság beállításávalEnableStrictModeForCompatibleTfmsengedélyezheti. A szigorú mód engedélyezése módosít néhány szabályt, és néhány más szabályt is végrehajt a rendszer a különbségek lekérésekor. Ez akkor hasznos, ha azt szeretné, hogy az összehasonlítandó mindkét oldal szigorúan azonos legyen a felületükön és az identitásukon. További információ: Szigorú mód.