Library name setting automatically changed from default
If you set the GbsConfiguration setting #libraryName to its default of
the empty string, GBS attempts to load a library named
"libgcilnk.<ext>", where <ext> is the shared library name extension
for the local platform (such as 'dll' or 'so'). If that fails, it
attempts to load "libgcirpc.<ext>". This is the correct behavior.
However, if GBS succeeds in loading one of the default libraries, its
name is set as the setting of #libraryName. If the image is
subsequently saved, this can cause two problems when launching that
image in another environment:
1. GBS will only look for a library of the exact name of the library
it found previously. If only the "other" default library is now
available, library loading will erroneously fail.
2. If the image has been moved to another platform, loading may fail
due to the library name extension being wrong.
Workaround
Either:
1. Explicitly set the name of the library expected in each
environment, or
2. Set #libraryName to the empty string before saving an image which
must be portable.
Last updated: 11/9/06