From b0c8aa8fec5178599b405b65ea1ee3a1d38ec9b4 Mon Sep 17 00:00:00 2001 From: Simon McVittie <smcv@collabora.com> Date: Fri, 22 Nov 2024 15:17:09 +0000 Subject: [PATCH] slr-for-game-developers: Expand on why SONAMEs are the name to use Signed-off-by: Simon McVittie <smcv@collabora.com> --- docs/slr-for-game-developers.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/slr-for-game-developers.md b/docs/slr-for-game-developers.md index c27c992d0..f5a8bc52c 100644 --- a/docs/slr-for-game-developers.md +++ b/docs/slr-for-game-developers.md @@ -1251,9 +1251,13 @@ so it should not be necessary to build your own version of SDL. If you load a library dynamically, make sure to use its versioned SONAME, such as `libvulkan.so.1` or `libgtk-3.so.0`, as the name to search for. -Don't use the development symlink such as `libvulkan.so` or `libgtk-3.so`, -and also don't use the fully-versioned name such as `libvulkan.so.1.2.189` -or `libgtk-3.so.0.2404.26`. +Avoid using the development symlink such as `libvulkan.so` or `libgtk-3.so`, +which will not be available in the Steam Linux Runtime container, +and does not guarantee ABI compatibility even if it works. +Also avoid using the fully-versioned name such as `libvulkan.so.1.2.189` +or `libgtk-3.so.0.2404.26`, +because that name will no longer work if the library is upgraded to a +newer compatible version. Use the versions of libraries that are included in the Steam Runtime, if possible. -- GitLab