Načítání nativní knihovny

  • Článek

Tento článek vysvětluje, které cesty modul runtime hledá při načítání nativních knihoven prostřednictvím volání nespravovaného kódu. Také ukazuje, jak používat SetDllImportResolver.

Varianty názvů knihoven

Pro usnadnění jednoduššího kódu P/Invoke pro různé platformy modul runtime přidá do názvů nativních knihoven kanonické rozšíření sdílené knihovny (.dll.sonebo.dylib). Na platformách se systémem Unix bude modul runtime také zkoušet předpending lib. Tyto varianty názvů knihoven se automaticky prohledávají při použití rozhraní API, která načítají nativní knihovny, například DllImportAttribute.

Poznámka:

Absolutní cesty v názvech knihoven (například /usr/lib/libc.so) se považují za neschybné a nebudou prohledány žádné varianty.

Představte si následující příklad použití volání nespravovaného kódu:

[DllImport("nativedep")]
static extern int ExportedFunction();

Při spuštění ve Windows se knihovna DLL vyhledá v následujícím pořadí:

  1. nativedep
  2. nativedep.dll (pokud název knihovny ještě .dll nekončí nebo .exe)

Při spuštění v Linuxu nebo macOS se modul runtime pokusí o předpending lib a připojení kanonického rozšíření sdílené knihovny. V těchto operačních systémech se varianty názvů knihoven zkouší v následujícím pořadí:

  1. nativedep.so / nativedep.dylib
  2. libnativedep.so / libnativedep.dylib1
  3. nativedep
  4. libnativedep1

V Linuxu se pořadí hledání liší, pokud název knihovny končí .so nebo obsahuje .so. (všimněte si koncového .). Představte si následující příklad:

[DllImport("nativedep.so.6")]
static extern int ExportedFunction();

V tomto případě se varianty názvů knihoven zkouší v následujícím pořadí:

  1. nativedep.so.6
  2. libnativedep.so.61
  3. nativedep.so.6.so
  4. libnativedep.so.6.so1

1 Cesta je zaškrtnutá pouze v případě, že název knihovny neobsahuje znak oddělovače adresáře (/).

Překladač vlastních importů

Ve složitějších scénářích můžete použít SetDllImportResolver k překladu importů knihoven DLL za běhu. V následujícím příkladu se přeloží nativedep_avx2 na to, nativedep jestli ho procesor podporuje.

Tip

Tato funkce je dostupná pouze v .NET Core 3.1 a .NET 5+.

using System;
using System.Reflection;
using System.Runtime.InteropServices;

namespace PInvokeSamples
{
    public static class Program
    {
        [DllImport("nativedep")]
        private static extern int ExportedFunction();

        public static void Main(string[] args)
        {
            // Register the import resolver before calling the imported function.
            // Only one import resolver can be set for a given assembly.
            NativeLibrary.SetDllImportResolver(Assembly.GetExecutingAssembly(), DllImportResolver);

            int value = ExportedFunction();
            Console.WriteLine(value);
        }

        private static IntPtr DllImportResolver(string libraryName, Assembly assembly, DllImportSearchPath? searchPath)
        {
            if (libraryName == "nativedep")
            {
                // On systems with AVX2 support, load a different library.
                if (System.Runtime.Intrinsics.X86.Avx2.IsSupported)
                {
                    return NativeLibrary.Load("nativedep_avx2", assembly, searchPath);
                }
            }

            // Otherwise, fallback to default import resolver.
            return IntPtr.Zero;
        }
    }
}

Viz také