Yerel kitaplık yükleme

Bu makalede, P/Invoke aracılığıyla yerel kitaplıkları yüklerken çalışma zamanının hangi yolları araydığı açıklanmaktadır. Ayrıca nasıl kullanılacağını SetDllImportResolverda gösterir.

Kitaplık adı çeşitlemeleri

Daha basit platformlar arası P/Invoke kodunu kolaylaştırmak için çalışma zamanı kurallı paylaşılan kitaplık uzantısını (.dll.soveya .dylib) yerel kitaplık adlarına ekler. Unix tabanlı platformlarda çalışma zamanı da ön bağlamayı libdener. Gibi yerel kitaplıkları yükleyen API'leri kullandığınızda bu kitaplık adları varyasyonları otomatik olarak DllImportAttributearanıyor.

Not

Kitaplık adlarındaki mutlak yollar (örneğin, /usr/lib/libc.so) olduğu gibi kabul edilir ve hiçbir varyasyon aranmayacak.

Aşağıdaki P/Invoke kullanma örneğini göz önünde bulundurun:

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

Windows üzerinde çalışırken, DLL şu sırayla aranıyor:

1. nativedep
2. nativedep.dll(kitaplık adı veya ile .dllexebitmediyse)

Linux veya macOS üzerinde çalışırken çalışma zamanı kurallı paylaşılan kitaplık uzantısını önceden bağlamayı lib ve eklemeyi dener. Bu işletim sisteminde, kitaplık adı varyasyonları aşağıdaki sırayla denenir:

1. nativedep.so / nativedep.dylib
2. libnativedep.so / libnativedep.dylib ¹
3. nativedep
4. libnativedep ¹

Linux'ta, kitaplık adı ile .so bitiyorsa veya içeriyorsa .so. arama sırası farklıdır (sonundakine .dikkat edin). Aşağıdaki örneği inceleyin:

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

Bu durumda, kitaplık adı varyasyonları aşağıdaki sırayla denenmektedir:

1. nativedep.so.6
2. libnativedep.so.6 ¹
3. nativedep.so.6.so
4. libnativedep.so.6.so ¹

¹ Yol yalnızca kitaplık adında dizin ayırıcı karakteri (/) yoksa denetlenilir.

Özel içeri aktarma çözümleyicisi

Daha karmaşık senaryolarda, SetDllImportResolver'i çalışma zamanında DLL içeri aktarmalarını çözümlemek için kullanabilirsiniz. Aşağıdaki örnekte, nativedep CPU destekliyorsa olarak çözümlenir nativedep_avx2 .

İpucu

Bu işlev yalnızca .NET Core 3.1 ve .NET 5+ ile kullanılabilir.

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

namespace PInvokeSamples
{
    public static partial class Program
    {
        [LibraryImport("nativedep")]
        private static partial 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;
        }
    }
}

Ayrıca bkz.

• Platform Çağırma (P/Invoke)