Support a single shared libvips binary on Linux/macOS (#83)

Author: kleisauke

CHANGELOG.md

@@ -3,6 +3,10 @@ All notable changes to NetVips will be documented in this file. See [here](CHANG
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.3] - ???
+### Added
+- Add support for a single shared libvips binary on Linux and macOS ([#83](https://github.com/kleisauke/net-vips/issues/83)).
+
 ## [1.2.2] - 2020-06-16
 ### Fixed
 - Fix the buffer-based fallback mechanism for `NewFromStream` / `NewFromSource` on Windows 32-bit.
@@ -134,6 +138,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 ### Added
 - First release!
 
+[1.2.3]: https://github.com/kleisauke/net-vips/compare/v1.2.2...v1.2.3
 [1.2.2]: https://github.com/kleisauke/net-vips/compare/v1.2.1...v1.2.2
 [1.2.1]: https://github.com/kleisauke/net-vips/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/kleisauke/net-vips/compare/v1.1.0...v1.2.0

appveyor.yml

@@ -1,7 +1,7 @@
 image: Visual Studio 2019
 
 # Version format
-version: 1.2.2.{build}
+version: 1.2.3.{build}
 
 init:
   - git config --global core.autocrlf true

build/test-mono.sh

@@ -16,8 +16,8 @@ DLL_FILE="$SCRIPT_DIR/tests/NetVips.Tests/bin/Release/net472/NetVips.Tests.dll"
 if [ "$(uname)" == "Darwin" ]; then
     RID="osx-x64"
 
-    # Prefer Homebrew's glib to avoid compatibility issues 
-    # with the one provided by mono.
+    # Prefer Homebrew's glib to avoid compatibility issues
+    # with the one provided by Mono.
     export DYLD_LIBRARY_PATH=$(brew --prefix glib)/lib
 elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
     RID="linux-x64"

src/NetVips/Interop/Libraries.Linux.cs

@@ -2,8 +2,14 @@ namespace NetVips.Interop
 {
     internal static partial class Libraries
     {
-        internal const string GLib = "libgobject-2.0.so.0";
-        internal const string GObject = "libgobject-2.0.so.0";
-        internal const string Vips = "libvips.so.42";
+        // We can safely define all these variables as `libvips.so.42` since
+        // DLLImport uses dlsym() on Linux. This function also searches for named
+        // symbols in the dependencies of the shared library. Therefore, we can
+        // provide libvips as a single shared library with all dependencies
+        // statically linked without breaking compatibility with shared builds
+        // (i.e. what is usually installed via package managers).
+        internal const string GLib = "libvips.so.42",
+                              GObject = "libvips.so.42",
+                              Vips = "libvips.so.42";
     }
 }

src/NetVips/Interop/Libraries.OSX.cs

@@ -2,8 +2,14 @@ namespace NetVips.Interop
 {
     internal static partial class Libraries
     {
-        internal const string GLib = "libgobject-2.0.dylib";
-        internal const string GObject = "libgobject-2.0.dylib";
-        internal const string Vips = "libvips.42.dylib";
+        // We can safely define all these variables as `libvips.42.dylib` since
+        // DLLImport uses dlsym() on macOS. This function also searches for named
+        // symbols in the dependencies of the shared library. Therefore, we can
+        // provide libvips as a single shared library with all dependencies
+        // statically linked without breaking compatibility with shared builds
+        // (i.e. what is usually installed via package managers).
+        internal const string GLib = "libvips.42.dylib",
+                              GObject = "libvips.42.dylib",
+                              Vips = "libvips.42.dylib";
     }
 }

src/NetVips/Interop/Libraries.Windows.cs

@@ -2,8 +2,11 @@ namespace NetVips.Interop
 {
     internal static partial class Libraries
     {
-        internal const string GLib = "libglib-2.0-0.dll";
-        internal const string GObject = "libgobject-2.0-0.dll";
-        internal const string Vips = "libvips-42.dll";
+        // We cannot define all these variables as `libvips-42.dll` without
+        // breaking compatibility with the shared Windows build. Therefore,
+        // we always ship at least 3 DLLs.
+        internal const string GLib = "libglib-2.0-0.dll",
+                              GObject = "libgobject-2.0-0.dll",
+                              Vips = "libvips-42.dll";
     }
 }